To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

Policy Exemption Requests

Exemption requests let you automatically submit review requests for keywords and ads that trigger policy violations .

Some examples when you can use this feature:

Your ad contains some punctuation that's generally considered unconventional, but that follows standards within your industry.
A keyword in your ad group contains medical terms, but you, or your users, believe your usage of the term adheres to Google Ads policies and warrants further review.

When you send a request to mutate (create or update) objects that have policy violations, the API will throw GoogleAdsError containing ErrorDetails back to you.

For policy violation-related errors, the ErrorDetails class includes details regarding those errors in the policy_violation_details or policy_finding_details field, based on which object type you're trying to mutate:

	Ads	Keywords
Policy violation information stored in:	`policy_finding_details` (an instance of `PolicyFindingDetails` )	`policy_violation_details` (an instance of `PolicyViolationDetails` )
GoogleAdsError.error_code value is an instance of:	`PolicyFindingError`	`PolicyViolationError`

Therefore, the steps for sending an exemption request will be different based on the types of objects and the error details that are returned:

Ads
Keywords

Code examples

Examples for handling policy violations:

Handle ad policy violations
Handle keyword policy violations

Handle ad policy violations

Java

 // Copyright 2020 Google LLC 
 // 
 // Licensed under the Apache License, Version 2.0 (the "License"); 
 // you may not use this file except in compliance with the License. 
 // You may obtain a copy of the License at 
 // 
 //     https://www.apache.org/licenses/LICENSE-2.0 
 // 
 // Unless required by applicable law or agreed to in writing, software 
 // distributed under the License is distributed on an "AS IS" BASIS, 
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 // See the License for the specific language governing permissions and 
 // limitations under the License. 
 package 
  
 com.google.ads.googleads.examples.errorhandling 
 ; 
 import static 
  
 com.google.ads.googleads.examples.utils.CodeSampleHelper.getShortPrintableDateTime 
 ; 
 import 
  
 com.beust.jcommander.Parameter 
 ; 
 import 
  
 com.google.ads.googleads.examples.utils.ArgumentNames 
 ; 
 import 
  
 com.google.ads.googleads.examples.utils.CodeSampleParams 
 ; 
 import 
  
 com.google.ads.googleads.lib.GoogleAdsClient 
 ; 
 import 
  
 com.google.ads.googleads.v21.common.AdTextAsset 
 ; 
 import 
  
 com.google.ads.googleads.v21.common.PolicyTopicEntry 
 ; 
 import 
  
 com.google.ads.googleads.v21.enums.AdGroupAdStatusEnum.AdGroupAdStatus 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.ErrorCode.ErrorCodeCase 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.GoogleAdsError 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.GoogleAdsException 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.PolicyFindingDetails 
 ; 
 import 
  
 com.google.ads.googleads.v21.resources.AdGroupAd 
 ; 
 import 
  
 com.google.ads.googleads.v21.services.AdGroupAdOperation 
 ; 
 import 
  
 com.google.ads.googleads.v21.services.AdGroupAdServiceClient 
 ; 
 import 
  
 com.google.ads.googleads.v21.services.MutateAdGroupAdsResponse 
 ; 
 import 
  
 com.google.ads.googleads.v21.utils.ResourceNames 
 ; 
 import 
  
 com.google.common.collect.ImmutableList 
 ; 
 import 
  
 java.io.FileNotFoundException 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.util.ArrayList 
 ; 
 import 
  
 java.util.List 
 ; 
 /** 
 * Demonstrates how to request an exemption for policy violations of a responsive search ad. If the 
 * request somehow fails with exceptions that are not policy finding errors, the example will stop 
 * instead of trying sending an exemption request. 
 */ 
 public 
  
 class 
 HandleResponsiveSearchAdPolicyViolations 
  
 { 
  
 private 
  
 static 
  
 class 
 HandleResponsiveSearchAdPolicyViolationsParams 
  
 extends 
  
 CodeSampleParams 
  
 { 
  
 @Parameter 
 ( 
 names 
  
 = 
  
 ArgumentNames 
 . 
 CUSTOMER_ID 
 , 
  
 required 
  
 = 
  
 true 
 ) 
  
 private 
  
 Long 
  
 customerId 
 ; 
  
 @Parameter 
 ( 
 names 
  
 = 
  
 ArgumentNames 
 . 
 AD_GROUP_ID 
 , 
  
 required 
  
 = 
  
 true 
 ) 
  
 private 
  
 Long 
  
 adGroupId 
 ; 
  
 } 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 { 
  
 HandleResponsiveSearchAdPolicyViolationsParams 
  
 params 
  
 = 
  
 new 
  
 HandleResponsiveSearchAdPolicyViolationsParams 
 (); 
  
 if 
  
 ( 
 ! 
 params 
 . 
 parseArguments 
 ( 
 args 
 )) 
  
 { 
  
 // Either pass the required parameters for this example on the command line, or insert them 
  
 // into the code here. See the parameter class definition above for descriptions. 
  
 params 
 . 
 customerId 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_CUSTOMER_ID" 
 ); 
  
 params 
 . 
 adGroupId 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_AD_GROUP_ID" 
 ); 
  
 } 
  
 GoogleAdsClient 
  
 googleAdsClient 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 googleAdsClient 
  
 = 
  
 GoogleAdsClient 
 . 
 newBuilder 
 (). 
 fromPropertiesFile 
 (). 
 build 
 (); 
  
 } 
  
 catch 
  
 ( 
 FileNotFoundException 
  
 fnfe 
 ) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
  
 "Failed to load GoogleAdsClient configuration from file. Exception: %s%n" 
 , 
  
 fnfe 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ioe 
 ) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
 "Failed to create GoogleAdsClient. Exception: %s%n" 
 , 
  
 ioe 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 try 
  
 { 
  
 new 
  
 HandleResponsiveSearchAdPolicyViolations 
 () 
  
 . 
 runExample 
 ( 
 googleAdsClient 
 , 
  
 params 
 . 
 customerId 
 , 
  
 params 
 . 
 adGroupId 
 ); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 gae 
 ) 
  
 { 
  
 // GoogleAdsException is the base class for most exceptions thrown by an API request. 
  
 // Instances of this exception have a message and a GoogleAdsFailure that contains a 
  
 // collection of GoogleAdsErrors that indicate the underlying causes of the 
  
 // GoogleAdsException. 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
  
 "Request ID %s failed due to GoogleAdsException. Underlying errors:%n" 
 , 
  
 gae 
 . 
 getRequestId 
 ()); 
  
 int 
  
 i 
  
 = 
  
 0 
 ; 
  
 for 
  
 ( 
 GoogleAdsError 
  
 googleAdsError 
  
 : 
  
 gae 
 . 
 getGoogleAdsFailure 
 (). 
 getErrorsList 
 ()) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
 "  Error %d: %s%n" 
 , 
  
 i 
 ++ 
 , 
  
 googleAdsError 
 ); 
  
 } 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 } 
  
 /** 
 * Runs the example. 
 * 
 * @param googleAdsClient the client to use. 
 * @param customerId the customer ID. 
 * @param adGroupId the ad group ID. 
 */ 
  
 public 
  
 void 
  
 runExample 
 ( 
 GoogleAdsClient 
  
 googleAdsClient 
 , 
  
 long 
  
 customerId 
 , 
  
 long 
  
 adGroupId 
 ) 
  
 { 
  
 // Creates an ad group ad for the specified ad group. 
  
 AdGroupAd 
 . 
 Builder 
  
 adGroupAdBuilder 
  
 = 
  
 AdGroupAd 
 . 
 newBuilder 
 () 
  
 . 
 setAdGroup 
 ( 
 ResourceNames 
 . 
 adGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 )) 
  
 . 
 setStatus 
 ( 
 AdGroupAdStatus 
 . 
 PAUSED 
 ); 
  
 adGroupAdBuilder 
  
 . 
 getAdBuilder 
 () 
  
 // Sets the final URLS. 
  
 . 
 addFinalUrls 
 ( 
 "https://www.example.com" 
 ) 
  
 // Adds a responsive search ad. 
  
 . 
 getResponsiveSearchAdBuilder 
 () 
  
 . 
 addAllHeadlines 
 ( 
  
 ImmutableList 
 . 
 of 
 ( 
  
 AdTextAsset 
 . 
 newBuilder 
 () 
  
 . 
 setText 
 ( 
 "Cruise to Mars #" 
  
 + 
  
 getShortPrintableDateTime 
 ()) 
  
 . 
 build 
 (), 
  
 AdTextAsset 
 . 
 newBuilder 
 (). 
 setText 
 ( 
 "Best Space Cruise Line" 
 ). 
 build 
 (), 
  
 AdTextAsset 
 . 
 newBuilder 
 (). 
 setText 
 ( 
 "Experience the Stars" 
 ). 
 build 
 ())) 
  
 . 
 addAllDescriptions 
 ( 
  
 ImmutableList 
 . 
 of 
 ( 
  
 // Intentionally uses an ad text that violates policy - too many exclamation marks. 
  
 AdTextAsset 
 . 
 newBuilder 
 (). 
 setText 
 ( 
 "Buy your tickets now!!!!!!!" 
 ). 
 build 
 (), 
  
 AdTextAsset 
 . 
 newBuilder 
 (). 
 setText 
 ( 
 "Visit the Red Planet" 
 ). 
 build 
 ())); 
  
 // Constructs an operation to send to the API. 
  
 AdGroupAdOperation 
  
 operation 
  
 = 
  
 AdGroupAdOperation 
 . 
 newBuilder 
 (). 
 setCreate 
 ( 
 adGroupAdBuilder 
 . 
 build 
 ()). 
 build 
 (); 
  
 // Connects to the API. Note that we could use try-with-resources, however doing so would 
  
 // require that we either (1) need to reconnect to the API for requesting the exemption, or (2) 
  
 // introduce a doubly nested try-catch structure here. 
  
 AdGroupAdServiceClient 
  
 client 
  
 = 
  
 googleAdsClient 
 . 
 getLatestVersion 
 (). 
 createAdGroupAdServiceClient 
 (); 
  
 try 
  
 { 
  
 // Sends the request which we expect to fail with policy violations. 
  
 client 
 . 
 mutateAdGroupAds 
 ( 
 String 
 . 
 valueOf 
 ( 
 customerId 
 ), 
  
 ImmutableList 
 . 
 of 
 ( 
 operation 
 )); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 ex 
 ) 
  
 { 
  
 // Retrieves the ignorable policy topics. 
  
 List<String> 
  
 ignorablePolicyTopics 
  
 = 
  
 fetchIgnorablePolicyTopics 
 ( 
 ex 
 ); 
  
 // Requests an exemption to add the creative with the known violations. 
  
 requestExemption 
 ( 
 ignorablePolicyTopics 
 , 
  
 client 
 , 
  
 operation 
 , 
  
 customerId 
 ); 
  
 } 
  
 finally 
  
 { 
  
 // Disconnects the API connection. Very important! 
  
 client 
 . 
 close 
 (); 
  
 } 
  
 } 
  
 /** 
 * Collects all ignorable policy topics that will be sent for exemption request later. 
 * 
 * @param gae the Google Ads exception. 
 * @return the ignorable policy topics. 
 */ 
  
 private 
  
 List<String> 
  
 fetchIgnorablePolicyTopics 
 ( 
 GoogleAdsException 
  
 gae 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "Google Ads failure details:" 
 ); 
  
 // Creates a list to store the result. 
  
 List<String> 
  
 ignorableTopics 
  
 = 
  
 new 
  
 ArrayList 
<> (); 
  
 // Searches all errors for ignorable policy topics. 
  
 for 
  
 ( 
 GoogleAdsError 
  
 error 
  
 : 
  
 gae 
 . 
 getGoogleAdsFailure 
 (). 
 getErrorsList 
 ()) 
  
 { 
  
 // Supports sending exemption request for the policy finding error only. 
  
 if 
  
 ( 
 error 
 . 
 getErrorCode 
 (). 
 getErrorCodeCase 
 () 
  
 != 
  
 ErrorCodeCase 
 . 
 POLICY_FINDING_ERROR 
 ) 
  
 { 
  
 throw 
  
 gae 
 ; 
  
 } 
  
 // Shows some information about the error encountered. 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t%s: %s%n" 
 , 
  
 error 
 . 
 getErrorCode 
 (). 
 getErrorCodeCase 
 (), 
  
 error 
 . 
 getMessage 
 ()); 
  
 // Checks policy finding details for ignorable policy topics. 
  
 if 
  
 ( 
 error 
 . 
 getDetails 
 () 
  
 != 
  
 null 
 ) 
  
 { 
  
 PolicyFindingDetails 
  
 policyFindingDetails 
  
 = 
  
 error 
 . 
 getDetails 
 (). 
 getPolicyFindingDetails 
 (); 
  
 if 
  
 ( 
 policyFindingDetails 
  
 != 
  
 null 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "\tPolicy finding details:" 
 ); 
  
 // Shows all the policy topics for the current error. 
  
 for 
  
 ( 
 PolicyTopicEntry 
  
 policyTopicEntry 
  
 : 
  
 policyFindingDetails 
 . 
 getPolicyTopicEntriesList 
 ()) 
  
 { 
  
 // Adds this topic to the result. 
  
 ignorableTopics 
 . 
 add 
 ( 
 policyTopicEntry 
 . 
 getTopic 
 ()); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t\tPolicy topic name: '%s'%n" 
 , 
  
 policyTopicEntry 
 . 
 getTopic 
 ()); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t\tPolicy topic entry type: '%s'%n" 
 , 
  
 policyTopicEntry 
 . 
 getType 
 ()); 
  
 // For the sake of brevity, we exclude printing "policy topic evidences" and 
  
 // "policy topic constraints" here. You can fetch those data by calling: 
  
 // - policyTopicEntry.getEvidences() 
  
 // - policyTopicEntry.getConstraints() 
  
 } 
  
 } 
  
 } 
  
 } 
  
 return 
  
 ignorableTopics 
 ; 
  
 } 
  
 /** 
 * Sends exemption requests for creating a responsive search ad. 
 * 
 * @param ignorablePolicyTopics topics to request exemption for. 
 * @param client client to use for API access. 
 * @param operation operation which generated original violations. 
 * @param customerID the customer ID to operate on. 
 */ 
  
 private 
  
 void 
  
 requestExemption 
 ( 
  
 List<String> 
  
 ignorablePolicyTopics 
 , 
  
 AdGroupAdServiceClient 
  
 client 
 , 
  
 AdGroupAdOperation 
  
 operation 
 , 
  
 long 
  
 customerID 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
  
 "Trying to add a responsive search ad again by requesting exemption for its policy" 
  
 + 
  
 " violations." 
 ); 
  
 // Converts the operation back to a builder. 
  
 AdGroupAdOperation 
 . 
 Builder 
  
 operationBuilder 
  
 = 
  
 operation 
 . 
 toBuilder 
 (); 
  
 // Adds the exemption request. 
  
 operationBuilder 
  
 . 
 getPolicyValidationParameterBuilder 
 () 
  
 . 
 addAllIgnorablePolicyTopics 
 ( 
 ignorablePolicyTopics 
 ); 
  
 // Sends the request back to the API. 
  
 MutateAdGroupAdsResponse 
  
 response 
  
 = 
  
 client 
 . 
 mutateAdGroupAds 
 ( 
  
 String 
 . 
 valueOf 
 ( 
 customerID 
 ), 
  
 ImmutableList 
 . 
 of 
 ( 
 operationBuilder 
 . 
 build 
 ())); 
  
 // Shows the newly added ad resource name. 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Successfully added a responsive search ad with resource name '%s' by requesting a policy" 
  
 + 
  
 " violation exemption.%n" 
 , 
  
 response 
 . 
 getResults 
 ( 
 0 
 ). 
 getResourceName 
 ()); 
  
 } 
 } 
   HandleResponsiveSearchAdPolicyViolations 
 . 
 java

C#

 // Copyright 2020 Google LLC 
 // 
 // Licensed under the Apache License, Version 2.0 (the "License"); 
 // you may not use this file except in compliance with the License. 
 // You may obtain a copy of the License at 
 // 
 //     http://www.apache.org/licenses/LICENSE-2.0 
 // 
 // Unless required by applicable law or agreed to in writing, software 
 // distributed under the License is distributed on an "AS IS" BASIS, 
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 // See the License for the specific language governing permissions and 
 // limitations under the License. 
 using 
  
 CommandLine 
 ; 
 using 
  
 Google.Ads.Gax.Examples 
 ; 
 using 
  
 Google.Ads.GoogleAds.Lib 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Common 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Errors 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Resources 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Services 
 ; 
 using 
  
 System 
 ; 
 using 
  
 System.Collections.Generic 
 ; 
 using 
  
 static 
  
 Google 
 . 
 Ads 
 . 
 GoogleAds 
 . 
 V21 
 . 
 Enums 
 . 
 AdGroupAdStatusEnum 
 . 
 Types 
 ; 
 namespace 
  
 Google.Ads.GoogleAds.Examples.V21 
 { 
  
 /// <summary> 
  
 /// This code example demonstrates how to request an exemption for policy violations of a 
  
 /// responsive search ad. If the request somehow fails with exceptions that are not policy finding 
  
 /// errors, the code example will stop instead of trying to send an exemption request. 
  
 /// </summary> 
  
 public 
  
 class 
  
 HandleResponsiveSearchAdPolicyViolations 
  
 : 
  
 ExampleBase 
  
 { 
  
 /// <summary> 
  
 /// Command line options for running the <see cref="HandleResponsiveSearchAdPolicyViolations"/> 
  
 /// example. 
  
 /// </summary> 
  
 public 
  
 class 
  
 Options 
  
 : 
  
 OptionsBase 
  
 { 
  
 /// <summary> 
  
 /// The customer ID for which the call is made. 
  
 /// </summary> 
  
 [Option("customerId", Required = true, HelpText = 
 "The customer ID for which the call is made.")] 
  
 public 
  
 long 
  
 CustomerId 
  
 { 
  
 get 
 ; 
  
 set 
 ; 
  
 } 
  
 /// <summary> 
  
 /// ID of the ad group to which ads are added. 
  
 /// </summary> 
  
 [Option("adGroupId", Required = true, HelpText = 
 "ID of the ad group to which ads are added.")] 
  
 public 
  
 long 
  
 AdGroupId 
  
 { 
  
 get 
 ; 
  
 set 
 ; 
  
 } 
  
 } 
  
 /// <summary> 
  
 /// Main method, to run this code example as a standalone application. 
  
 /// </summary> 
  
 /// <param name="args">The command line arguments.</param> 
  
 public 
  
 static 
  
 void 
  
 Main 
 ( 
 string 
 [] 
  
 args 
 ) 
  
 { 
  
 Options 
  
 options 
  
 = 
  
 ExampleUtilities 
 . 
 ParseCommandLine<Options> 
 ( 
 args 
 ); 
  
 HandleResponsiveSearchAdPolicyViolations 
  
 codeExample 
  
 = 
  
 new 
  
 HandleResponsiveSearchAdPolicyViolations 
 (); 
  
 Console 
 . 
 WriteLine 
 ( 
 codeExample 
 . 
 Description 
 ); 
  
 codeExample 
 . 
 Run 
 ( 
 new 
  
 GoogleAdsClient 
 (), 
  
 options 
 . 
 CustomerId 
 , 
  
 options 
 . 
 AdGroupId 
 ); 
  
 } 
  
 /// <summary> 
  
 /// Returns a description about the code example. 
  
 /// </summary> 
  
 public 
  
 override 
  
 string 
  
 Description 
  
 = 
>  
 "This code example demonstrates how to request an exemption for policy violations of " 
  
 + 
  
 "a responsive search ad. If the request somehow fails with exceptions that are not " 
  
 + 
  
 "policy finding  errors, the code example will stop instead of trying to send an " 
  
 + 
  
 "exemption request." 
 ; 
  
 /// <summary> 
  
 /// Runs the code example. 
  
 /// </summary> 
  
 /// <param name="client">The Google Ads client.</param> 
  
 /// <param name="customerId">The customer ID for which the call is made.</param> 
  
 /// <param name="adGroupId">ID of the ad group to which ads are added.</param> 
  
 public 
  
 void 
  
 Run 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 long 
  
 adGroupId 
 ) 
  
 { 
  
 // Get the AdGroupAdServiceClient. 
  
 AdGroupAdServiceClient 
  
 adGroupAdService 
  
 = 
  
 client 
 . 
 GetService 
 ( 
  
 Services 
 . 
 V21 
 . 
 AdGroupAdService 
 ); 
  
 string 
  
 adGroupResourceName 
  
 = 
  
 ResourceNames 
 . 
 AdGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 ); 
  
 ResponsiveSearchAdInfo 
  
 responsiveSearchAdInfo 
  
 = 
  
 new 
  
 ResponsiveSearchAdInfo 
 () 
  
 { 
  
 Headlines 
  
 = 
  
 { 
  
 new 
  
 AdTextAsset 
 () 
  
 { 
  
 Text 
  
 = 
  
 $"Cruise to Mars #{ExampleUtilities.GetShortRandomString()}" 
  
 }, 
  
 new 
  
 AdTextAsset 
 () 
  
 { 
  
 Text 
  
 = 
  
 "Best Space Cruise Line" 
  
 }, 
  
 new 
  
 AdTextAsset 
 () 
  
 { 
  
 Text 
  
 = 
  
 "Experience the Stars" 
  
 } 
  
 }, 
  
 Descriptions 
  
 = 
  
 { 
  
 // Intentionally use an ad text that violates policy -- having too many exclamation 
  
 // marks. 
  
 new 
  
 AdTextAsset 
 () 
  
 { 
  
 Text 
  
 = 
  
 "Buy your tickets now!!!!!!!" 
  
 }, 
  
 new 
  
 AdTextAsset 
 () 
  
 { 
  
 Text 
  
 = 
  
 "Visit the Red Planet" 
  
 } 
  
 } 
  
 }; 
  
 // Creates an ad group ad to hold the above ad. 
  
 AdGroupAd 
  
 adGroupAd 
  
 = 
  
 new 
  
 AdGroupAd 
 () 
  
 { 
  
 AdGroup 
  
 = 
  
 adGroupResourceName 
 , 
  
 // Set the ad group ad to PAUSED to prevent it from immediately serving. 
  
 // Set to ENABLED once you've added targeting and the ad are ready to serve. 
  
 Status 
  
 = 
  
 AdGroupAdStatus 
 . 
 Paused 
 , 
  
 // Sets the responsive search ad info on an Ad. 
  
 Ad 
  
 = 
  
 new 
  
 Ad 
 () 
  
 { 
  
 ResponsiveSearchAd 
  
 = 
  
 responsiveSearchAdInfo 
 , 
  
 FinalUrls 
  
 = 
  
 { 
  
 "https://www.example.com" 
  
 } 
  
 } 
  
 }; 
  
 // Creates an ad group ad operation. 
  
 AdGroupAdOperation 
  
 operation 
  
 = 
  
 new 
  
 AdGroupAdOperation 
 () 
  
 { 
  
 Create 
  
 = 
  
 adGroupAd 
  
 }; 
  
 try 
  
 { 
  
 try 
  
 { 
  
 // Try sending a mutate request to add the ad group ad. 
  
 adGroupAdService 
 . 
 MutateAdGroupAds 
 ( 
 customerId 
 . 
 ToString 
 (), 
  
 new 
 [] 
  
 { 
  
 operation 
  
 }); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 ex 
 ) 
  
 { 
  
 // The request will always fail because of the policy violation in the 
  
 // description of the ad. 
  
 var 
  
 ignorablePolicyTopics 
  
 = 
  
 FetchIgnorablePolicyTopics 
 ( 
 ex 
 ); 
  
 // Try sending exemption requests for creating a responsive search ad. 
  
 RequestExemption 
 ( 
 customerId 
 , 
  
 adGroupAdService 
 , 
  
 operation 
 , 
  
 ignorablePolicyTopics 
 ); 
  
 } 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 e 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "Failure:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Message: {e.Message}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Failure: {e.Failure}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Request ID: {e.RequestId}" 
 ); 
  
 throw 
 ; 
  
 } 
  
 } 
  
 /// <summary> 
  
 /// Collects all ignorable policy topics that will be sent for exemption request later. 
  
 /// </summary> 
  
 /// <param name="ex">The API exception from a previous call to add ad group ads.</param> 
  
 /// <returns>The ignorable policy topics</returns> 
  
 private 
  
 static 
  
 string 
 [] 
  
 FetchIgnorablePolicyTopics 
 ( 
 GoogleAdsException 
  
 ex 
 ) 
  
 { 
  
 List<string> 
  
 ignorablePolicyTopics 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 "Google Ads failure details:" 
 ); 
  
 foreach 
  
 ( 
 GoogleAdsError 
  
 error 
  
 in 
  
 ex 
 . 
 Failure 
 . 
 Errors 
 ) 
  
 { 
  
 if 
  
 ( 
 error 
 . 
 ErrorCode 
 . 
 ErrorCodeCase 
  
 != 
  
 ErrorCode 
 . 
 ErrorCodeOneofCase 
 . 
 PolicyFindingError 
 ) 
  
 { 
  
 throw 
  
 ex 
 ; 
  
 } 
  
 if 
  
 ( 
 error 
 . 
 Details 
  
 != 
  
 null 
 && 
 error 
 . 
 Details 
 . 
 PolicyFindingDetails 
  
 != 
  
 null 
 ) 
  
 { 
  
 PolicyFindingDetails 
  
 details 
  
 = 
  
 error 
 . 
 Details 
 . 
 PolicyFindingDetails 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 $"- Policy finding details:" 
 ); 
  
 foreach 
  
 ( 
 PolicyTopicEntry 
  
 entry 
  
 in 
  
 details 
 . 
 PolicyTopicEntries 
 ) 
  
 { 
  
 ignorablePolicyTopics 
 . 
 Add 
 ( 
 entry 
 . 
 Topic 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"  - Policy topic name: '{entry.Topic}'" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"  - Policy topic entry type: '{entry.Type}'" 
 ); 
  
 // For the sake of brevity, we exclude printing "policy topic evidences" 
  
 // and "policy topic constraints" here. You can fetch those data by 
  
 // calling: 
  
 // - entry.Evidences 
  
 // - entry.Constraints 
  
 } 
  
 } 
  
 } 
  
 return 
  
 ignorablePolicyTopics 
 . 
 ToArray 
 (); 
  
 } 
  
 /// <summary> 
  
 /// Sends exemption requests for creating a responsive search ad. 
  
 /// </summary> 
  
 /// <param name="customerId">The customer ID for which the call is made.</param> 
  
 /// <param name="service">The ad group ad service.</param> 
  
 /// <param name="operation">The ad group ad operation to request exemption for.</param> 
  
 /// <param name="ignorablePolicyTopics">The ignorable policy topics.</param> 
  
 private 
  
 static 
  
 void 
  
 RequestExemption 
 ( 
 long 
  
 customerId 
 , 
  
 AdGroupAdServiceClient 
  
 service 
 , 
  
 AdGroupAdOperation 
  
 operation 
 , 
  
 string 
 [] 
  
 ignorablePolicyTopics 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "Try adding a responsive search ad again by requesting exemption for " 
  
 + 
  
 "its policy violations." 
 ); 
  
 PolicyValidationParameter 
  
 validationParameter 
  
 = 
  
 new 
  
 PolicyValidationParameter 
 (); 
  
 validationParameter 
 . 
 IgnorablePolicyTopics 
 . 
 AddRange 
 ( 
 ignorablePolicyTopics 
 ); 
  
 operation 
 . 
 PolicyValidationParameter 
  
 = 
  
 validationParameter 
 ; 
  
 MutateAdGroupAdsResponse 
  
 response 
  
 = 
  
 service 
 . 
 MutateAdGroupAds 
 ( 
  
 customerId 
 . 
 ToString 
 (), 
  
 new 
 [] 
  
 { 
  
 operation 
  
 }); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Successfully added a responsive search ad with resource name " 
  
 + 
  
 $"'{response.Results[0].ResourceName}' by requesting for policy violation " 
  
 + 
  
 $"exemption." 
 ); 
  
 } 
  
 } 
 } 
   HandleResponsiveSearchAdPolicyViolations 
 . 
 cs

PHP

< ?php 
 /** 
 * Copyright 2019 Google LLC 
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); 
 * you may not use this file except in compliance with the License. 
 * You may obtain a copy of the License at 
 * 
 *     https://www.apache.org/licenses/LICENSE-2.0 
 * 
 * Unless required by applicable law or agreed to in writing, software 
 * distributed under the License is distributed on an "AS IS" BASIS, 
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 * See the License for the specific language governing permissions and 
 * limitations under the License. 
 */ 
 namespace Google\Ads\GoogleAds\Examples\ErrorHandling; 
 require __DIR__ . '/../../vendor/autoload.php'; 
 use GetOpt\GetOpt; 
 use Google\Ads\GoogleAds\Examples\Utils\ArgumentNames; 
 use Google\Ads\GoogleAds\Examples\Utils\ArgumentParser; 
 use Google\Ads\GoogleAds\Examples\Utils\Helper; 
 use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder; 
 use Google\Ads\GoogleAds\Lib\V21\GoogleAdsClient; 
 use Google\Ads\GoogleAds\Lib\V21\GoogleAdsClientBuilder; 
 use Google\Ads\GoogleAds\Lib\V21\GoogleAdsException; 
 use Google\Ads\GoogleAds\Util\V21\ResourceNames; 
 use Google\Ads\GoogleAds\V21\Common\AdTextAsset; 
 use Google\Ads\GoogleAds\V21\Common\PolicyTopicEntry; 
 use Google\Ads\GoogleAds\V21\Common\PolicyValidationParameter; 
 use Google\Ads\GoogleAds\V21\Common\ResponsiveSearchAdInfo; 
 use Google\Ads\GoogleAds\V21\Enums\AdGroupAdStatusEnum\AdGroupAdStatus; 
 use Google\Ads\GoogleAds\V21\Enums\PolicyTopicEntryTypeEnum\PolicyTopicEntryType; 
 use Google\Ads\GoogleAds\V21\Errors\GoogleAdsError; 
 use Google\Ads\GoogleAds\V21\Resources\Ad; 
 use Google\Ads\GoogleAds\V21\Resources\AdGroupAd; 
 use Google\Ads\GoogleAds\V21\Services\AdGroupAdOperation; 
 use Google\Ads\GoogleAds\V21\Services\Client\AdGroupAdServiceClient; 
 use Google\Ads\GoogleAds\V21\Services\MutateAdGroupAdsRequest; 
 use Google\ApiCore\ApiException; 
 /** 
 * This example demonstrates how to request an exemption for policy violations of a responsive 
 * search ad. If the request somehow fails with exceptions that are not policy finding errors, the 
 * example will stop instead of trying sending an exemption request. 
 */ 
 class HandleResponsiveSearchAdPolicyViolations 
 { 
 private const CUSTOMER_ID = 'INSERT_CUSTOMER_ID_HERE'; 
 private const AD_GROUP_ID = 'INSERT_AD_GROUP_ID_HERE'; 
 public static function main() 
 { 
 // Either pass the required parameters for this example on the command line, or insert them 
 // into the constants above. 
 $options = (new ArgumentParser())->parseCommandArguments([ 
 ArgumentNames::CUSTOMER_ID => GetOpt::REQUIRED_ARGUMENT, 
 ArgumentNames::AD_GROUP_ID => GetOpt::REQUIRED_ARGUMENT 
 ]); 
 // Generate a refreshable OAuth2 credential for authentication. 
 $oAuth2Credential = (new OAuth2TokenBuilder())->fromFile()->build(); 
 // Construct a Google Ads client configured from a properties file and the 
 // OAuth2 credentials above. 
 $googleAdsClient = (new GoogleAdsClientBuilder())->fromFile() 
 ->withOAuth2Credential($oAuth2Credential) 
 ->build(); 
 try { 
 self::runExample( 
 $googleAdsClient, 
 $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID, 
 $options[ArgumentNames::AD_GROUP_ID] ?: self::AD_GROUP_ID 
 ); 
 } catch (GoogleAdsException $googleAdsException) { 
 printf( 
 "Request with ID '%s' has failed.%sGoogle Ads failure details:%s", 
 $googleAdsException->getRequestId(), 
 PHP_EOL, 
 PHP_EOL 
 ); 
 foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { 
 /** @var GoogleAdsError $error */ 
 printf( 
 "\t%s: %s%s", 
 $error->getErrorCode()->getErrorCode(), 
 $error->getMessage(), 
 PHP_EOL 
 ); 
 } 
 exit(1); 
 } catch (ApiException $apiException) { 
 printf( 
 "ApiException was thrown with message '%s'.%s", 
 $apiException->getMessage(), 
 PHP_EOL 
 ); 
 exit(1); 
 } 
 } 
 /** 
 * Runs the example. 
 * 
 * @param GoogleAdsClient $googleAdsClient the Google Ads API client 
 * @param int $customerId the customer ID 
 * @param int $adGroupId the ad group ID to add a responsive search ad to 
 */ 
 public static function runExample( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId, 
 int $adGroupId 
 ) { 
 // Creates a responsive search ad info object. 
 $responsiveSearchAdInfo = new ResponsiveSearchAdInfo([ 
 'headlines' => [ 
 new AdTextAsset([ 
 'text' => 'Cruise to Mars #' . Helper::getShortPrintableDatetime() 
 ]), 
 new AdTextAsset(['text' => 'Best Space Cruise Line']), 
 new AdTextAsset(['text' => 'Experience the Stars']) 
 ], 
 // Intentionally use an ad text that violates policy -- having too many exclamation 
 // marks. 
 'descriptions' => [ 
 new AdTextAsset(['text' => 'Buy your tickets now!!!!!!!']), 
 new AdTextAsset(['text' => 'Visit the Red Planet']) 
 ] 
 ]); 
 // Creates an ad group ad to hold the above ad. 
 $adGroupAd = new AdGroupAd([ 
 'ad_group' => ResourceNames::forAdGroup($customerId, $adGroupId), 
 // Set the ad group ad to PAUSED to prevent it from immediately serving. 
 // Set to ENABLED once you've added targeting and the ad are ready to serve. 
 'status' => AdGroupAdStatus::PAUSED, 
 // Sets the responsive search ad info on an Ad. 
 'ad' => new Ad([ 
 'responsive_search_ad' => $responsiveSearchAdInfo, 
 'final_urls' => ['https://www.example.com'] 
 ]) 
 ]); 
 // Creates an ad group ad operation. 
 $adGroupAdOperation = new AdGroupAdOperation(); 
 $adGroupAdOperation->setCreate($adGroupAd); 
 $adGroupAdServiceClient = $googleAdsClient->getAdGroupAdServiceClient(); 
 $ignorablePolicyTopics = []; 
 try { 
 // Try sending a mutate request to add the ad group ad. 
 $adGroupAdServiceClient->mutateAdGroupAds( 
 MutateAdGroupAdsRequest::build($customerId, [$adGroupAdOperation]) 
 ); 
 } catch (GoogleAdsException $googleAdsException) { 
 // The request will always fail because of the policy violation in the description of 
 // the ad. 
 $ignorablePolicyTopics = self::fetchIgnorablePolicyTopics($googleAdsException); 
 } 
 // Try sending exemption requests for creating a responsive search ad. 
 self::requestExemption( 
 $customerId, 
 $adGroupAdServiceClient, 
 $adGroupAdOperation, 
 $ignorablePolicyTopics 
 ); 
 } 
 /** 
 * Collects all ignorable policy topics that will be sent for exemption request later. 
 * 
 * @param GoogleAdsException $googleAdsException the Google Ads exception 
 * @return string[] the ignorable policy topics 
 */ 
 private static function fetchIgnorablePolicyTopics(GoogleAdsException $googleAdsException) 
 { 
 $ignorablePolicyTopics = []; 
 printf("Google Ads failure details:%s", PHP_EOL); 
 foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { 
 /** @var GoogleAdsError $error */ 
 if ($error->getErrorCode()->getErrorCode() !== 'policy_finding_error') { 
 // This example supports sending exemption request for the policy finding error 
 // only. 
 throw $googleAdsException; 
 } 
 printf( 
 "\t%s: %s%s", 
 $error->getErrorCode()->getErrorCode(), 
 $error->getMessage(), 
 PHP_EOL 
 ); 
 if ( 
 !is_null($error->getDetails()) 
 && !is_null($error->getDetails()->getPolicyFindingDetails()) 
 ) { 
 $policyFindingDetails = $error->getDetails()->getPolicyFindingDetails(); 
 printf("\tPolicy finding details:%s", PHP_EOL); 
 foreach ($policyFindingDetails->getPolicyTopicEntries() as $policyTopicEntry) { 
 /** @var PolicyTopicEntry $policyTopicEntry */ 
 $ignorablePolicyTopics[] = $policyTopicEntry->getTopic(); 
 printf( 
 "\t\tPolicy topic name: '%s'%s", 
 $policyTopicEntry->getTopic(), 
 PHP_EOL 
 ); 
 printf( 
 "\t\tPolicy topic entry type: '%s'%s", 
 PolicyTopicEntryType::name($policyTopicEntry->getType()), 
 PHP_EOL 
 ); 
 // For the sake of brevity, we exclude printing "policy topic evidences" and 
 // "policy topic constraints" here. You can fetch those data by calling: 
 // - $policyTopicEntry->getEvidences() 
 // - $policyTopicEntry->getConstraints() 
 } 
 } 
 } 
 return $ignorablePolicyTopics; 
 } 
 /** 
 * Sends exemption requests for creating a responsive search ad. 
 * 
 * @param int $customerId 
 * @param AdGroupAdServiceClient $adGroupAdServiceClient 
 * @param AdGroupAdOperation $adGroupAdOperation 
 * @param string[] $ignorablePolicyTopics 
 */ 
 private static function requestExemption( 
 int $customerId, 
 AdGroupAdServiceClient $adGroupAdServiceClient, 
 AdGroupAdOperation $adGroupAdOperation, 
 array $ignorablePolicyTopics 
 ) { 
 print "Try adding a responsive search ad again by requesting exemption for its policy" 
 . " violations." . PHP_EOL; 
 $adGroupAdOperation->setPolicyValidationParameter( 
 new PolicyValidationParameter(['ignorable_policy_topics' => $ignorablePolicyTopics]) 
 ); 
 $response = $adGroupAdServiceClient->mutateAdGroupAds(MutateAdGroupAdsRequest::build( 
 $customerId, 
 [$adGroupAdOperation] 
 )); 
 printf( 
 "Successfully added a responsive search ad with resource name '%s' by requesting" 
 . " for policy violation exemption.%s", 
 $response->getResults()[0]->getResourceName(), 
 PHP_EOL 
 ); 
 } 
 } 
 HandleResponsiveSearchAdPolicyViolations::main(); 
   HandleResponsiveSearchAdPolicyViolations.php

Python

 #!/usr/bin/env python 
 # Copyright 2020 Google LLC 
 # 
 # Licensed under the Apache License, Version 2.0 (the "License"); 
 # you may not use this file except in compliance with the License. 
 # You may obtain a copy of the License at 
 # 
 #     https://www.apache.org/licenses/LICENSE-2.0 
 # 
 # Unless required by applicable law or agreed to in writing, software 
 # distributed under the License is distributed on an "AS IS" BASIS, 
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 # See the License for the specific language governing permissions and 
 # limitations under the License. 
 """Requests an exemption for policy violations of a responsive search ad. 
 If the request somehow fails with exceptions that are not policy finding 
 errors, the example will stop instead of trying sending an exemption request. 
 """ 
 import 
  
 argparse 
 import 
  
 sys 
 import 
  
 uuid 
 from 
  
 typing 
  
 import 
 List 
 from 
  
 google.ads.googleads.client 
  
 import 
 GoogleAdsClient 
 from 
  
 google.ads.googleads.errors 
  
 import 
 GoogleAdsException 
 from 
  
 google.ads.googleads.v19.services.services.ad_group_ad_service 
  
 import 
 ( 
 AdGroupAdServiceClient 
 , 
 ) 
 from 
  
 google.ads.googleads.v19.services.services.ad_group_service 
  
 import 
 ( 
 AdGroupServiceClient 
 , 
 ) 
 from 
  
 google.ads.googleads.v19.services.types.ad_group_ad_service 
  
 import 
 ( 
 AdGroupAdOperation 
 , 
 MutateAdGroupAdsResponse 
 , 
 ) 
 from 
  
 google.ads.googleads.v19.resources.types.ad_group_ad 
  
 import 
 AdGroupAd 
 from 
  
 google.ads.googleads.v19.common.types.ad_type_infos 
  
 import 
 ( 
 ResponsiveSearchAdInfo 
 , 
 ) 
 from 
  
 google.ads.googleads.v19.common.types.ad_asset 
  
 import 
 ( 
 AdTextAsset 
 , 
 ) 
 from 
  
 google.ads.googleads.v19.errors.types.policy_finding_error 
  
 import 
 ( 
 PolicyFindingErrorEnum 
 , 
 ) 
 def 
  
 main 
 ( 
 client 
 : 
 GoogleAdsClient 
 , 
 customer_id 
 : 
 str 
 , 
 ad_group_id 
 : 
 str 
 ) 
 - 
> None 
 : 
  
 """Handles responsive search ad policy violations. 
 Args: 
 client: The Google Ads client. 
 customer_id: The customer ID for which to add the responsive search ad. 
 ad_group_id: The ad group ID to which to add a responsive search ad. 
 """ 
 ad_group_ad_service_client 
 : 
 AdGroupAdServiceClient 
 = 
 client 
 . 
 get_service 
 ( 
 "AdGroupAdService" 
 ) 
 ad_group_ad_operation 
 : 
 AdGroupAdOperation 
 = 
 create_responsive_search_ad 
 ( 
 client 
 , 
 ad_group_ad_service_client 
 , 
 customer_id 
 , 
 ad_group_id 
 ) 
 ignorable_policy_topics 
 : 
 List 
 [ 
 str 
 ] 
 = 
 [] 
 try 
 : 
 # Try sending a mutate request to add the ad group ad. 
 ad_group_ad_service_client 
 . 
 mutate_ad_group_ads 
 ( 
 customer_id 
 = 
 customer_id 
 , 
 operations 
 = 
 [ 
 ad_group_ad_operation 
 ] 
 ) 
 except 
 GoogleAdsException 
 as 
 googleads_exception 
 : 
 # The request will always fail due to the policy violation in the 
 # ad's description. 
 ignorable_policy_topics 
 = 
 fetch_ignorable_policy_topics 
 ( 
 client 
 , 
 googleads_exception 
 ) 
 request_exemption 
 ( 
 customer_id 
 , 
 ad_group_ad_service_client 
 , 
 ad_group_ad_operation 
 , 
 ignorable_policy_topics 
 , 
 ) 
 def 
  
 create_responsive_search_ad 
 ( 
 client 
 : 
 GoogleAdsClient 
 , 
 ad_group_ad_service_client 
 : 
 AdGroupAdServiceClient 
 , 
 customer_id 
 : 
 str 
 , 
 ad_group_id 
 : 
 str 
 , 
 ) 
 - 
> AdGroupAdOperation 
 : 
  
 """Create a responsive search ad that includes a policy violation. 
 Args: 
 client: The GoogleAds client instance. 
 ad_group_ad_service_client: The AdGroupAdService client instance. 
 customer_id: The customer ID for which to add the responsive search ad. 
 ad_group_id: The ad group ID to which to add a responsive search ad. 
 Returns: 
 The attempted AdGroupAdOperation instance. 
 """ 
 ad_group_service 
 : 
 AdGroupServiceClient 
 = 
 client 
 . 
 get_service 
 ( 
 "AdGroupService" 
 ) 
 ad_group_resource_name 
 : 
 str 
 = 
 ad_group_service 
 . 
 ad_group_path 
 ( 
 customer_id 
 , 
 ad_group_id 
 ) 
 # Creates an operation and ad group ad to create and hold the above ad. 
 ad_group_ad_operation 
 : 
 AdGroupAdOperation 
 = 
 client 
 . 
 get_type 
 ( 
 "AdGroupAdOperation" 
 ) 
 ad_group_ad 
 : 
 AdGroupAd 
 = 
 ad_group_ad_operation 
 . 
 create 
 ad_group_ad 
 . 
 ad_group 
 = 
 ad_group_resource_name 
 # Set the ad group ad to PAUSED to prevent it from immediately serving. 
 # Set to ENABLED once you've added targeting and the ad are ready to serve. 
 ad_group_ad 
 . 
 status 
 = 
 client 
 . 
 enums 
 . 
 AdGroupAdStatusEnum 
 . 
 PAUSED 
 # Sets the responsive search ad info on an ad. 
 responsive_search_ad_info 
 : 
 ResponsiveSearchAdInfo 
 = 
 ( 
 ad_group_ad 
 . 
 ad 
 . 
 responsive_search_ad 
 ) 
 headline_1 
 : 
 AdTextAsset 
 = 
 client 
 . 
 get_type 
 ( 
 "AdTextAsset" 
 ) 
 headline_1 
 . 
 text 
 = 
 f 
 "Cruise to Mars # 
 { 
 str 
 ( 
 uuid 
 . 
 uuid4 
 ())[ 
 0 
 : 
 13 
 ] 
 } 
 " 
 headline_2 
 : 
 AdTextAsset 
 = 
 client 
 . 
 get_type 
 ( 
 "AdTextAsset" 
 ) 
 headline_2 
 . 
 text 
 = 
 "Best Space Cruise Line" 
 headline_3 
 : 
 AdTextAsset 
 = 
 client 
 . 
 get_type 
 ( 
 "AdTextAsset" 
 ) 
 headline_3 
 . 
 text 
 = 
 "Experience the Stars" 
 responsive_search_ad_info 
 . 
 headlines 
 . 
 extend 
 ( 
 [ 
 headline_1 
 , 
 headline_2 
 , 
 headline_3 
 ] 
 ) 
 # Intentionally use an ad text that violates policy by having too many 
 # exclamation marks. 
 description_1 
 : 
 AdTextAsset 
 = 
 client 
 . 
 get_type 
 ( 
 "AdTextAsset" 
 ) 
 description_1 
 . 
 text 
 = 
 "Buy your tickets now!!!!!!!" 
 description_2 
 : 
 AdTextAsset 
 = 
 client 
 . 
 get_type 
 ( 
 "AdTextAsset" 
 ) 
 description_2 
 . 
 text 
 = 
 "Visit the Red Planet" 
 responsive_search_ad_info 
 . 
 descriptions 
 . 
 extend 
 ( 
 [ 
 description_1 
 , 
 description_2 
 ] 
 ) 
 ad_group_ad 
 . 
 ad 
 . 
 final_urls 
 . 
 append 
 ( 
 "https://www.example.com" 
 ) 
 return 
 ad_group_ad_operation 
 def 
  
 fetch_ignorable_policy_topics 
 ( 
 client 
 : 
 GoogleAdsClient 
 , 
 googleads_exception 
 : 
 GoogleAdsException 
 ) 
 - 
> List 
 [ 
 str 
 ]: 
  
 """Collects all ignorable policy topics to be sent for exemption request. 
 Args: 
 client: The GoogleAds client instance. 
 googleads_exception: The exception that contains the policy 
 violation(s). 
 Returns: 
 A list of ignorable policy topics. 
 """ 
 ignorable_policy_topics 
 : 
 List 
 [ 
 str 
 ] 
 = 
 [] 
 print 
 ( 
 "Google Ads failure details:" 
 ) 
 for 
 error 
 in 
 googleads_exception 
 . 
 failure 
 . 
 errors 
 : 
 if 
 ( 
 error 
 . 
 error_code 
 . 
 policy_finding_error 
 != 
 client 
 . 
 enums 
 . 
 PolicyFindingErrorEnum 
 . 
 POLICY_FINDING 
 ): 
 print 
 ( 
 "This example supports sending exemption request for the " 
 "policy finding error only." 
 ) 
 raise 
 googleads_exception 
 print 
 ( 
 f 
 " 
 \t 
 { 
 error 
 . 
 error_code 
 . 
 policy_finding_error 
 } 
 : 
 { 
 error 
 . 
 message 
 } 
 " 
 ) 
 if 
 ( 
 error 
 . 
 details 
 is 
 not 
 None 
 and 
 error 
 . 
 details 
 . 
 policy_finding_details 
 is 
 not 
 None 
 ): 
 policy_finding_details 
 : 
 PolicyFindingErrorEnum 
 = 
 ( 
 error 
 . 
 details 
 . 
 policy_finding_details 
 ) 
 print 
 ( 
 " 
 \t 
 Policy finding details:" 
 ) 
 for 
 ( 
 policy_topic_entry 
 ) 
 in 
 policy_finding_details 
 . 
 policy_topic_entries 
 : 
 ignorable_policy_topics 
 . 
 append 
 ( 
 policy_topic_entry 
 . 
 topic 
 ) 
 print 
 ( 
 f 
 " 
 \t\t 
 Policy topic name: ' 
 { 
 policy_topic_entry 
 . 
 topic 
 } 
 '" 
 ) 
 print 
 ( 
 f 
 " 
 \t\t 
 Policy topic entry type: ' 
 { 
 policy_topic_entry 
 . 
 type_ 
 } 
 '" 
 ) 
 # For the sake of brevity, we exclude printing "policy topic 
 # evidences" and "policy topic constraints" here. You can fetch 
 # those data by calling: 
 # - policy_topic_entry.evidences 
 # - policy_topic_entry.constraints 
 return 
 ignorable_policy_topics 
 def 
  
 request_exemption 
 ( 
 customer_id 
 : 
 str 
 , 
 ad_group_ad_service_client 
 : 
 AdGroupAdServiceClient 
 , 
 ad_group_ad_operation 
 : 
 AdGroupAdOperation 
 , 
 ignorable_policy_topics 
 : 
 List 
 [ 
 str 
 ], 
 ) 
 - 
> None 
 : 
  
 """Sends exemption requests for creating a responsive search ad. 
 Args: 
 customer_id: The customer ID for which to add the responsive search ad. 
 ad_group_ad_service_client: The AdGroupAdService client instance. 
 ad_group_ad_operation: The AdGroupAdOperation that returned policy 
 violation(s). 
 ignorable_policy_topics: The extracted list of policy topic entries. 
 """ 
 print 
 ( 
 "Attempting to add a responsive search ad again by requesting " 
 "exemption for its policy violations." 
 ) 
 ad_group_ad_operation 
 . 
 policy_validation_parameter 
 . 
 ignorable_policy_topics 
 . 
 extend 
 ( 
 ignorable_policy_topics 
 ) 
 response 
 : 
 MutateAdGroupAdsResponse 
 = 
 ( 
 ad_group_ad_service_client 
 . 
 mutate_ad_group_ads 
 ( 
 customer_id 
 = 
 customer_id 
 , 
 operations 
 = 
 [ 
 ad_group_ad_operation 
 ] 
 ) 
 ) 
 print 
 ( 
 "Successfully added a responsive search ad with resource name " 
 f 
 "' 
 { 
 response 
 . 
 results 
 [ 
 0 
 ] 
 . 
 resource_name 
 } 
 ' for policy violation " 
 "exemption." 
 ) 
 if 
 __name__ 
 == 
 "__main__" 
 : 
 parser 
 : 
 argparse 
 . 
 ArgumentParser 
 = 
 argparse 
 . 
 ArgumentParser 
 ( 
 description 
 = 
 "Requests an exemption for responsive search ad policy " 
 "violations." 
 ) 
 # The following argument(s) should be provided to run the example. 
 parser 
 . 
 add_argument 
 ( 
 "-c" 
 , 
 "--customer_id" 
 , 
 type 
 = 
 str 
 , 
 required 
 = 
 True 
 , 
 help 
 = 
 "The Google Ads customer ID." 
 , 
 ) 
 parser 
 . 
 add_argument 
 ( 
 "-a" 
 , 
 "--ad_group_id" 
 , 
 type 
 = 
 str 
 , 
 required 
 = 
 True 
 , 
 help 
 = 
 "The ad group ID to which to add a responsive search ad." 
 , 
 ) 
 args 
 = 
 parser 
 . 
 parse_args 
 () 
 # GoogleAdsClient will read the google-ads.yaml configuration file in the 
 # home directory if none is specified. 
 googleads_client 
 : 
 GoogleAdsClient 
 = 
 GoogleAdsClient 
 . 
 load_from_storage 
 ( 
 version 
 = 
 "v21" 
 ) 
 try 
 : 
 main 
 ( 
 googleads_client 
 , 
 args 
 . 
 customer_id 
 , 
 args 
 . 
 ad_group_id 
 ) 
 except 
 GoogleAdsException 
 as 
 ex 
 : 
 print 
 ( 
 f 
 "Request with ID ' 
 { 
 ex 
 . 
 request_id 
 } 
 ' failed with status " 
 f 
 "' 
 { 
 ex 
 . 
 error 
 . 
 code 
 () 
 . 
 name 
 } 
 ' and includes the following errors:" 
 ) 
 for 
 error 
 in 
 ex 
 . 
 failure 
 . 
 errors 
 : 
 print 
 ( 
 f 
 " 
 \t 
 Error with message ' 
 { 
 error 
 . 
 message 
 } 
 '." 
 ) 
 if 
 error 
 . 
 location 
 : 
 for 
 field_path_element 
 in 
 error 
 . 
 location 
 . 
 field_path_elements 
 : 
 print 
 ( 
 f 
 " 
 \t\t 
 On field: 
 { 
 field_path_element 
 . 
 field_name 
 } 
 " 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
   handle_responsive_search_ad_policy_violations 
 . 
 py

Ruby

 # Encoding: utf-8 
 # 
 # Copyright 2020 Google LLC 
 # 
 # Licensed under the Apache License, Version 2.0 (the "License"); 
 # you may not use this file except in compliance with the License. 
 # You may obtain a copy of the License at 
 # 
 #     https://www.apache.org/licenses/LICENSE-2.0 
 # 
 # Unless required by applicable law or agreed to in writing, software 
 # distributed under the License is distributed on an "AS IS" BASIS, 
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 # See the License for the specific language governing permissions and 
 # limitations under the License. 
 # 
 # Requests an exemption for policy violations of a responsive search ad. 
 # 
 # If the request somehow fails with exceptions that are not policy finding 
 # errors, the example will stop instead of trying to send an exemption request. 
 require 
  
 'optparse' 
 require 
  
 'google/ads/google_ads' 
 require 
  
 'date' 
 def 
  
 handle_responsive_search_ad_policy_violations 
 ( 
 customer_id 
 , 
  
 ad_group_id 
 ) 
  
 # GoogleAdsClient will read a config file from 
  
 # ENV['HOME']/google_ads_config.rb when called without parameters 
  
 client 
  
 = 
  
 Google 
 :: 
 Ads 
 :: 
 GoogleAds 
 :: 
 GoogleAdsClient 
 . 
 new 
  
 ad_group_ad_service 
  
 = 
  
 client 
 . 
 service 
 . 
 ad_group_ad 
  
 ad_group_ad_operation 
 , 
  
 ignorable_policy_topics 
  
 = 
  
 create_responsive_search_ad 
 ( 
  
 client 
 , 
  
 ad_group_ad_service 
 , 
  
 customer_id 
 , 
  
 ad_group_id 
 , 
  
 ) 
  
 request_exemption 
 ( 
  
 client 
 , 
  
 customer_id 
 , 
  
 ad_group_ad_service 
 , 
  
 ad_group_ad_operation 
 , 
  
 ignorable_policy_topics 
 , 
  
 ) 
 end 
 def 
  
 create_responsive_search_ad 
 ( 
 client 
 , 
  
 ad_group_ad_service 
 , 
  
 customer_id 
 , 
  
 ad_group_id 
 ) 
  
 ad_group_ad_operation 
  
 = 
  
 client 
 . 
 operation 
 . 
 create_resource 
 . 
 ad_group_ad 
  
 do 
  
 | 
 aga 
 | 
  
 aga 
 . 
 ad_group 
  
 = 
  
 client 
 . 
 path 
 . 
 ad_group 
 ( 
 customer_id 
 , 
  
 ad_group_id 
 ) 
  
 aga 
 . 
 status 
  
 = 
  
 :PAUSED 
  
 aga 
 . 
 ad 
  
 = 
  
 client 
 . 
 resource 
 . 
 ad 
  
 do 
  
 | 
 ad 
 | 
  
 ad 
 . 
 final_urls 
 << 
 "http://www.example.com" 
  
 ad 
 . 
 responsive_search_ad 
  
 = 
  
 client 
 . 
 resource 
 . 
 responsive_search_ad_info 
  
 do 
  
 | 
 rsa 
 | 
  
 rsa 
 . 
 headlines 
 << 
 client 
 . 
 resource 
 . 
 ad_text_asset 
  
 do 
  
 | 
 ta 
 | 
  
 ta 
 . 
 text 
  
 = 
  
 "Cruise to Mars # 
 #{ 
 ( 
 Time 
 . 
 new 
 . 
 to_f 
  
 * 
  
 1000 
 ) 
 . 
 to_i 
 } 
 " 
  
 end 
  
 rsa 
 . 
 headlines 
 << 
 client 
 . 
 resource 
 . 
 ad_text_asset 
  
 do 
  
 | 
 ta 
 | 
  
 ta 
 . 
 text 
  
 = 
  
 "Best space cruise line" 
  
 end 
  
 rsa 
 . 
 headlines 
 << 
 client 
 . 
 resource 
 . 
 ad_text_asset 
  
 do 
  
 | 
 ta 
 | 
  
 ta 
 . 
 text 
  
 = 
  
 "Experience the stars" 
  
 end 
  
 rsa 
 . 
 descriptions 
 << 
 client 
 . 
 resource 
 . 
 ad_text_asset 
  
 do 
  
 | 
 ta 
 | 
  
 # Intentionally use an ad text that violates policy -- having too 
  
 # many exclamation marks. 
  
 ta 
 . 
 text 
  
 = 
  
 "Buy your tickets now!!!!!!!" 
  
 end 
  
 rsa 
 . 
 descriptions 
 << 
 client 
 . 
 resource 
 . 
 ad_text_asset 
  
 do 
  
 | 
 ta 
 | 
  
 ta 
 . 
 text 
  
 = 
  
 "Visit the Red Planet" 
  
 end 
  
 end 
  
 end 
  
 end 
  
 ignorable_policy_topics 
  
 = 
  
 [] 
  
 begin 
  
 ad_group_ad_service 
 . 
 mutate_ad_group_ads 
 ( 
  
 customer_id 
 : 
  
 customer_id 
 , 
  
 operations 
 : 
  
 [ 
 ad_group_ad_operation 
 ] 
 , 
  
 ) 
  
 rescue 
  
 Google 
 :: 
 Ads 
 :: 
 GoogleAds 
 :: 
 Errors 
 :: 
 GoogleAdsError 
  
 = 
>  
 e 
  
 ignorable_policy_topics 
  
 = 
  
 fetch_ignorable_policy_topics 
 ( 
 e 
 ) 
  
 end 
  
 return 
  
 ad_group_ad_operation 
 , 
  
 ignorable_policy_topics 
 end 
 def 
  
 fetch_ignorable_policy_topics 
 ( 
 exception 
 ) 
  
 ignorable_policy_topics 
  
 = 
  
 [] 
  
 exception 
 . 
 failure 
 . 
 errors 
 . 
 each 
  
 do 
  
 | 
 error 
 | 
  
 if 
  
 error 
 . 
 error_code 
 . 
 policy_finding_error 
  
 != 
  
 :POLICY_FINDING 
  
 puts 
  
 "Non-policy finding error found. Aborting." 
  
 raise 
  
 exception 
  
 end 
  
 puts 
  
 " 
 #{ 
 error 
 . 
 error_code 
 . 
 policy_finding_error 
 } 
 : 
 #{ 
 error 
 . 
 message 
 } 
 " 
  
 error 
& . 
 details 
& . 
 policy_finding_details 
& . 
 policy_topic_entries 
 . 
 each 
  
 do 
  
 | 
 entry 
 | 
  
 ignorable_policy_topics 
 << 
 entry 
 . 
 topic 
  
 puts 
  
 " 
 \t 
 Policy topic name: 
 #{ 
 entry 
 . 
 topic 
 } 
 " 
  
 puts 
  
 " 
 \t 
 Policy topic entry type: 
 #{ 
 entry 
 . 
 type 
 } 
 " 
  
 end 
  
 end 
  
 ignorable_policy_topics 
 end 
 def 
  
 request_exemption 
 ( 
  
 client 
 , 
  
 customer_id 
 , 
  
 ad_group_ad_service 
 , 
  
 ad_group_ad_operation 
 , 
  
 ignorable_policy_topics 
 ) 
  
 # Add all the found ignorable policy topics to the operation. 
  
 ad_group_ad_operation 
 . 
 policy_validation_parameter 
  
 = 
  
 client 
 . 
 resource 
 . 
 policy_validation_parameter 
  
 do 
  
 | 
 pvp 
 | 
  
 pvp 
 . 
 ignorable_policy_topics 
 . 
 push 
 ( 
  
 * 
 ignorable_policy_topics 
  
 ) 
  
 end 
  
 response 
  
 = 
  
 ad_group_ad_service 
 . 
 mutate_ad_group_ads 
 ( 
  
 customer_id 
 : 
  
 customer_id 
 , 
  
 operations 
 : 
  
 [ 
 ad_group_ad_operation 
 ] 
 , 
  
 ) 
  
 puts 
  
 "Successfully added a responsive search ad with resource name " 
  
 \ 
  
 " 
 #{ 
 response 
 . 
 results 
 . 
 first 
 . 
 resource_name 
 } 
 for policy violation exception." 
 end 
 if 
  
 __FILE__ 
  
 == 
  
 $PROGRAM_NAME 
  
 options 
  
 = 
  
 {} 
  
 # The following parameter(s) should be provided to run the example. You can 
  
 # either specify these by changing the INSERT_XXX_ID_HERE values below, or on 
  
 # the command line. 
  
 # 
  
 # Parameters passed on the command line will override any parameters set in 
  
 # code. 
  
 # 
  
 # Running the example with -h will print the command line usage. 
  
 options 
 [ 
 :customer_id 
 ] 
  
 = 
  
 'INSERT_CUSTOMER_ID_HERE' 
  
 options 
 [ 
 :ad_group_id 
 ] 
  
 = 
  
 'INSERT_AD_GROUP_ID_HERE' 
  
 OptionParser 
 . 
 new 
  
 do 
  
 | 
 opts 
 | 
  
 opts 
 . 
 banner 
  
 = 
  
 sprintf 
 ( 
 'Usage: ruby %s [options]' 
 , 
  
 File 
 . 
 basename 
 ( 
 __FILE__ 
 )) 
  
 opts 
 . 
 separator 
  
 '' 
  
 opts 
 . 
 separator 
  
 'Options:' 
  
 opts 
 . 
 on 
 ( 
 '-C' 
 , 
  
 '--customer-id CUSTOMER-ID' 
 , 
  
 String 
 , 
  
 'Customer ID' 
 ) 
  
 do 
  
 | 
 v 
 | 
  
 options 
 [ 
 :customer_id 
 ] 
  
 = 
  
 v 
  
 end 
  
 opts 
 . 
 on 
 ( 
 '-A' 
 , 
  
 '--ad-group-id AD-GROUP-ID' 
 , 
  
 String 
 , 
  
 'Ad Group ID' 
 ) 
  
 do 
  
 | 
 v 
 | 
  
 options 
 [ 
 :ad_group_id 
 ] 
  
 = 
  
 v 
  
 end 
  
 opts 
 . 
 separator 
  
 '' 
  
 opts 
 . 
 separator 
  
 'Help:' 
  
 opts 
 . 
 on_tail 
 ( 
 '-h' 
 , 
  
 '--help' 
 , 
  
 'Show this message' 
 ) 
  
 do 
  
 puts 
  
 opts 
  
 exit 
  
 end 
  
 end 
 . 
 parse! 
  
 begin 
  
 handle_responsive_search_ad_policy_violations 
 ( 
  
 options 
 . 
 fetch 
 ( 
 :customer_id 
 ) 
 . 
 tr 
 ( 
 "-" 
 , 
  
 "" 
 ), 
  
 options 
 . 
 fetch 
 ( 
 :ad_group_id 
 ), 
  
 ) 
  
 rescue 
  
 Google 
 :: 
 Ads 
 :: 
 GoogleAds 
 :: 
 Errors 
 :: 
 GoogleAdsError 
  
 = 
>  
 e 
  
 e 
 . 
 failure 
 . 
 errors 
 . 
 each 
  
 do 
  
 | 
 error 
 | 
  
 STDERR 
 . 
 printf 
 ( 
 "Error with message: %s 
 \n 
 " 
 , 
  
 error 
 . 
 message 
 ) 
  
 if 
  
 error 
 . 
 location 
  
 error 
 . 
 location 
 . 
 field_path_elements 
 . 
 each 
  
 do 
  
 | 
 field_path_element 
 | 
  
 STDERR 
 . 
 printf 
 ( 
 " 
 \t 
 On field: %s 
 \n 
 " 
 , 
  
 field_path_element 
 . 
 field_name 
 ) 
  
 end 
  
 end 
  
 error 
 . 
 error_code 
 . 
 to_h 
 . 
 each 
  
 do 
  
 | 
 k 
 , 
  
 v 
 | 
  
 next 
  
 if 
  
 v 
  
 == 
  
 :UNSPECIFIED 
  
 STDERR 
 . 
 printf 
 ( 
 " 
 \t 
 Type: %s 
 \n\t 
 Code: %s 
 \n 
 " 
 , 
  
 k 
 , 
  
 v 
 ) 
  
 end 
  
 end 
  
 raise 
  
 end 
 end 
   handle_responsive_search_ad_policy_violations 
 . 
 rb

Perl

 #!/usr/bin/perl -w 
 # 
 # Copyright 2019, Google LLC 
 # 
 # Licensed under the Apache License, Version 2.0 (the "License"); 
 # you may not use this file except in compliance with the License. 
 # You may obtain a copy of the License at 
 # 
 #     http://www.apache.org/licenses/LICENSE-2.0 
 # 
 # Unless required by applicable law or agreed to in writing, software 
 # distributed under the License is distributed on an "AS IS" BASIS, 
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 # See the License for the specific language governing permissions and 
 # limitations under the License. 
 # 
 # This example demonstrates how to request an exemption for policy violations 
 # of a responsive search ad. If the request somehow fails with exceptions that are 
 # not policy finding errors, the example will stop instead of trying sending an 
 # exemption request. 
 use 
  
 strict 
 ; 
 use 
  
 warnings 
 ; 
 use 
  
 utf8 
 ; 
 use 
  
 FindBin 
  
 qw($Bin) 
 ; 
 use 
  
 lib 
  
 "$Bin/../../lib" 
 ; 
 use 
  
 Google::Ads::GoogleAds::Client 
 ; 
 use 
  
 Google::Ads::GoogleAds::Utils::GoogleAdsHelper 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Resources::AdGroupAd 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Resources::Ad 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Common::AdTextAsset 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Common::ResponsiveSearchAdInfo 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Common::PolicyValidationParameter 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Enums::AdGroupStatusEnum 
  
 qw(PAUSED) 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Services::AdGroupAdService::AdGroupAdOperation 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Utils::ResourceNames 
 ; 
 use 
  
 Getopt::Long 
  
 qw(:config auto_help) 
 ; 
 use 
  
 Pod::Usage 
 ; 
 use 
  
 Cwd 
  
 qw(abs_path) 
 ; 
 use 
  
 Data::Uniqid 
  
 qw(uniqid) 
 ; 
 sub 
  
 handle_responsive_search_ad_policy_violations 
  
 { 
  
 my 
  
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_id 
 ) 
  
 = 
  
 @_ 
 ; 
  
 my 
  
 $ad_group_resource_name 
  
 = 
  
 Google::Ads::GoogleAds::V21::Utils::ResourceNames:: 
 ad_group 
 ( 
 $customer_id 
 , 
  
 $ad_group_id 
 ); 
  
 # Create a responsive search ad info object. 
  
 my 
  
 $responsive_search_ad_info 
  
 = 
  
 Google::Ads::GoogleAds::V21::Common:: 
 ResponsiveSearchAdInfo 
 - 
> new 
 ({ 
  
 headlines 
  
 = 
>  
 [ 
  
 Google::Ads::GoogleAds::V21::Common:: 
 AdTextAsset 
 - 
> new 
 ({ 
  
 text 
  
 = 
>  
 "Cruise to Mars #" 
  
 . 
  
 uniqid 
 ()} 
  
 ), 
  
 Google::Ads::GoogleAds::V21::Common:: 
 AdTextAsset 
 - 
> new 
 ({ 
  
 text 
  
 = 
>  
 "Best Space Cruise Line" 
  
 } 
  
 ), 
  
 Google::Ads::GoogleAds::V21::Common:: 
 AdTextAsset 
 - 
> new 
 ({ 
  
 text 
  
 = 
>  
 "Experience the Stars" 
  
 }) 
  
 ], 
  
 descriptions 
  
 = 
>  
 [ 
  
 # Intentionally use an ad text that violates policy -- having too many 
  
 # exclamation marks. 
  
 Google::Ads::GoogleAds::V21::Common:: 
 AdTextAsset 
 - 
> new 
 ({ 
  
 text 
  
 = 
>  
 "Buy your tickets now!!!!!!!" 
  
 } 
  
 ), 
  
 Google::Ads::GoogleAds::V21::Common:: 
 AdTextAsset 
 - 
> new 
 ({ 
  
 text 
  
 = 
>  
 "Visit the Red Planet" 
  
 })]}); 
  
 # Create an ad group ad to hold the above ad. 
  
 my 
  
 $ad_group_ad 
  
 = 
  
 Google::Ads::GoogleAds::V21::Resources:: 
 AdGroupAd 
 - 
> new 
 ({ 
  
 adGroup 
  
 = 
>  
 $ad_group_resource_name 
 , 
  
 # Set the ad group ad to PAUSED to prevent it from immediately serving. 
  
 # Set to ENABLED once you've added targeting and the ad are ready to serve. 
  
 status 
  
 = 
>  
 PAUSED 
 , 
  
 # Set the responsive search ad info on an ad. 
  
 ad 
  
 = 
>  
 Google::Ads::GoogleAds::V21::Resources:: 
 Ad 
 - 
> new 
 ({ 
  
 responsiveSearchAd 
  
 = 
>  
 $responsive_search_ad_info 
 , 
  
 finalUrls 
  
 = 
>  
 [ 
 "https://www.example.com" 
 ]})}); 
  
 # Create an ad group ad operation. 
  
 my 
  
 $ad_group_ad_operation 
  
 = 
  
 Google::Ads::GoogleAds::V21::Services::AdGroupAdService:: 
 AdGroupAdOperation 
  
 - 
> new 
 ({ 
  
 create 
  
 = 
>  
 $ad_group_ad 
  
 }); 
  
 # Try sending a mutate request to add the ad group ad. 
  
 my 
  
 $response 
  
 = 
  
 $api_client 
 - 
> AdGroupAdService 
 () 
 - 
> mutate 
 ({ 
  
 customerId 
  
 = 
>  
 $customer_id 
 , 
  
 operations 
  
 = 
>  
 [ 
 $ad_group_ad_operation 
 ]}); 
  
 my 
  
 $ignorable_policy_topics 
  
 = 
  
 [] 
 ; 
  
 if 
  
 ( 
 $response 
 - 
> isa 
 ( 
 "Google::Ads::GoogleAds::GoogleAdsException" 
 )) 
  
 { 
  
 # The request will always fail because of the policy violation in the 
  
 # description of the ad. 
  
 $ignorable_policy_topics 
  
 = 
  
 fetch_ignorable_policy_topics 
 ( 
 $response 
 ); 
  
 } 
  
 # Try sending exemption requests for creating a responsive search ad. 
  
 request_exemption 
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_ad_operation 
 , 
  
 $ignorable_policy_topics 
 ); 
  
 return 
  
 1 
 ; 
 } 
 # Collects all ignorable policy topics that will be sent for exemption request 
 # later. 
 sub 
  
 fetch_ignorable_policy_topics 
  
 { 
  
 my 
  
 $google_ads_exception 
  
 = 
  
 shift 
 ; 
  
 my 
  
 $ignorable_policy_topics 
  
 = 
  
 [] 
 ; 
  
 printf 
  
 "Google Ads failure details:\n" 
 ; 
  
 foreach 
  
 my 
  
 $error 
  
 ( 
 @ 
 { 
 $google_ads_exception 
 - 
> get_google_ads_failure 
 () 
 - 
> { 
 errors 
 }}) 
  
 { 
  
 if 
  
 ([ 
 keys 
  
 % 
 { 
 $error 
 - 
> { 
 errorCode 
 }}] 
 - 
> [ 
 0 
 ] 
  
 ne 
  
 "policyFindingError" 
 ) 
  
 { 
  
 # This example supports sending exemption request for the policy finding 
  
 # error only. 
  
 die 
  
 $google_ads_exception 
 - 
> get_message 
 (); 
  
 } 
  
 printf 
  
 "\t%s: %s\n" 
 , 
  
 [ 
 keys 
  
 % 
 { 
 $error 
 - 
> { 
 errorCode 
 }}] 
 - 
> [ 
 0 
 ], 
  
 $error 
 - 
> { 
 message 
 }; 
  
 if 
  
 ( 
 $error 
 - 
> { 
 details 
 }{ 
 policyFindingDetails 
 }) 
  
 { 
  
 my 
  
 $policy_finding_details 
  
 = 
  
 $error 
 - 
> { 
 details 
 }{ 
 policyFindingDetails 
 }; 
  
 printf 
  
 "\tPolicy finding details:\n" 
 ; 
  
 foreach 
  
 my 
  
 $policy_topic_entry 
  
 ( 
  
 @ 
 { 
 $policy_finding_details 
 - 
> { 
 policyTopicEntries 
 }}) 
  
 { 
  
 push 
  
 @$ignorable_policy_topics 
 , 
  
 $policy_topic_entry 
 - 
> { 
 topic 
 }; 
  
 printf 
  
 "\t\tPolicy topic name: '%s'\n" 
 , 
  
 $policy_topic_entry 
 - 
> { 
 topic 
 }; 
  
 printf 
  
 "\t\tPolicy topic entry type: '%s'\n" 
 , 
  
 $policy_topic_entry 
 - 
> { 
 type 
 }; 
  
 # For the sake of brevity, we exclude printing "policy topic evidences" and 
  
 # "policy topic constraints" here. You can fetch those data by calling: 
  
 # - $policy_topic_entry->{evidences} 
  
 # - $policy_topic_entry->{constraints} 
  
 } 
  
 } 
  
 } 
  
 return 
  
 $ignorable_policy_topics 
 ; 
 } 
 # Sends exemption requests for creating a responsive search ad. 
 sub 
  
 request_exemption 
  
 { 
  
 my 
  
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_ad_operation 
 , 
  
 $ignorable_policy_topics 
 ) 
  
 = 
  
 @_ 
 ; 
  
 print 
  
 "Try adding a responsive search ad again by requesting exemption for its " 
  
 . 
  
 "policy violations.\n" 
 ; 
  
 $ad_group_ad_operation 
 - 
> { 
 policyValidationParameter 
 } 
  
 = 
  
 Google::Ads::GoogleAds::V21::Common:: 
 PolicyValidationParameter 
 - 
> new 
 ( 
  
 { 
 ignorablePolicyTopics 
  
 = 
>  
 $ignorable_policy_topics 
 }); 
  
 my 
  
 $ad_group_ads_response 
  
 = 
  
 $api_client 
 - 
> AdGroupAdService 
 () 
 - 
> mutate 
 ({ 
  
 customerId 
  
 = 
>  
 $customer_id 
 , 
  
 operations 
  
 = 
>  
 [ 
 $ad_group_ad_operation 
 ]}); 
  
 printf 
  
 "Successfully added a responsive search ad with resource name '%s' by " 
  
 . 
  
 "requesting for policy violation exemption.\n" 
 , 
  
 $ad_group_ads_response 
 - 
> { 
 results 
 }[ 
 0 
 ]{ 
 resourceName 
 }; 
 } 
 # Don't run the example if the file is being included. 
 if 
  
 ( 
 abs_path 
 ( 
 $0 
 ) 
  
 ne 
  
 abs_path 
 ( 
 __FILE__ 
 )) 
  
 { 
  
 return 
  
 1 
 ; 
 } 
 # Get Google Ads Client, credentials will be read from ~/googleads.properties. 
 my 
  
 $api_client 
  
 = 
  
 Google::Ads::GoogleAds:: 
 Client 
 - 
> new 
 (); 
 # By default examples are set to die on any server returned fault. 
 $api_client 
 - 
> set_die_on_faults 
 ( 
 0 
 ); 
 my 
  
 $customer_id 
  
 = 
  
 undef 
 ; 
 my 
  
 $ad_group_id 
  
 = 
  
 undef 
 ; 
 # Parameters passed on the command line will override any parameters set in code. 
 GetOptions 
 ( 
  
 "customer_id=s" 
  
 = 
>  
 \ 
 $customer_id 
 , 
  
 "ad_group_id=i" 
  
 = 
>  
 \ 
 $ad_group_id 
 ); 
 # Print the help message if the parameters are not initialized in the code nor 
 # in the command line. 
 pod2usage 
 ( 
 2 
 ) 
  
 if 
  
 not 
  
 check_params 
 ( 
 $customer_id 
 , 
  
 $ad_group_id 
 ); 
 # Call the example. 
 handle_responsive_search_ad_policy_violations 
 ( 
 $api_client 
 , 
  
 $customer_id 
  
 =~ 
  
 s/-//g 
 r 
 , 
  
 $ad_group_id 
 ); 
 =pod 
 =head1 NAME 
 handle_responsive_search_ad_policy_violations 
 =head1 DESCRIPTION 
 This example demonstrates how to request an exemption for policy violations of a 
 responsive search ad. If the request somehow fails with exceptions that are not policy 
 finding errors, the example will stop instead of trying sending an exemption request. 
 =head1 SYNOPSIS 
 handle_responsive_search_ad_policy_violations.pl [options] 
 -help                       Show the help message. 
 -customer_id                The Google Ads customer ID. 
 -ad_group_id                The ad group ID. 
 =cut 
   handle_responsive_search_ad_policy_violations 
 . 
 pl

Handle keyword policy violations

Java

 // Copyright 2020 Google LLC 
 // 
 // Licensed under the Apache License, Version 2.0 (the "License"); 
 // you may not use this file except in compliance with the License. 
 // You may obtain a copy of the License at 
 // 
 //     https://www.apache.org/licenses/LICENSE-2.0 
 // 
 // Unless required by applicable law or agreed to in writing, software 
 // distributed under the License is distributed on an "AS IS" BASIS, 
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 // See the License for the specific language governing permissions and 
 // limitations under the License. 
 package 
  
 com.google.ads.googleads.examples.errorhandling 
 ; 
 import 
  
 com.beust.jcommander.Parameter 
 ; 
 import 
  
 com.google.ads.googleads.examples.utils.ArgumentNames 
 ; 
 import 
  
 com.google.ads.googleads.examples.utils.CodeSampleParams 
 ; 
 import 
  
 com.google.ads.googleads.lib.GoogleAdsClient 
 ; 
 import 
  
 com.google.ads.googleads.v21.common.KeywordInfo 
 ; 
 import 
  
 com.google.ads.googleads.v21.common.PolicyViolationKey 
 ; 
 import 
  
 com.google.ads.googleads.v21.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus 
 ; 
 import 
  
 com.google.ads.googleads.v21.enums.KeywordMatchTypeEnum.KeywordMatchType 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.GoogleAdsError 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.GoogleAdsException 
 ; 
 import 
  
 com.google.ads.googleads.v21.errors.PolicyViolationDetails 
 ; 
 import 
  
 com.google.ads.googleads.v21.resources.AdGroupCriterion 
 ; 
 import 
  
 com.google.ads.googleads.v21.services.AdGroupCriterionOperation 
 ; 
 import 
  
 com.google.ads.googleads.v21.services.AdGroupCriterionServiceClient 
 ; 
 import 
  
 com.google.ads.googleads.v21.services.MutateAdGroupCriteriaResponse 
 ; 
 import 
  
 com.google.ads.googleads.v21.utils.ResourceNames 
 ; 
 import 
  
 com.google.common.collect.ImmutableList 
 ; 
 import 
  
 java.io.FileNotFoundException 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.util.ArrayList 
 ; 
 import 
  
 java.util.List 
 ; 
 /** 
 * Demonstrates how to request an exemption for policy violations of a keyword. 
 * 
 * <p>The example uses an exemptible policy-violating keyword by default. If you use a keyword that 
 * contains non-exemptible policy violations, it will not be sent with exemptions requested and you 
 * will still fail to create a keyword. 
 * 
 * <p>If you specify a keyword that doesn't violate any policies, this example will just add the 
 * keyword as usual, similar to what the AddKeywords example does. 
 * 
 * <p>When you send a request to add a keyword after requesting a policy exemption for that keyword, 
 * the request will pass as if you were adding a non-violating keyword. 
 */ 
 public 
  
 class 
 HandleKeywordPolicyViolations 
  
 { 
  
 private 
  
 static 
  
 class 
 HandleKeywordPolicyViolationsParams 
  
 extends 
  
 CodeSampleParams 
  
 { 
  
 @Parameter 
 ( 
 names 
  
 = 
  
 ArgumentNames 
 . 
 CUSTOMER_ID 
 , 
  
 required 
  
 = 
  
 true 
 ) 
  
 private 
  
 Long 
  
 customerId 
 ; 
  
 @Parameter 
 ( 
 names 
  
 = 
  
 ArgumentNames 
 . 
 AD_GROUP_ID 
 , 
  
 required 
  
 = 
  
 true 
 ) 
  
 private 
  
 Long 
  
 adGroupId 
 ; 
  
 @Parameter 
 ( 
 names 
  
 = 
  
 ArgumentNames 
 . 
 KEYWORD_TEXT 
 ) 
  
 private 
  
 String 
  
 keywordText 
  
 = 
  
 "medication" 
 ; 
  
 } 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 HandleKeywordPolicyViolationsParams 
  
 params 
  
 = 
  
 new 
  
 HandleKeywordPolicyViolationsParams 
 (); 
  
 if 
  
 ( 
 ! 
 params 
 . 
 parseArguments 
 ( 
 args 
 )) 
  
 { 
  
 // Either pass the required parameters for this example on the command line, or insert them 
  
 // into the code here. See the parameter class definition above for descriptions. 
  
 params 
 . 
 customerId 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_CUSTOMER_ID_HERE" 
 ); 
  
 params 
 . 
 adGroupId 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_AD_GROUP_ID_HERE" 
 ); 
  
 // Optional: Specify a keywordText here, or the default specified above will be used. 
  
 // params.keywordText = "INSERT_KEYWORD_TEXT_HERE"; 
  
 } 
  
 GoogleAdsClient 
  
 googleAdsClient 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 googleAdsClient 
  
 = 
  
 GoogleAdsClient 
 . 
 newBuilder 
 (). 
 fromPropertiesFile 
 (). 
 build 
 (); 
  
 } 
  
 catch 
  
 ( 
 FileNotFoundException 
  
 fnfe 
 ) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
  
 "Failed to load GoogleAdsClient configuration from file. Exception: %s%n" 
 , 
  
 fnfe 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ioe 
 ) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
 "Failed to create GoogleAdsClient. Exception: %s%n" 
 , 
  
 ioe 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 try 
  
 { 
  
 new 
  
 HandleKeywordPolicyViolations 
 () 
  
 . 
 runExample 
 ( 
 googleAdsClient 
 , 
  
 params 
 . 
 customerId 
 , 
  
 params 
 . 
 adGroupId 
 , 
  
 params 
 . 
 keywordText 
 ); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 gae 
 ) 
  
 { 
  
 // GoogleAdsException is the base class for most exceptions thrown by an API request. 
  
 // Instances of this exception have a message and a GoogleAdsFailure that contains a 
  
 // collection of GoogleAdsErrors that indicate the underlying causes of the 
  
 // GoogleAdsException. 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
  
 "Request ID %s failed due to GoogleAdsException. Underlying errors:%n" 
 , 
  
 gae 
 . 
 getRequestId 
 ()); 
  
 int 
  
 i 
  
 = 
  
 0 
 ; 
  
 for 
  
 ( 
 GoogleAdsError 
  
 googleAdsError 
  
 : 
  
 gae 
 . 
 getGoogleAdsFailure 
 (). 
 getErrorsList 
 ()) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
 "  Error %d: %s%n" 
 , 
  
 i 
 ++ 
 , 
  
 googleAdsError 
 ); 
  
 } 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 } 
  
 /** 
 * Runs the example. 
 * 
 * @param googleAdsClient the Google Ads API client. 
 * @param customerId the client customer ID. 
 * @param adGroupId the ID of the ad group to add a keyword to. 
 * @param keywordText the keyword text to add. 
 * @throws GoogleAdsException if an API request failed with one or more service errors. 
 */ 
  
 private 
  
 void 
  
 runExample 
 ( 
  
 GoogleAdsClient 
  
 googleAdsClient 
 , 
  
 long 
  
 customerId 
 , 
  
 Long 
  
 adGroupId 
 , 
  
 String 
  
 keywordText 
 ) 
  
 { 
  
 try 
  
 ( 
 AdGroupCriterionServiceClient 
  
 adGroupCriterionServiceClient 
  
 = 
  
 googleAdsClient 
 . 
 getLatestVersion 
 (). 
 createAdGroupCriterionServiceClient 
 ()) 
  
 { 
  
 // Configures the keyword text and match type settings. 
  
 KeywordInfo 
  
 keywordInfo 
  
 = 
  
 KeywordInfo 
 . 
 newBuilder 
 () 
  
 . 
 setText 
 ( 
 keywordText 
 ) 
  
 . 
 setMatchType 
 ( 
 KeywordMatchType 
 . 
 EXACT 
 ) 
  
 . 
 build 
 (); 
  
 // Constructs an ad group criterion using the keyword text info above. 
  
 AdGroupCriterion 
  
 adGroupCriterion 
  
 = 
  
 AdGroupCriterion 
 . 
 newBuilder 
 () 
  
 . 
 setAdGroup 
 ( 
 ResourceNames 
 . 
 adGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 )) 
  
 . 
 setStatus 
 ( 
 AdGroupCriterionStatus 
 . 
 ENABLED 
 ) 
  
 . 
 setKeyword 
 ( 
 keywordInfo 
 ) 
  
 . 
 build 
 (); 
  
 // Constructs an operation to create the ad group criterion. 
  
 AdGroupCriterionOperation 
  
 operation 
  
 = 
  
 AdGroupCriterionOperation 
 . 
 newBuilder 
 (). 
 setCreate 
 ( 
 adGroupCriterion 
 ). 
 build 
 (); 
  
 // Tries sending a mutate request to add the keyword. 
  
 List<PolicyViolationKey> 
  
 exemptibleKeys 
  
 = 
  
 new 
  
 ArrayList 
<> (); 
  
 int 
  
 errorCount 
  
 = 
  
 0 
 ; 
  
 try 
  
 { 
  
 MutateAdGroupCriteriaResponse 
  
 response 
  
 = 
  
 adGroupCriterionServiceClient 
 . 
 mutateAdGroupCriteria 
 ( 
  
 String 
 . 
 valueOf 
 ( 
 customerId 
 ), 
  
 ImmutableList 
 . 
 of 
 ( 
 operation 
 )); 
  
 // If the request succeeded, then either the keyword does not require a policy exemption or 
  
 // a policy exemption was previously submitted for the keyword. In either case, returns and 
  
 // skips the remaining portion of this example that resubmits with an exemption request. 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Successfully added a keyword with resource name '%s'. No exemptions needed.%n" 
 , 
  
 response 
 . 
 getResults 
 ( 
 0 
 ). 
 getResourceName 
 ()); 
  
 return 
 ; 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 e 
 ) 
  
 { 
  
 exemptibleKeys 
  
 = 
  
 extractExemptiblePolicyViolationKeys 
 ( 
 e 
 ); 
  
 errorCount 
  
 = 
  
 e 
 . 
 getGoogleAdsFailure 
 (). 
 getErrorsCount 
 (); 
  
 } 
  
 // Tries sending exemption requests for creating the keyword. However, if your keyword 
  
 // contains many policy violations, but not all of them are exemptible, the request will not 
  
 // be sent. 
  
 if 
  
 ( 
 exemptibleKeys 
 . 
 size 
 () 
  
 == 
  
 errorCount 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
  
 "Attempting to add the keyword again by requesting exemption for its policy" 
  
 + 
  
 " violations." 
 ); 
  
 // Creates a modified version of the operation with the exempt policy violation keys. 
  
 operation 
  
 = 
  
 operation 
 . 
 toBuilder 
 (). 
 addAllExemptPolicyViolationKeys 
 ( 
 exemptibleKeys 
 ). 
 build 
 (); 
  
 // Tries sending the mutate request again. 
  
 MutateAdGroupCriteriaResponse 
  
 response 
  
 = 
  
 adGroupCriterionServiceClient 
 . 
 mutateAdGroupCriteria 
 ( 
  
 String 
 . 
 valueOf 
 ( 
 customerId 
 ), 
  
 ImmutableList 
 . 
 of 
 ( 
 operation 
 )); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Successfully added a keyword with resource name '%s' by requesting " 
  
 + 
  
 "policy violation exemptions.%n" 
 , 
  
 response 
 . 
 getResults 
 ( 
 0 
 ). 
 getResourceName 
 ()); 
  
 } 
  
 else 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "No exemption request was sent because either:" 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "1) your keyword contained some non-exemptible policy violations, or" 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "2) other non-policy related errors were thrown" 
 ); 
  
 } 
  
 } 
  
 } 
  
 /** 
 * Collects all policy violation keys that can be exempted for sending an exemption request later. 
 * 
 * @param googleAdsException the exception to extract the keys from. 
 * @return the list of extracted exemptible keys. 
 */ 
  
 private 
  
 List<PolicyViolationKey> 
  
 extractExemptiblePolicyViolationKeys 
 ( 
  
 GoogleAdsException 
  
 googleAdsException 
 ) 
  
 { 
  
 List<PolicyViolationKey> 
  
 exemptibleKeys 
  
 = 
  
 new 
  
 ArrayList 
<> (); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "Google Ads failure details:" 
 ); 
  
 for 
  
 ( 
 GoogleAdsError 
  
 googleAdsError 
  
 : 
  
 googleAdsException 
 . 
 getGoogleAdsFailure 
 (). 
 getErrorsList 
 ()) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t%s: %s%n" 
 , 
  
 googleAdsError 
 . 
 getErrorCode 
 (), 
  
 googleAdsError 
 . 
 getMessage 
 ()); 
  
 if 
  
 ( 
 googleAdsError 
 . 
 hasDetails 
 () 
 && 
 googleAdsError 
 . 
 getDetails 
 (). 
 hasPolicyViolationDetails 
 ()) 
  
 { 
  
 PolicyViolationDetails 
  
 policyViolationDetails 
  
 = 
  
 googleAdsError 
 . 
 getDetails 
 (). 
 getPolicyViolationDetails 
 (); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "\tPolicy violation details:" 
 ); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "\t\tExternal policy name: '%s'%n" 
 , 
  
 policyViolationDetails 
 . 
 getExternalPolicyName 
 ()); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "\t\tExternal policy description: '%s'%n" 
 , 
  
 policyViolationDetails 
 . 
 getExternalPolicyDescription 
 ()); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t\tIs exemptible? '%s'%n" 
 , 
  
 policyViolationDetails 
 . 
 getIsExemptible 
 ()); 
  
 if 
  
 ( 
 policyViolationDetails 
 . 
 getIsExemptible 
 () 
 && 
 policyViolationDetails 
 . 
 hasKey 
 ()) 
  
 { 
  
 PolicyViolationKey 
  
 policyViolationKey 
  
 = 
  
 policyViolationDetails 
 . 
 getKey 
 (); 
  
 exemptibleKeys 
 . 
 add 
 ( 
 policyViolationKey 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "\t\tPolicy violation key:" 
 ); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t\t\tName: '%s'%n" 
 , 
  
 policyViolationKey 
 . 
 getPolicyName 
 ()); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t\t\tViolating text: '%s'%n" 
 , 
  
 policyViolationKey 
 . 
 getViolatingText 
 ()); 
  
 } 
  
 } 
  
 } 
  
 return 
  
 exemptibleKeys 
 ; 
  
 } 
 } 
   HandleKeywordPolicyViolations 
 . 
 java

C#

 // Copyright 2020 Google LLC 
 // 
 // Licensed under the Apache License, Version 2.0 (the "License"); 
 // you may not use this file except in compliance with the License. 
 // You may obtain a copy of the License at 
 // 
 //     http://www.apache.org/licenses/LICENSE-2.0 
 // 
 // Unless required by applicable law or agreed to in writing, software 
 // distributed under the License is distributed on an "AS IS" BASIS, 
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 // See the License for the specific language governing permissions and 
 // limitations under the License. 
 using 
  
 CommandLine 
 ; 
 using 
  
 Google.Ads.Gax.Examples 
 ; 
 using 
  
 Google.Ads.GoogleAds.Lib 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Common 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Errors 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Resources 
 ; 
 using 
  
 Google.Ads.GoogleAds.V21.Services 
 ; 
 using 
  
 System 
 ; 
 using 
  
 System.Collections.Generic 
 ; 
 using 
  
 static 
  
 Google 
 . 
 Ads 
 . 
 GoogleAds 
 . 
 V21 
 . 
 Enums 
 . 
 AdGroupCriterionStatusEnum 
 . 
 Types 
 ; 
 using 
  
 static 
  
 Google 
 . 
 Ads 
 . 
 GoogleAds 
 . 
 V21 
 . 
 Enums 
 . 
 KeywordMatchTypeEnum 
 . 
 Types 
 ; 
 namespace 
  
 Google.Ads.GoogleAds.Examples.V21 
 { 
  
 /// <summary> 
  
 /// This code example demonstrates how to request an exemption for policy violations of a 
  
 /// keyword. Note that the example uses an exemptible policy-violating keyword by default. 
  
 /// If you use a keyword that contains non-exemptible policy violations, they will not be 
  
 /// sent for exemption request and you will still fail to create a keyword. 
  
 /// If you specify a keyword that doesn't violate any policies, this example will just add the 
  
 /// keyword as usual, similar to what the AddKeywords example does. 
  
 /// Note that once you've requested policy exemption for a keyword, when you send a request for 
  
 /// adding it again, the request will pass like when you add a non-violating keyword. 
  
 /// </summary> 
  
 public 
  
 class 
  
 HandleKeywordPolicyViolations 
  
 : 
  
 ExampleBase 
  
 { 
  
 /// <summary> 
  
 /// Command line options for running the <see cref="HandleKeywordPolicyViolations"/> example. 
  
 /// </summary> 
  
 public 
  
 class 
  
 Options 
  
 : 
  
 OptionsBase 
  
 { 
  
 /// <summary> 
  
 /// The customer ID for which the call is made. 
  
 /// </summary> 
  
 [Option("customerId", Required = true, HelpText = 
 "The customer ID for which the call is made.")] 
  
 public 
  
 long 
  
 CustomerId 
  
 { 
  
 get 
 ; 
  
 set 
 ; 
  
 } 
  
 /// <summary> 
  
 /// ID of the ad group to which keywords are added. 
  
 /// </summary> 
  
 [Option("adGroupId", Required = true, HelpText = 
 "ID of the ad group to which keywords are added.")] 
  
 public 
  
 long 
  
 AdGroupId 
  
 { 
  
 get 
 ; 
  
 set 
 ; 
  
 } 
  
 /// <summary> 
  
 /// The keyword text to add to the ad group. 
  
 /// </summary> 
  
 [Option("keywordText", Required = false, HelpText = 
 "The keyword text to add to the ad group.")] 
  
 public 
  
 string 
  
 KeywordText 
  
 { 
  
 get 
 ; 
  
 set 
 ; 
  
 } 
  
 } 
  
 /// <summary> 
  
 /// Main method, to run this code example as a standalone application. 
  
 /// </summary> 
  
 /// <param name="args">The command line arguments.</param> 
  
 public 
  
 static 
  
 void 
  
 Main 
 ( 
 string 
 [] 
  
 args 
 ) 
  
 { 
  
 Options 
  
 options 
  
 = 
  
 ExampleUtilities 
 . 
 ParseCommandLine<Options> 
 ( 
 args 
 ); 
  
 HandleKeywordPolicyViolations 
  
 codeExample 
  
 = 
  
 new 
  
 HandleKeywordPolicyViolations 
 (); 
  
 Console 
 . 
 WriteLine 
 ( 
 codeExample 
 . 
 Description 
 ); 
  
 codeExample 
 . 
 Run 
 ( 
 new 
  
 GoogleAdsClient 
 (), 
  
 options 
 . 
 CustomerId 
 , 
  
 options 
 . 
 AdGroupId 
 , 
  
 options 
 . 
 KeywordText 
 ); 
  
 } 
  
 /// <summary> 
  
 /// The default keyword to be used if keyword is not provided. 
  
 /// </summary> 
  
 private 
  
 const 
  
 string 
  
 DEFAULT_KEYWORD 
  
 = 
  
 "medication" 
 ; 
  
 /// <summary> 
  
 /// Returns a description about the code example. 
  
 /// </summary> 
  
 public 
  
 override 
  
 string 
  
 Description 
  
 = 
>  
 "This code example demonstrates how to request an exemption for policy violations of " 
  
 + 
  
 "a keyword. Note that the example uses an exemptible policy-violating keyword by " 
  
 + 
  
 "default. If you use a keyword that contains non-exemptible policy violations, they " 
  
 + 
  
 "will not be sent for exemption request and you will still fail to create a keyword. " 
  
 + 
  
 "If you specify a keyword that doesn't violate any policies, this example will just " 
  
 + 
  
 "add the keyword as usual, similar to what the AddKeywords example does. Note that " 
  
 + 
  
 "once you've requested policy exemption for a keyword, when you send a request for " 
  
 + 
  
 "adding it again, the request will pass like when you add a non-violating keyword." 
 ; 
  
 /// <summary> 
  
 /// Runs the code example. 
  
 /// </summary> 
  
 /// <param name="client">The Google Ads client.</param> 
  
 /// <param name="customerId">The customer ID for which the call is made.</param> 
  
 /// <param name="adGroupId">ID of the ad group to which keywords are added.</param> 
  
 /// <param name="keywordText">The keyword text to add to the ad group.</param> 
  
 public 
  
 void 
  
 Run 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 long 
  
 adGroupId 
 , 
  
 string 
  
 keywordText 
 ) 
  
 { 
  
 // Get the AdGroupCriterionServiceClient. 
  
 AdGroupCriterionServiceClient 
  
 service 
  
 = 
  
 client 
 . 
 GetService 
 ( 
  
 Services 
 . 
 V21 
 . 
 AdGroupCriterionService 
 ); 
  
 if 
  
 ( 
 string 
 . 
 IsNullOrEmpty 
 ( 
 keywordText 
 )) 
  
 { 
  
 keywordText 
  
 = 
  
 DEFAULT_KEYWORD 
 ; 
  
 } 
  
 // Configures the keyword text and match type settings. 
  
 KeywordInfo 
  
 keywordInfo 
  
 = 
  
 new 
  
 KeywordInfo 
 () 
  
 { 
  
 Text 
  
 = 
  
 keywordText 
 , 
  
 MatchType 
  
 = 
  
 KeywordMatchType 
 . 
 Exact 
  
 }; 
  
 // Constructs an ad group criterion using the keyword text info above. 
  
 AdGroupCriterion 
  
 adGroupCriterion 
  
 = 
  
 new 
  
 AdGroupCriterion 
 () 
  
 { 
  
 AdGroup 
  
 = 
  
 ResourceNames 
 . 
 AdGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 ), 
  
 Status 
  
 = 
  
 AdGroupCriterionStatus 
 . 
 Paused 
 , 
  
 Keyword 
  
 = 
  
 keywordInfo 
  
 }; 
  
 AdGroupCriterionOperation 
  
 operation 
  
 = 
  
 new 
  
 AdGroupCriterionOperation 
 () 
  
 { 
  
 Create 
  
 = 
  
 adGroupCriterion 
  
 }; 
  
 try 
  
 { 
  
 try 
  
 { 
  
 // Try sending a mutate request to add the keyword. 
  
 MutateAdGroupCriteriaResponse 
  
 response 
  
 = 
  
 service 
 . 
 MutateAdGroupCriteria 
 ( 
  
 customerId 
 . 
 ToString 
 (), 
  
 new 
 [] 
  
 { 
  
 operation 
  
 }); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Added a keyword with resource name " 
  
 + 
  
 $"'{response.Results[0].ResourceName}'." 
 ); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 ex 
 ) 
  
 { 
  
 PolicyViolationKey 
 [] 
  
 exemptPolicyViolationKeys 
  
 = 
  
 FetchExemptPolicyViolationKeys 
 ( 
 ex 
 ); 
  
 // Try sending exemption requests for creating a keyword. However, if your 
  
 // keyword contains many policy violations, but not all of them are exemptible, 
  
 // the request will not be sent. 
  
 RequestExemption 
 ( 
 customerId 
 , 
  
 service 
 , 
  
 operation 
 , 
  
 exemptPolicyViolationKeys 
 ); 
  
 } 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 e 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "Failure:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Message: {e.Message}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Failure: {e.Failure}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Request ID: {e.RequestId}" 
 ); 
  
 throw 
 ; 
  
 } 
  
 } 
  
 /// <summary> 
  
 /// Collects all policy violation keys that can be exempted for sending a exemption 
  
 /// request later. 
  
 /// </summary> 
  
 /// <param name="ex">The Google Ads exception.</param> 
  
 /// <returns>The exemptible policy violation keys.</returns> 
  
 private 
  
 static 
  
 PolicyViolationKey 
 [] 
  
 FetchExemptPolicyViolationKeys 
 ( 
 GoogleAdsException 
  
 ex 
 ) 
  
 { 
  
 bool 
  
 isFullyExemptable 
  
 = 
  
 true 
 ; 
  
 List<PolicyViolationKey> 
  
 exemptPolicyViolationKeys 
  
 = 
  
 new 
  
 List<PolicyViolationKey> 
 (); 
  
 Console 
 . 
 WriteLine 
 ( 
 "Google Ads failure details:" 
 ); 
  
 foreach 
  
 ( 
 GoogleAdsError 
  
 error 
  
 in 
  
 ex 
 . 
 Failure 
 . 
 Errors 
 ) 
  
 { 
  
 if 
  
 ( 
 error 
 . 
 ErrorCode 
 . 
 ErrorCodeCase 
  
 != 
  
 ErrorCode 
 . 
 ErrorCodeOneofCase 
 . 
 PolicyViolationError 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "No exemption request is sent because there are other " 
  
 + 
  
 "non-policy related errors thrown." 
 ); 
  
 throw 
  
 ex 
 ; 
  
 } 
  
 if 
  
 ( 
 error 
 . 
 Details 
  
 != 
  
 null 
 && 
 error 
 . 
 Details 
 . 
 PolicyViolationDetails 
  
 != 
  
 null 
 ) 
  
 { 
  
 PolicyViolationDetails 
  
 details 
  
 = 
  
 error 
 . 
 Details 
 . 
 PolicyViolationDetails 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 $"- Policy violation details:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 " - Policy violation details:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"   - External policy name: '{details.ExternalPolicyName}'" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"   - External policy description: " 
  
 + 
  
 $"'{details.ExternalPolicyDescription}'" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"   - Is exemptable: '{details.IsExemptible}'" 
 ); 
  
 if 
  
 ( 
 details 
 . 
 IsExemptible 
 && 
 details 
 . 
 Key 
  
 != 
  
 null 
 ) 
  
 { 
  
 PolicyViolationKey 
  
 key 
  
 = 
  
 details 
 . 
 Key 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 $"   - Policy violation key:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"     - Name: {key.PolicyName}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"     - Violating Text: {key.ViolatingText}" 
 ); 
  
 exemptPolicyViolationKeys 
 . 
 Add 
 ( 
 key 
 ); 
  
 } 
  
 else 
  
 { 
  
 isFullyExemptable 
  
 = 
  
 false 
 ; 
  
 } 
  
 } 
  
 } 
  
 if 
  
 ( 
 ! 
 isFullyExemptable 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "No exemption request is sent because your keyword " 
  
 + 
  
 "contained some non-exemptible policy violations." 
 ); 
  
 throw 
  
 ex 
 ; 
  
 } 
  
 return 
  
 exemptPolicyViolationKeys 
 . 
 ToArray 
 (); 
  
 } 
  
 /// <summary> 
  
 /// Sends exemption requests for creating a keyword. 
  
 /// </summary> 
  
 /// <param name="customerId">The customer ID for which the call is made.</param> 
  
 /// <param name="service">The ad group criterion service.</param> 
  
 /// <param name="operation">The ad group criterion operation to request exemption for. 
  
 /// </param> 
  
 /// <param name="exemptPolicyViolationKeys">The exemptable policy violation keys.</param> 
  
 private 
  
 static 
  
 void 
  
 RequestExemption 
 ( 
  
 long 
  
 customerId 
 , 
  
 AdGroupCriterionServiceClient 
  
 service 
 , 
  
 AdGroupCriterionOperation 
  
 operation 
 , 
  
 PolicyViolationKey 
 [] 
  
 exemptPolicyViolationKeys 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "Try adding a keyword again by requesting exemption for its policy " 
  
 + 
  
 "violations." 
 ); 
  
 PolicyValidationParameter 
  
 validationParameter 
  
 = 
  
 new 
  
 PolicyValidationParameter 
 (); 
  
 validationParameter 
 . 
 ExemptPolicyViolationKeys 
 . 
 AddRange 
 ( 
 exemptPolicyViolationKeys 
 ); 
  
 operation 
 . 
 ExemptPolicyViolationKeys 
 . 
 AddRange 
 ( 
 exemptPolicyViolationKeys 
 ); 
  
 MutateAdGroupCriteriaResponse 
  
 response 
  
 = 
  
 service 
 . 
 MutateAdGroupCriteria 
 ( 
  
 customerId 
 . 
 ToString 
 (), 
  
 new 
 [] 
  
 { 
  
 operation 
  
 }); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Successfully added a keyword with resource name " 
  
 + 
  
 $"'{response.Results[0].ResourceName}' by requesting for policy violation " 
  
 + 
  
 $"exemption." 
 ); 
  
 } 
  
 } 
 } 
   HandleKeywordPolicyViolations 
 . 
 cs

PHP

< ?php 
 /** 
 * Copyright 2019 Google LLC 
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); 
 * you may not use this file except in compliance with the License. 
 * You may obtain a copy of the License at 
 * 
 *     https://www.apache.org/licenses/LICENSE-2.0 
 * 
 * Unless required by applicable law or agreed to in writing, software 
 * distributed under the License is distributed on an "AS IS" BASIS, 
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 * See the License for the specific language governing permissions and 
 * limitations under the License. 
 */ 
 namespace Google\Ads\GoogleAds\Examples\ErrorHandling; 
 require __DIR__ . '/../../vendor/autoload.php'; 
 use GetOpt\GetOpt; 
 use Google\Ads\GoogleAds\Examples\Utils\ArgumentNames; 
 use Google\Ads\GoogleAds\Examples\Utils\ArgumentParser; 
 use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder; 
 use Google\Ads\GoogleAds\Lib\V21\GoogleAdsClient; 
 use Google\Ads\GoogleAds\Lib\V21\GoogleAdsClientBuilder; 
 use Google\Ads\GoogleAds\Lib\V21\GoogleAdsException; 
 use Google\Ads\GoogleAds\Util\V21\ResourceNames; 
 use Google\Ads\GoogleAds\V21\Common\KeywordInfo; 
 use Google\Ads\GoogleAds\V21\Common\PolicyViolationKey; 
 use Google\Ads\GoogleAds\V21\Enums\AdGroupCriterionStatusEnum\AdGroupCriterionStatus; 
 use Google\Ads\GoogleAds\V21\Enums\KeywordMatchTypeEnum\KeywordMatchType; 
 use Google\Ads\GoogleAds\V21\Errors\GoogleAdsError; 
 use Google\Ads\GoogleAds\V21\Resources\AdGroupCriterion; 
 use Google\Ads\GoogleAds\V21\Services\AdGroupCriterionOperation; 
 use Google\Ads\GoogleAds\V21\Services\Client\AdGroupCriterionServiceClient; 
 use Google\Ads\GoogleAds\V21\Services\MutateAdGroupCriteriaRequest; 
 use Google\ApiCore\ApiException; 
 /** 
 * This example demonstrates how to request an exemption for policy violations of a keyword. 
 * Note that the example uses an exemptible policy-violating keyword by default. If you use a 
 * keyword that contains non-exemptible policy violations, they will not be sent for exemption 
 * request and you will still fail to create a keyword. 
 * If you specify a keyword that doesn't violate any policies, this example will just add the 
 * keyword as usual, similar to what the AddKeywords example does. 
 * 
 * Note that once you've requested policy exemption for a keyword, when you send a request for 
 * adding it again, the request will pass like when you add a non-violating keyword. 
 */ 
 class HandleKeywordPolicyViolations 
 { 
 private const CUSTOMER_ID = 'INSERT_CUSTOMER_ID_HERE'; 
 private const AD_GROUP_ID = 'INSERT_AD_GROUP_ID_HERE'; 
 // Specify the keyword text here or the default specified below will be used. 
 private const KEYWORD_TEXT = 'medication'; 
 public static function main() 
 { 
 // Either pass the required parameters for this example on the command line, or insert them 
 // into the constants above. 
 $options = (new ArgumentParser())->parseCommandArguments([ 
 ArgumentNames::CUSTOMER_ID => GetOpt::REQUIRED_ARGUMENT, 
 ArgumentNames::AD_GROUP_ID => GetOpt::REQUIRED_ARGUMENT, 
 ArgumentNames::KEYWORD_TEXT => GetOpt::OPTIONAL_ARGUMENT 
 ]); 
 // Generate a refreshable OAuth2 credential for authentication. 
 $oAuth2Credential = (new OAuth2TokenBuilder())->fromFile()->build(); 
 // Construct a Google Ads client configured from a properties file and the 
 // OAuth2 credentials above. 
 $googleAdsClient = (new GoogleAdsClientBuilder())->fromFile() 
 ->withOAuth2Credential($oAuth2Credential) 
 ->build(); 
 try { 
 self::runExample( 
 $googleAdsClient, 
 $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID, 
 $options[ArgumentNames::AD_GROUP_ID] ?: self::AD_GROUP_ID, 
 $options[ArgumentNames::KEYWORD_TEXT] ?: self::KEYWORD_TEXT 
 ); 
 } catch (GoogleAdsException $googleAdsException) { 
 printf( 
 "Request with ID '%s' has failed.%sGoogle Ads failure details:%s", 
 $googleAdsException->getRequestId(), 
 PHP_EOL, 
 PHP_EOL 
 ); 
 foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { 
 /** @var GoogleAdsError $error */ 
 printf( 
 "\t%s: %s%s", 
 $error->getErrorCode()->getErrorCode(), 
 $error->getMessage(), 
 PHP_EOL 
 ); 
 } 
 exit(1); 
 } catch (ApiException $apiException) { 
 printf( 
 "ApiException was thrown with message '%s'.%s", 
 $apiException->getMessage(), 
 PHP_EOL 
 ); 
 exit(1); 
 } 
 } 
 /** 
 * Runs the example. 
 * 
 * @param GoogleAdsClient $googleAdsClient the Google Ads API client 
 * @param int $customerId the customer ID 
 * @param int $adGroupId the ad group ID to add a keyword to 
 * @param string $keywordText the keyword text to add 
 */ 
 public static function runExample( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId, 
 int $adGroupId, 
 string $keywordText 
 ) { 
 // Configures the keyword text and match type settings. 
 $keywordInfo = new KeywordInfo([ 
 'text' => $keywordText, 
 'match_type' => KeywordMatchType::EXACT 
 ]); 
 // Constructs an ad group criterion using the keyword text info above. 
 $adGroupCriterion = new AdGroupCriterion([ 
 'ad_group' => ResourceNames::forAdGroup($customerId, $adGroupId), 
 'status' => AdGroupCriterionStatus::ENABLED, 
 'keyword' => $keywordInfo 
 ]); 
 $adGroupCriterionOperation = new AdGroupCriterionOperation(); 
 $adGroupCriterionOperation->setCreate($adGroupCriterion); 
 $adGroupCriterionServiceClient = $googleAdsClient->getAdGroupCriterionServiceClient(); 
 try { 
 // Try sending a mutate request to add the keyword. 
 $response = $adGroupCriterionServiceClient->mutateAdGroupCriteria( 
 MutateAdGroupCriteriaRequest::build($customerId, [$adGroupCriterionOperation]) 
 ); 
 printf( 
 "Added a keyword with resource name '%s'.%s", 
 $response->getResults()[0]->getResourceName(), 
 PHP_EOL 
 ); 
 } catch (GoogleAdsException $googleAdsException) { 
 // Try sending exemption requests for creating a keyword. However, if your keyword 
 // contains many policy violations, but not all of them are exemptible, the request 
 // will not be sent. 
 $exemptPolicyViolationKeys = self::fetchExemptPolicyViolationKeys($googleAdsException); 
 self::requestExemption( 
 $customerId, 
 $adGroupCriterionServiceClient, 
 $adGroupCriterionOperation, 
 $exemptPolicyViolationKeys 
 ); 
 } 
 } 
 /** 
 * Collects all policy violation keys that can be exempted for sending a exemption request 
 * later. 
 * 
 * @param GoogleAdsException $googleAdsException the Google Ads exception 
 * @return PolicyViolationKey[] the exemptible policy violation keys 
 */ 
 private static function fetchExemptPolicyViolationKeys(GoogleAdsException $googleAdsException) 
 { 
 $exemptPolicyViolationKeys = []; 
 printf("Google Ads failure details:%s", PHP_EOL); 
 foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) { 
 /** @var GoogleAdsError $error */ 
 printf( 
 "\t%s: %s%s", 
 $error->getErrorCode()->getErrorCode(), 
 $error->getMessage(), 
 PHP_EOL 
 ); 
 if ( 
 !is_null($error->getDetails()) 
 && !is_null($error->getDetails()->getPolicyViolationDetails()) 
 ) { 
 $policyViolationDetails = $error->getDetails()->getPolicyViolationDetails(); 
 printf("\tPolicy violation details:%s", PHP_EOL); 
 printf( 
 "\t\tExternal policy name: '%s'%s", 
 $policyViolationDetails->getExternalPolicyName(), 
 PHP_EOL 
 ); 
 printf( 
 "\t\tExternal policy description: '%s'%s", 
 $policyViolationDetails->getExternalPolicyDescription(), 
 PHP_EOL 
 ); 
 printf( 
 "\t\tIs exemptible? '%s'%s", 
 $policyViolationDetails->getIsExemptible() ? 'yes' : 'no', 
 PHP_EOL 
 ); 
 if ( 
 $policyViolationDetails->getIsExemptible() 
&& !is_null($policyViolationDetails->getKey()) 
 ) { 
 $policyViolationDetailsKey = $policyViolationDetails->getKey(); 
 $exemptPolicyViolationKeys[] = $policyViolationDetailsKey; 
 printf("\t\tPolicy violation key:%s", PHP_EOL); 
 printf( 
 "\t\t\tName: '%s'%s", 
 $policyViolationDetailsKey->getPolicyName(), 
 PHP_EOL 
 ); 
 printf( 
 "\t\t\tViolating text: '%s'%s", 
 $policyViolationDetailsKey->getViolatingText(), 
 PHP_EOL 
 ); 
 } else { 
 print "No exemption request is sent because your keyword contained some " 
 . "non-exemptible policy violations." . PHP_EOL; 
 throw $googleAdsException; 
 } 
 } else { 
 print "No exemption request is sent because there are other non-policy related " 
 . "errors thrown." . PHP_EOL; 
 throw $googleAdsException; 
 } 
 } 
 return $exemptPolicyViolationKeys; 
 } 
 /** 
 * Sends exemption requests for creating a keyword. 
 * 
 * @param int $customerId the customer ID 
 * @param AdGroupCriterionServiceClient $adGroupCriterionServiceClient the ad group criterion 
 *      service API client 
 * @param AdGroupCriterionOperation $adGroupCriterionOperation the ad group criterion operation 
 *      to request exemption for 
 * @param PolicyViolationKey[] $exemptPolicyViolationKeys the exemptible policy violation keys 
 */ 
 private static function requestExemption( 
 int $customerId, 
 AdGroupCriterionServiceClient $adGroupCriterionServiceClient, 
 AdGroupCriterionOperation $adGroupCriterionOperation, 
 array $exemptPolicyViolationKeys 
 ) { 
 print "Try adding a keyword again by requesting exemption for its policy" 
 . " violations." . PHP_EOL; 
 $adGroupCriterionOperation->setExemptPolicyViolationKeys($exemptPolicyViolationKeys); 
 $response = $adGroupCriterionServiceClient->mutateAdGroupCriteria( 
 MutateAdGroupCriteriaRequest::build($customerId, [$adGroupCriterionOperation]) 
 ); 
 printf( 
 "Successfully added a keyword with resource name '%s' by requesting for" 
 . " policy violation exemption.%s", 
 $response->getResults()[0]->getResourceName(), 
 PHP_EOL 
 ); 
 } 
 } 
 HandleKeywordPolicyViolations::main(); 
   HandleKeywordPolicyViolations.php

Python

 #!/usr/bin/env python 
 # Copyright 2020 Google LLC 
 # 
 # Licensed under the Apache License, Version 2.0 (the "License"); 
 # you may not use this file except in compliance with the License. 
 # You may obtain a copy of the License at 
 # 
 #     https://www.apache.org/licenses/LICENSE-2.0 
 # 
 # Unless required by applicable law or agreed to in writing, software 
 # distributed under the License is distributed on an "AS IS" BASIS, 
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 # See the License for the specific language governing permissions and 
 # limitations under the License. 
 """Demonstrates how to request an exemption for policy violations of a keyword. 
 Note that the example uses an exemptible policy-violating keyword by default. 
 If you use a keyword that contains non-exemptible policy violations, they will 
 not be sent for exemption request, and you will still fail to create a keyword. 
 If you specify a keyword that doesn't violate any policies, this example will 
 just add the keyword as usual, similar to what the AddKeywords example does. 
 Note that once you've requested policy exemption for a keyword, when you send 
 a request for adding it again, the request will pass like when you add a 
 non-violating keyword. 
 """ 
 import 
  
 argparse 
 import 
  
 sys 
 from 
  
 typing 
  
 import 
 Any 
 , 
 List 
 , 
 Optional 
 , 
 Tuple 
 from 
  
 google.ads.googleads.client 
  
 import 
 GoogleAdsClient 
 from 
  
 google.ads.googleads.errors 
  
 import 
 GoogleAdsException 
 from 
  
 google.ads.googleads.v21.services.services.ad_group_criterion_service 
  
 import 
 ( 
 AdGroupCriterionServiceClient 
 , 
 ) 
 from 
  
 google.ads.googleads.v21.services.types.ad_group_criterion_service 
  
 import 
 ( 
 AdGroupCriterionOperation 
 , 
 ) 
 from 
  
 google.ads.googleads.v21.common.types.policy 
  
 import 
 PolicyViolationKey 
 def 
  
 main 
 ( 
 client 
 : 
 GoogleAdsClient 
 , 
 customer_id 
 : 
 str 
 , 
 ad_group_id 
 : 
 str 
 , 
 keyword_text 
 : 
 str 
 , 
 ) 
 - 
> None 
 : 
  
 """Demonstrates how to request an exemption for keyword policy violations. 
 Args: 
 client: The Google Ads client. 
 customer_id: The customer ID for which to add the keyword. 
 ad_group_id: The ad group ID to which to add keyword. 
 keyword_text: The keyword text to add. 
 """ 
 ad_group_criterion_service 
 : 
 AdGroupCriterionServiceClient 
 = 
 ( 
 client 
 . 
 get_service 
 ( 
 "AdGroupCriterionService" 
 ) 
 ) 
 googleads_exception 
 : 
 Optional 
 [ 
 GoogleAdsException 
 ] 
 ad_group_criterion_operation 
 : 
 AdGroupCriterionOperation 
 ( 
 googleads_exception 
 , 
 ad_group_criterion_operation 
 , 
 ) 
 = 
 create_keyword_criterion 
 ( 
 client 
 , 
 ad_group_criterion_service 
 , 
 customer_id 
 , 
 ad_group_id 
 , 
 keyword_text 
 , 
 ) 
 try 
 : 
 # Try sending exemption requests for creating a keyword. However, if 
 # your keyword contains many policy violations, but not all of them are 
 # exemptible, the request will not be sent. 
 if 
 googleads_exception 
 is 
 not 
 None 
 : 
 exempt_policy_violation_keys 
 : 
 List 
 [ 
 PolicyViolationKey 
 ] 
 = 
 ( 
 fetch_exempt_policy_violation_keys 
 ( 
 googleads_exception 
 ) 
 ) 
 request_exemption 
 ( 
 customer_id 
 , 
 ad_group_criterion_service 
 , 
 ad_group_criterion_operation 
 , 
 exempt_policy_violation_keys 
 , 
 ) 
 except 
 GoogleAdsException 
 as 
 ex 
 : 
 print 
 ( 
 f 
 "Request with ID ' 
 { 
 ex 
 . 
 request_id 
 } 
 ' failed with status " 
 f 
 "' 
 { 
 ex 
 . 
 error 
 . 
 code 
 () 
 . 
 name 
 } 
 ' and includes the following errors:" 
 ) 
 for 
 error 
 in 
 ex 
 . 
 failure 
 . 
 errors 
 : 
 print 
 ( 
 f 
 " 
 \t 
 Error with message ' 
 { 
 error 
 . 
 message 
 } 
 '." 
 ) 
 if 
 error 
 . 
 location 
 : 
 for 
 field_path_element 
 in 
 error 
 . 
 location 
 . 
 field_path_elements 
 : 
 print 
 ( 
 f 
 " 
 \t\t 
 On field: 
 { 
 field_path_element 
 . 
 field_name 
 } 
 " 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 def 
  
 create_keyword_criterion 
 ( 
 client 
 : 
 GoogleAdsClient 
 , 
 ad_group_criterion_service 
 : 
 AdGroupCriterionServiceClient 
 , 
 customer_id 
 : 
 str 
 , 
 ad_group_id 
 : 
 str 
 , 
 keyword_text 
 : 
 str 
 , 
 ) 
 - 
> Tuple 
 [ 
 Optional 
 [ 
 GoogleAdsException 
 ], 
 AdGroupCriterionOperation 
 ]: 
  
 """Attempts to add a keyword criterion to an ad group. 
 Args: 
 client: The GoogleAds client instance. 
 ad_group_criterion_service: The AdGroupCriterionService client instance. 
 customer_id: The customer ID for which to add the expanded text ad. 
 ad_group_id: The ad group ID to which to add an expanded text ad. 
 keyword_text: The keyword text to add. 
 Returns: 
 The GoogleAdsException that occurred (or None if the operation was 
 successful) and the modified operation. 
 """ 
 # Constructs an ad group criterion using the keyword text provided. 
 ad_group_criterion_operation 
 : 
 AdGroupCriterionOperation 
 = 
 client 
 . 
 get_type 
 ( 
 "AdGroupCriterionOperation" 
 ) 
 ad_group_criterion 
 : 
 Any 
 = 
 ad_group_criterion_operation 
 . 
 create 
 ad_group_criterion 
 . 
 ad_group 
 = 
 client 
 . 
 get_service 
 ( 
 "AdGroupService" 
 ) 
 . 
 ad_group_path 
 ( 
 customer_id 
 , 
 ad_group_id 
 ) 
 ad_group_criterion 
 . 
 status 
 = 
 client 
 . 
 enums 
 . 
 AdGroupCriterionStatusEnum 
 . 
 ENABLED 
 ad_group_criterion 
 . 
 keyword 
 . 
 text 
 = 
 keyword_text 
 ad_group_criterion 
 . 
 keyword 
 . 
 match_type 
 = 
 ( 
 client 
 . 
 enums 
 . 
 KeywordMatchTypeEnum 
 . 
 EXACT 
 ) 
 try 
 : 
 # Try sending a mutate request to add the keyword. 
 response 
 : 
 Any 
 = 
 ad_group_criterion_service 
 . 
 mutate_ad_group_criteria 
 ( 
 customer_id 
 = 
 customer_id 
 , 
 operations 
 = 
 [ 
 ad_group_criterion_operation 
 ] 
 ) 
 except 
 GoogleAdsException 
 as 
 googleads_exception 
 : 
 # Return the exception in order to extract keyword violation details. 
 return 
 googleads_exception 
 , 
 ad_group_criterion_operation 
 # Report that the mutate request was completed successfully. 
 print 
 ( 
 "Added a keyword with resource name " 
 f 
 "' 
 { 
 response 
 . 
 results 
 [ 
 0 
 ] 
 . 
 resource_name 
 } 
 '." 
 ) 
 return 
 None 
 , 
 ad_group_criterion_operation 
 def 
  
 fetch_exempt_policy_violation_keys 
 ( 
 googleads_exception 
 : 
 GoogleAdsException 
 , 
 ) 
 - 
> List 
 [ 
 PolicyViolationKey 
 ]: 
  
 """Collects all policy violation keys that can be exempted. 
 Args: 
 googleads_exception: The exception to check for policy violation(s). 
 Returns: 
 A list of policy violation keys. 
 """ 
 exempt_policy_violation_keys 
 : 
 List 
 [ 
 PolicyViolationKey 
 ] 
 = 
 [] 
 print 
 ( 
 "Google Ads failure details:" 
 ) 
 for 
 error 
 in 
 googleads_exception 
 . 
 failure 
 . 
 errors 
 : 
 print 
 ( 
 f 
 " 
 \t 
 { 
 error 
 . 
 error_code 
 } 
 : 
 { 
 error 
 . 
 message 
 } 
 " 
 ) 
 if 
 ( 
 error 
 . 
 details 
 is 
 not 
 None 
 and 
 error 
 . 
 details 
 . 
 policy_violation_details 
 is 
 not 
 None 
 ): 
 policy_violation_details 
 = 
 error 
 . 
 details 
 . 
 policy_violation_details 
 print 
 ( 
 " 
 \t 
 Policy violation details: 
 \n 
 " 
 f 
 " 
 \t\t 
 External policy name: ' 
 { 
 policy_violation_details 
 } 
 ' 
 \n 
 " 
 " 
 \t\t 
 External policy description: " 
 f 
 "' 
 { 
 policy_violation_details 
 . 
 external_policy_description 
 } 
 ' 
 \n 
 " 
 f 
 " 
 \t\t 
 Is exemptible? ' 
 { 
 policy_violation_details 
 . 
 is_exemptible 
 } 
 '" 
 ) 
 if 
 ( 
 policy_violation_details 
 . 
 is_exemptible 
 and 
 policy_violation_details 
 . 
 key 
 is 
 not 
 None 
 ): 
 exempt_policy_violation_keys 
 . 
 append 
 ( 
 policy_violation_details 
 . 
 key 
 ) 
 print 
 ( 
 f 
 " 
 \t\t 
 Policy violation key: 
 { 
 policy_violation_details 
 . 
 key 
 } 
 " 
 ) 
 print 
 ( 
 f 
 " 
 \t\t\t 
 Name: ' 
 { 
 policy_violation_details 
 . 
 key 
 . 
 policy_name 
 } 
 '" 
 " 
 \t\t\t 
 Violating text: " 
 f 
 "' 
 { 
 policy_violation_details 
 . 
 key 
 . 
 violating_text 
 } 
 '" 
 ) 
 else 
 : 
 print 
 ( 
 "No exemption request is sent because your keyword " 
 "contained some non-exemptible policy violations." 
 ) 
 raise 
 googleads_exception 
 else 
 : 
 print 
 ( 
 "No exemption request is sent because there are non-policy " 
 "related errors thrown." 
 ) 
 raise 
 googleads_exception 
 return 
 exempt_policy_violation_keys 
 def 
  
 request_exemption 
 ( 
 customer_id 
 : 
 str 
 , 
 ad_group_criterion_service 
 : 
 AdGroupCriterionServiceClient 
 , 
 ad_group_criterion_operation 
 : 
 AdGroupCriterionOperation 
 , 
 exempt_policy_violation_keys 
 : 
 List 
 [ 
 PolicyViolationKey 
 ], 
 ) 
 - 
> None 
 : 
  
 """Sends exemption requests for creating a keyword. 
 Args: 
 customer_id: The customer ID for which to add the expanded text ad. 
 ad_group_criterion_service: The AdGroupCriterionService client instance. 
 ad_group_criterion_operation: The AdGroupCriterionOperation for which 
 to request exemption. 
 exempt_policy_violation_keys: The exemptible policy violation keys. 
 """ 
 print 
 ( 
 "Attempting to add a keyword again by requesting exemption for its " 
 "policy violations." 
 ) 
 ad_group_criterion_operation 
 . 
 exempt_policy_violation_keys 
 . 
 extend 
 ( 
 exempt_policy_violation_keys 
 ) 
 response 
 : 
 Any 
 = 
 ad_group_criterion_service 
 . 
 mutate_ad_group_criteria 
 ( 
 customer_id 
 = 
 customer_id 
 , 
 operations 
 = 
 [ 
 ad_group_criterion_operation 
 ] 
 ) 
 print 
 ( 
 "Successfully added a keyword with resource name " 
 f 
 "' 
 { 
 response 
 . 
 results 
 [ 
 0 
 ] 
 . 
 resource_name 
 } 
 ' by requesting a policy " 
 "violation exemption." 
 ) 
 if 
 __name__ 
 == 
 "__main__" 
 : 
 parser 
 = 
 argparse 
 . 
 ArgumentParser 
 ( 
 description 
 = 
 "Demonstrates how to request an exemption for policy " 
 "violations of a keyword." 
 ) 
 # The following argument(s) should be provided to run the example. 
 parser 
 . 
 add_argument 
 ( 
 "-c" 
 , 
 "--customer_id" 
 , 
 type 
 = 
 str 
 , 
 required 
 = 
 True 
 , 
 help 
 = 
 "The Google Ads customer ID." 
 , 
 ) 
 parser 
 . 
 add_argument 
 ( 
 "-a" 
 , 
 "--ad_group_id" 
 , 
 type 
 = 
 str 
 , 
 required 
 = 
 True 
 , 
 help 
 = 
 "The ad group ID to which to add an expanded text ad." 
 , 
 ) 
 parser 
 . 
 add_argument 
 ( 
 "-k" 
 , 
 "--keyword_text" 
 , 
 type 
 = 
 str 
 , 
 required 
 = 
 False 
 , 
 default 
 = 
 "medication" 
 , 
 help 
 = 
 "Specify the keyword text here or use the default keyword " 
 "'medication'." 
 , 
 ) 
 args 
 = 
 parser 
 . 
 parse_args 
 () 
 # GoogleAdsClient will read the google-ads.yaml configuration file in the 
 # home directory if none is specified. 
 googleads_client 
 : 
 GoogleAdsClient 
 = 
 GoogleAdsClient 
 . 
 load_from_storage 
 ( 
 version 
 = 
 "v21" 
 ) 
 main 
 ( 
 googleads_client 
 , 
 args 
 . 
 customer_id 
 , 
 args 
 . 
 ad_group_id 
 , 
 args 
 . 
 keyword_text 
 ) 
   handle_keyword_policy_violations 
 . 
 py

Ruby

 # Encoding: utf-8 
 # 
 # Copyright 2020 Google LLC 
 # 
 # Licensed under the Apache License, Version 2.0 (the "License"); 
 # you may not use this file except in compliance with the License. 
 # You may obtain a copy of the License at 
 # 
 #     https://www.apache.org/licenses/LICENSE-2.0 
 # 
 # Unless required by applicable law or agreed to in writing, software 
 # distributed under the License is distributed on an "AS IS" BASIS, 
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 # See the License for the specific language governing permissions and 
 # limitations under the License. 
 # 
 # Demonstrates how to request an exemption for policy violations of a keyword. 
 # 
 # Note that the example uses an exemptible policy-violating keyword by default. 
 # If you use a keyword that contains non-exemptible policy violations, they 
 # will not be sent for exemption request and you will still fail to create a 
 # keyword.  If you specify a keyword that doesn't violate any policies, this 
 # example will just add the keyword as usual, similar to what the AddKeywords 
 # example does. 
 # 
 # Note that once you've requested policy exemption for a keyword, when you send 
 # a request for adding it again, the request will pass like when you add a 
 # non-violating keyword. 
 require 
  
 'optparse' 
 require 
  
 'google/ads/google_ads' 
 require 
  
 'date' 
 def 
  
 handle_keyword_policy_violations 
 ( 
 customer_id 
 , 
  
 ad_group_id 
 , 
  
 keyword_text 
 ) 
  
 # GoogleAdsClient will read a config file from 
  
 # ENV['HOME']/google_ads_config.rb when called without parameters 
  
 client 
  
 = 
  
 Google 
 :: 
 Ads 
 :: 
 GoogleAds 
 :: 
 GoogleAdsClient 
 . 
 new 
  
 ad_group_criterion_service 
  
 = 
  
 client 
 . 
 service 
 . 
 ad_group_criterion 
  
 exception 
 , 
  
 ad_group_criterion_operation 
  
 = 
  
 create_keyword_criterion 
 ( 
  
 client 
 , 
  
 ad_group_criterion_service 
 , 
  
 customer_id 
 , 
  
 ad_group_id 
 , 
  
 keyword_text 
 , 
  
 ) 
  
 unless 
  
 exception 
 . 
 nil? 
  
 exempt_policy_violation_keys 
  
 = 
  
 fetch_exempt_policy_violation_keys 
 ( 
 exception 
 ) 
  
 request_exemption 
 ( 
  
 client 
 , 
  
 customer_id 
 , 
  
 ad_group_criterion_service 
 , 
  
 ad_group_criterion_operation 
 , 
  
 exempt_policy_violation_keys 
 , 
  
 ) 
  
 end 
 end 
 def 
  
 create_keyword_criterion 
 ( 
  
 client 
 , 
  
 ad_group_criterion_service 
 , 
  
 customer_id 
 , 
  
 ad_group_id 
 , 
  
 keyword_text 
 ) 
  
 ad_group_criterion_operation 
  
 = 
  
 client 
 . 
 operation 
 . 
 create_resource 
 . 
 ad_group_criterion 
  
 do 
  
 | 
 agc 
 | 
  
 agc 
 . 
 ad_group 
  
 = 
  
 client 
 . 
 path 
 . 
 ad_group 
 ( 
 customer_id 
 , 
  
 ad_group_id 
 ) 
  
 agc 
 . 
 status 
  
 = 
  
 :ENABLED 
  
 agc 
 . 
 keyword 
  
 = 
  
 client 
 . 
 resource 
 . 
 keyword_info 
  
 do 
  
 | 
 ki 
 | 
  
 ki 
 . 
 match_type 
  
 = 
  
 :EXACT 
  
 ki 
 . 
 text 
  
 = 
  
 keyword_text 
  
 end 
  
 end 
  
 ignorable_policy_topics 
  
 = 
  
 [] 
  
 begin 
  
 ad_group_criterion_service 
 . 
 mutate_ad_group_criteria 
 ( 
  
 customer_id 
 : 
  
 customer_id 
 , 
  
 operations 
 : 
  
 [ 
 ad_group_criterion_operation 
 ] 
 , 
  
 ) 
  
 rescue 
  
 Google 
 :: 
 Ads 
 :: 
 GoogleAds 
 :: 
 Errors 
 :: 
 GoogleAdsError 
  
 = 
>  
 e 
  
 return 
  
 e 
 , 
  
 ad_group_criterion_operation 
  
 end 
  
 return 
  
 nil 
 , 
  
 ad_group_criterion_operation 
 end 
 def 
  
 fetch_exempt_policy_violation_keys 
 ( 
 exception 
 ) 
  
 exempt_policy_violation_keys 
  
 = 
  
 [] 
  
 exception 
 . 
 failure 
 . 
 errors 
 . 
 each 
  
 do 
  
 | 
 error 
 | 
  
 details 
  
 = 
  
 error 
 . 
 details 
 . 
 policy_violation_details 
  
 puts 
  
 "Policy violation details:" 
  
 puts 
  
 " 
 \t 
 External policy name: 
 #{ 
 details 
 . 
 external_policy_name 
 } 
 " 
  
 puts 
  
 " 
 \t 
 External policy description: 
 \n 
 #{ 
 details 
 . 
 external_policy_description 
 } 
 " 
  
 puts 
  
 " 
 \t 
 Is exemptible: 
 #{ 
 details 
 . 
 is_exemptible 
 } 
 " 
  
 if 
  
 details 
 . 
 is_exemptible 
 && 
 ! 
 details 
 . 
 key 
 . 
 nil? 
  
 exempt_policy_violation_keys 
 << 
 details 
 . 
 key 
  
 puts 
  
 "Policy violation key:" 
  
 puts 
  
 " 
 \t 
 Policy Name: 
 #{ 
 details 
 . 
 key 
 . 
 policy_name 
 } 
 " 
  
 puts 
  
 " 
 \t 
 Violating Text: 
 #{ 
 details 
 . 
 key 
 . 
 violating_text 
 } 
 " 
  
 else 
  
 puts 
  
 "No exemption request will be sent because your keyword contained " 
 \ 
  
 "some non-exemptible policy violations." 
  
 end 
  
 end 
  
 exempt_policy_violation_keys 
 end 
 def 
  
 request_exemption 
 ( 
  
 client 
 , 
  
 customer_id 
 , 
  
 ad_group_criterion_service 
 , 
  
 ad_group_criterion_operation 
 , 
  
 exempt_policy_violation_keys 
 ) 
  
 # Add all the found ignorable policy topics to the operation. 
  
 ad_group_criterion_operation 
 . 
 exempt_policy_violation_keys 
 . 
 push 
 ( 
  
 * 
 exempt_policy_violation_keys 
  
 ) 
  
 response 
  
 = 
  
 ad_group_criterion_service 
 . 
 mutate_ad_group_criteria 
 ( 
  
 customer_id 
 : 
  
 customer_id 
 , 
  
 operations 
 : 
  
 [ 
 ad_group_criterion_operation 
 ] 
 , 
  
 ) 
  
 puts 
  
 "Successfully added a keyword with resource name " 
  
 \ 
  
 " 
 #{ 
 response 
 . 
 results 
 . 
 first 
 . 
 resource_name 
 } 
 for policy violation exception." 
 end 
 if 
  
 __FILE__ 
  
 == 
  
 $PROGRAM_NAME 
  
 options 
  
 = 
  
 {} 
  
 # The following parameter(s) should be provided to run the example. You can 
  
 # either specify these by changing the INSERT_XXX_ID_HERE values below, or on 
  
 # the command line. 
  
 # 
  
 # Parameters passed on the command line will override any parameters set in 
  
 # code. 
  
 # 
  
 # Running the example with -h will print the command line usage. 
  
 options 
 [ 
 :customer_id 
 ] 
  
 = 
  
 'INSERT_CUSTOMER_ID_HERE' 
  
 options 
 [ 
 :ad_group_id 
 ] 
  
 = 
  
 'INSERT_AD_GROUP_ID_HERE' 
  
 options 
 [ 
 :keyword_text 
 ] 
  
 = 
  
 'INSERT_KEYWORD_TEXT_HERE' 
  
 OptionParser 
 . 
 new 
  
 do 
  
 | 
 opts 
 | 
  
 opts 
 . 
 banner 
  
 = 
  
 sprintf 
 ( 
 'Usage: ruby %s [options]' 
 , 
  
 File 
 . 
 basename 
 ( 
 __FILE__ 
 )) 
  
 opts 
 . 
 separator 
  
 '' 
  
 opts 
 . 
 separator 
  
 'Options:' 
  
 opts 
 . 
 on 
 ( 
 '-C' 
 , 
  
 '--customer-id CUSTOMER-ID' 
 , 
  
 String 
 , 
  
 'Customer ID' 
 ) 
  
 do 
  
 | 
 v 
 | 
  
 options 
 [ 
 :customer_id 
 ] 
  
 = 
  
 v 
  
 end 
  
 opts 
 . 
 on 
 ( 
 '-A' 
 , 
  
 '--ad-group-id AD-GROUP-ID' 
 , 
  
 String 
 , 
  
 'Ad Group ID' 
 ) 
  
 do 
  
 | 
 v 
 | 
  
 options 
 [ 
 :ad_group_id 
 ] 
  
 = 
  
 v 
  
 end 
  
 opts 
 . 
 on 
 ( 
 '-k' 
 , 
  
 '--keyword-text KEYWORD-TEXT' 
 , 
  
 String 
 , 
  
 'Keyword' 
 ) 
  
 do 
  
 | 
 v 
 | 
  
 options 
 [ 
 :keyword_text 
 ] 
  
 = 
  
 v 
  
 end 
  
 opts 
 . 
 separator 
  
 '' 
  
 opts 
 . 
 separator 
  
 'Help:' 
  
 opts 
 . 
 on_tail 
 ( 
 '-h' 
 , 
  
 '--help' 
 , 
  
 'Show this message' 
 ) 
  
 do 
  
 puts 
  
 opts 
  
 exit 
  
 end 
  
 end 
 . 
 parse! 
  
 begin 
  
 handle_keyword_policy_violations 
 ( 
  
 options 
 . 
 fetch 
 ( 
 :customer_id 
 ) 
 . 
 tr 
 ( 
 "-" 
 , 
  
 "" 
 ), 
  
 options 
 . 
 fetch 
 ( 
 :ad_group_id 
 ), 
  
 options 
 . 
 fetch 
 ( 
 :keyword_text 
 ), 
  
 ) 
  
 rescue 
  
 Google 
 :: 
 Ads 
 :: 
 GoogleAds 
 :: 
 Errors 
 :: 
 GoogleAdsError 
  
 = 
>  
 e 
  
 e 
 . 
 failure 
 . 
 errors 
 . 
 each 
  
 do 
  
 | 
 error 
 | 
  
 STDERR 
 . 
 printf 
 ( 
 "Error with message: %s 
 \n 
 " 
 , 
  
 error 
 . 
 message 
 ) 
  
 if 
  
 error 
 . 
 location 
  
 error 
 . 
 location 
 . 
 field_path_elements 
 . 
 each 
  
 do 
  
 | 
 field_path_element 
 | 
  
 STDERR 
 . 
 printf 
 ( 
 " 
 \t 
 On field: %s 
 \n 
 " 
 , 
  
 field_path_element 
 . 
 field_name 
 ) 
  
 end 
  
 end 
  
 error 
 . 
 error_code 
 . 
 to_h 
 . 
 each 
  
 do 
  
 | 
 k 
 , 
  
 v 
 | 
  
 next 
  
 if 
  
 v 
  
 == 
  
 :UNSPECIFIED 
  
 STDERR 
 . 
 printf 
 ( 
 " 
 \t 
 Type: %s 
 \n\t 
 Code: %s 
 \n 
 " 
 , 
  
 k 
 , 
  
 v 
 ) 
  
 end 
  
 end 
  
 raise 
  
 end 
 end 
   handle_keyword_policy_violations 
 . 
 rb

Perl

 #!/usr/bin/perl -w 
 # 
 # Copyright 2019, Google LLC 
 # 
 # Licensed under the Apache License, Version 2.0 (the "License"); 
 # you may not use this file except in compliance with the License. 
 # You may obtain a copy of the License at 
 # 
 #     http://www.apache.org/licenses/LICENSE-2.0 
 # 
 # Unless required by applicable law or agreed to in writing, software 
 # distributed under the License is distributed on an "AS IS" BASIS, 
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 # See the License for the specific language governing permissions and 
 # limitations under the License. 
 # 
 # This example demonstrates how to request an exemption for policy violations 
 # of a keyword. Note that the example uses an exemptible policy-violating 
 # keyword by default. If you use a keyword that contains non-exemptible policy 
 # violations, they will not be sent for exemption request and you will still 
 # fail to create a keyword. 
 # If you specify a keyword that doesn't violate any policies, this example will 
 # just add the keyword as usual, similar to what the add_keywords.pl example does. 
 # 
 # Note that once you've requested policy exemption for a keyword, when you send 
 # a request for adding it again, the request will pass like when you add a 
 # non-violating keyword. 
 use 
  
 strict 
 ; 
 use 
  
 warnings 
 ; 
 use 
  
 utf8 
 ; 
 use 
  
 FindBin 
  
 qw($Bin) 
 ; 
 use 
  
 lib 
  
 "$Bin/../../lib" 
 ; 
 use 
  
 Google::Ads::GoogleAds::Client 
 ; 
 use 
  
 Google::Ads::GoogleAds::Utils::GoogleAdsHelper 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Resources::AdGroupCriterion 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Common::KeywordInfo 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Enums::KeywordMatchTypeEnum 
  
 qw(EXACT) 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Enums::AdGroupCriterionStatusEnum 
  
 qw(ENABLED) 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Services::AdGroupCriterionService::AdGroupCriterionOperation 
 ; 
 use 
  
 Google::Ads::GoogleAds::V21::Utils::ResourceNames 
 ; 
 use 
  
 Getopt::Long 
  
 qw(:config auto_help) 
 ; 
 use 
  
 Pod::Usage 
 ; 
 use 
  
 Cwd 
  
 qw(abs_path) 
 ; 
 # The following parameter(s) should be provided to run the example. You can 
 # either specify these by changing the INSERT_XXX_ID_HERE values below, or on 
 # the command line. 
 # 
 # Parameters passed on the command line will override any parameters set in 
 # code. 
 # 
 # Running the example with -h will print the command line usage. 
 my 
  
 $customer_id 
  
 = 
  
 "INSERT_CUSTOMER_ID_HERE" 
 ; 
 my 
  
 $ad_group_id 
  
 = 
  
 "INSERT_AD_GROUP_ID_HERE" 
 ; 
 my 
  
 $keyword_text 
  
 = 
  
 "medication" 
 ; 
 sub 
  
 handle_keyword_policy_violations 
  
 { 
  
 my 
  
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_id 
 , 
  
 $keyword_text 
 ) 
  
 = 
  
 @_ 
 ; 
  
 # Configure the keyword text and match type settings. 
  
 my 
  
 $keyword_info 
  
 = 
  
 Google::Ads::GoogleAds::V21::Common:: 
 KeywordInfo 
 - 
> new 
 ({ 
  
 text 
  
 = 
>  
 $keyword_text 
 , 
  
 matchType 
  
 = 
>  
 EXACT 
  
 }); 
  
 # Construct an ad group criterion using the keyword info above. 
  
 my 
  
 $ad_group_criterion 
  
 = 
  
 Google::Ads::GoogleAds::V21::Resources:: 
 AdGroupCriterion 
 - 
> new 
 ({ 
  
 adGroup 
  
 = 
>  
 Google::Ads::GoogleAds::V21::Utils::ResourceNames:: 
 ad_group 
 ( 
  
 $customer_id 
 , 
  
 $ad_group_id 
  
 ), 
  
 status 
  
 = 
>  
 ENABLED 
 , 
  
 keyword 
  
 = 
>  
 $keyword_info 
  
 }); 
  
 # Create an ad group criterion operation. 
  
 my 
  
 $ad_group_criterion_operation 
  
 = 
  
 Google::Ads::GoogleAds::V21::Services::AdGroupCriterionService:: 
 AdGroupCriterionOperation 
  
 - 
> new 
 ({ 
 create 
  
 = 
>  
 $ad_group_criterion 
 }); 
  
 # Try sending a mutate request to add the keyword. 
  
 my 
  
 $response 
  
 = 
  
 $api_client 
 - 
> AdGroupCriterionService 
 () 
 - 
> mutate 
 ({ 
  
 customerId 
  
 = 
>  
 $customer_id 
 , 
  
 operations 
  
 = 
>  
 [ 
 $ad_group_criterion_operation 
 ]}); 
  
 if 
  
 ( 
 $response 
 - 
> isa 
 ( 
 "Google::Ads::GoogleAds::GoogleAdsException" 
 )) 
  
 { 
  
 my 
  
 $exempt_policy_violation_keys 
  
 = 
  
 fetch_exempt_policy_violation_keys 
 ( 
 $response 
 ); 
  
 # Try sending exemption requests for creating a keyword. However, if your 
  
 # keyword contains many policy violations, but not all of them are exemptible, 
  
 # the request will not be sent. 
  
 if 
  
 ( 
 @$exempt_policy_violation_keys 
  
 == 
  
 @ 
 { 
 $response 
 - 
> get_google_ads_failure 
 () 
 - 
> { 
 errors 
 }}) 
  
 { 
  
 request_exemption 
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_criterion_operation 
 , 
  
 $exempt_policy_violation_keys 
 ); 
  
 } 
  
 else 
  
 { 
  
 print 
  
 "No exemption request is sent because 1) your keyword contained " 
  
 . 
  
 "some non-exemptible policy violations or 2) there are other " 
  
 . 
  
 "non-policy related errors thrown.\n" 
 ; 
  
 } 
  
 } 
  
 else 
  
 { 
  
 printf 
  
 "Added a keyword with resource name '%s'.\n" 
 , 
  
 $response 
 - 
> { 
 results 
 }[ 
 0 
 ]{ 
 resourceName 
 }; 
  
 } 
  
 return 
  
 1 
 ; 
 } 
 # Collects all policy violation keys that can be exempted for sending a exemption 
 # request later. 
 sub 
  
 fetch_exempt_policy_violation_keys 
  
 { 
  
 my 
  
 $google_ads_exception 
  
 = 
  
 shift 
 ; 
  
 my 
  
 $exempt_policy_violation_keys 
  
 = 
  
 [] 
 ; 
  
 print 
  
 "Google Ads failure details:\n" 
 ; 
  
 foreach 
  
 my 
  
 $error 
  
 ( 
 @ 
 { 
 $google_ads_exception 
 - 
> get_google_ads_failure 
 () 
 - 
> { 
 errors 
 }}) 
  
 { 
  
 printf 
  
 "\t%s: %s\n" 
 , 
  
 [ 
 keys 
  
 % 
 { 
 $error 
 - 
> { 
 errorCode 
 }}] 
 - 
> [ 
 0 
 ], 
  
 $error 
 - 
> { 
 message 
 }; 
  
 if 
  
 ( 
 $error 
 - 
> { 
 details 
 }{ 
 policyViolationDetails 
 }) 
  
 { 
  
 my 
  
 $policy_violation_details 
  
 = 
  
 $error 
 - 
> { 
 details 
 }{ 
 policyViolationDetails 
 }; 
  
 printf 
  
 "\tPolicy violation details:\n" 
 ; 
  
 printf 
  
 "\t\tExternal policy name: '%s'\n" 
 , 
  
 $policy_violation_details 
 - 
> { 
 externalPolicyName 
 }; 
  
 printf 
  
 "\t\tExternal policy description: '%s'\n" 
 , 
  
 $policy_violation_details 
 - 
> { 
 externalPolicyDescription 
 }; 
  
 printf 
  
 "\t\tIs exemptible? '%s'\n" 
 , 
  
 $policy_violation_details 
 - 
> { 
 isExemptible 
 } 
  
 ? 
  
 "yes" 
  
 : 
  
 "no" 
 ; 
  
 if 
  
 ( 
  
 $policy_violation_details 
 - 
> { 
 isExemptible 
 } 
  
 and 
  
 $policy_violation_details 
 - 
> { 
 key 
 }) 
  
 { 
  
 my 
  
 $policy_violation_details_key 
  
 = 
  
 $policy_violation_details 
 - 
> { 
 key 
 }; 
  
 push 
  
 @$exempt_policy_violation_keys 
 , 
  
 $policy_violation_details_key 
 ; 
  
 printf 
  
 "\t\tPolicy violation key:\n" 
 ; 
  
 printf 
  
 "\t\t\tName: '%s'\n" 
 , 
  
 $policy_violation_details_key 
 - 
> { 
 policyName 
 }; 
  
 printf 
  
 "\t\t\tViolating text: '%s'\n" 
 , 
  
 $policy_violation_details_key 
 - 
> { 
 violatingText 
 }; 
  
 } 
  
 } 
  
 } 
  
 return 
  
 $exempt_policy_violation_keys 
 ; 
 } 
 # Sends exemption requests for creating a keyword. 
 sub 
  
 request_exemption 
  
 { 
  
 my 
  
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_criterion_operation 
 , 
  
 $exempt_policy_violation_keys 
 ) 
  
 = 
  
 @_ 
 ; 
  
 print 
  
 "Try adding a keyword again by requesting exemption for its " 
  
 . 
  
 "policy violations.\n" 
 ; 
  
 $ad_group_criterion_operation 
 - 
> { 
 exemptPolicyViolationKeys 
 } 
  
 = 
  
 $exempt_policy_violation_keys 
 ; 
  
 my 
  
 $ad_group_criteria_response 
  
 = 
  
 $api_client 
 - 
> AdGroupCriterionService 
 () 
 - 
> mutate 
 ({ 
  
 customerId 
  
 = 
>  
 $customer_id 
 , 
  
 operations 
  
 = 
>  
 [ 
 $ad_group_criterion_operation 
 ]}); 
  
 printf 
  
 "Successfully added a keyword with resource name '%s' by requesting " 
  
 . 
  
 "for policy violation exemption.\n" 
 , 
  
 $ad_group_criteria_response 
 - 
> { 
 results 
 }[ 
 0 
 ]{ 
 resourceName 
 }; 
 } 
 # Don't run the example if the file is being included. 
 if 
  
 ( 
 abs_path 
 ( 
 $0 
 ) 
  
 ne 
  
 abs_path 
 ( 
 __FILE__ 
 )) 
  
 { 
  
 return 
  
 1 
 ; 
 } 
 # Get Google Ads Client, credentials will be read from ~/googleads.properties. 
 my 
  
 $api_client 
  
 = 
  
 Google::Ads::GoogleAds:: 
 Client 
 - 
> new 
 (); 
 # By default examples are set to die on any server returned fault. 
 $api_client 
 - 
> set_die_on_faults 
 ( 
 0 
 ); 
 # Parameters passed on the command line will override any parameters set in code. 
 GetOptions 
 ( 
  
 "customer_id=s" 
  
 = 
>  
 \ 
 $customer_id 
 , 
  
 "ad_group_id=i" 
  
 = 
>  
 \ 
 $ad_group_id 
 , 
  
 "keyword_text=s" 
  
 = 
>  
 \ 
 $keyword_text 
 ); 
 # Print the help message if the parameters are not initialized in the code nor 
 # in the command line. 
 pod2usage 
 ( 
 2 
 ) 
  
 if 
  
 not 
  
 check_params 
 ( 
 $customer_id 
 , 
  
 $ad_group_id 
 , 
  
 $keyword_text 
 ); 
 # Call the example. 
 handle_keyword_policy_violations 
 ( 
 $api_client 
 , 
  
 $customer_id 
  
 =~ 
  
 s/-//g 
 r 
 , 
  
 $ad_group_id 
 , 
  
 $keyword_text 
 ); 
 =pod 
 =head1 NAME 
 handle_keyword_policy_violations 
 =head1 DESCRIPTION 
 This example demonstrates how to request an exemption for policy violations of a keyword. 
 Note that the example uses an exemptible policy-violating keyword by default. If you use 
 a keyword that contains non-exemptible policy violations, they will not be sent for 
 exemption request and you will still fail to create a keyword. 
 If you specify a keyword that doesn't violate any policies, this example will just add the 
 keyword as usual, similar to what the add_keywords.pl example does. 
 Note that once you've requested policy exemption for a keyword, when you send a request for 
 adding it again, the request will pass like when you add a non-violating keyword. 
 =head1 SYNOPSIS 
 handle_keyword_policy_violations.pl [options] 
 -help                       Show the help message. 
 -customer_id                The Google Ads customer ID. 
 -ad_group_id                The ad group ID. 
 -keyword_text               [optional] The keyword to be added to the ad group. 
 =cut 
   handle_keyword_policy_violations 
 . 
 pl

Ads

Policy Exemption Requests Stay organized with collections Save and categorize content based on your preferences.

Code examples

Handle ad policy violations

Java

C#

PHP

Python

Ruby

Perl

Handle keyword policy violations

Java

C#

PHP

Python

Ruby

Perl

Policy Exemption Requests