Manage creatives for buyers

POST https://realtimebidding.googleapis.com/v1/buyers/<INSERT_ACCOUNT_ID_HERE>/creatives?alt=json
Authorization: Bearer <INSERT_ACCESS_TOKEN_HERE>
Content-Type: application/json
 
{
  "advertiserName": "Test",
  "creativeId": "HTML_Creative_d71e7cd9-8179-4683-ac5c-a203a9c660f2",
  "declaredAttributes": [
    "CREATIVE_TYPE_HTML"
  ],
  "declaredClickThroughUrls": [
    "http://test.com"
  ],
  "declaredRestrictedCategories": [],
  "declaredVendorIds": [],
  "html": {
    "snippet": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
    "height": 250,
    "width": 300
  }
}

{
  "name": "buyers/<ACCOUNT_ID>/creatives/HTML_Creative_d71e7cd9-8179-4683-ac5c-a203a9c660f2",
  "accountId": "<ACCOUNT_ID>",
  "creativeId": "HTML_Creative_d71e7cd9-8179-4683-ac5c-a203a9c660f2",
  "html": {
    "snippet": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
    "width": 300,
    "height": 250
  },
  "creativeFormat": "HTML",
  "declaredClickThroughUrls": [
    "http://test.com"
  ],
  "declaredAttributes": [
    "CREATIVE_TYPE_HTML"
  ],
  "advertiserName": "Test",
  "version": 1,
  "apiUpdateTime": "2020-08-06T23:49:52.630384Z",
  "creativeServingDecision": {
    "lastStatusUpdate": "2020-08-06T23:49:52.710Z",
    "dealsPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "networkPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "platformPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "chinaPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "russiaPolicyCompliance": {
      "status": "PENDING_REVIEW"
    }
  }
}

 /* 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 
  
 Google.Apis.RealTimeBidding.v1 
 ; 
 using 
  
 Google.Apis.RealTimeBidding.v1.Data 
 ; 
 using 
  
 Mono.Options 
 ; 
 using 
  
 System 
 ; 
 using 
  
 System.Collections.Generic 
 ; 
 namespace 
  
 Google.Apis.RealTimeBidding.Examples.v1.Buyers.Creatives 
 { 
  
 /// <summary> 
  
 /// Creates a creative with HTML content for the given buyer account ID. 
  
 /// </summary> 
  
 public 
  
 class 
  
 CreateHtmlCreatives 
  
 : 
  
 ExampleBase 
  
 { 
  
 private 
  
 RealTimeBiddingService 
  
 rtbService 
 ; 
  
 /// <summary> 
  
 /// Constructor. 
  
 /// </summary> 
  
 public 
  
 CreateHtmlCreatives 
 () 
  
 { 
  
 rtbService 
  
 = 
  
 Utilities 
 . 
 GetRealTimeBiddingService 
 (); 
  
 } 
  
 /// <summary> 
  
 /// Returns a description about the code example. 
  
 /// </summary> 
  
 public 
  
 override 
  
 string 
  
 Description 
  
 { 
  
 get 
  
 = 
>  
 "This code example creates a creative with HTML content for the given buyer " 
  
 + 
  
 "account ID." 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Parse specified arguments. 
  
 /// </summary> 
  
 protected 
  
 override 
  
 Dictionary<string 
 , 
  
 object 
>  
 ParseArguments 
 ( 
 List<string> 
  
 exampleArgs 
 ) 
  
 { 
  
 string 
 [] 
  
 requiredOptions 
  
 = 
  
 new 
  
 string 
 [] 
  
 { 
 "account_id" 
 }; 
  
 bool 
  
 showHelp 
  
 = 
  
 false 
 ; 
  
 string 
  
 accountId 
  
 = 
  
 null 
 ; 
  
 string 
  
 advertiserName 
  
 = 
  
 null 
 ; 
  
 string 
  
 creativeId 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 declaredAttributes 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<string> 
  
 declaredClickUrls 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<string> 
  
 declaredRestrictedCategories 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<int 
 ? 
>  
 declaredVendorIds 
  
 = 
  
 new 
  
 List<int 
 ? 
> (); 
  
 string 
  
 htmlSnippet 
  
 = 
  
 null 
 ; 
  
 int? 
  
 htmlHeight 
  
 = 
  
 null 
 ; 
  
 int? 
  
 htmlWidth 
  
 = 
  
 null 
 ; 
  
 var 
  
 defaultHtmlSnippet 
  
 = 
  
 "<iframe marginwidth=0 marginheight=0 height=600 " 
  
 + 
  
 "frameborder=0 width=160 scrolling=no " 
  
 + 
  
 @"src=""https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%" 
  
 + 
  
 @"&wprice=%%WINNING_PRICE_ESC%%""></iframe>" 
 ; 
  
 OptionSet 
  
 options 
  
 = 
  
 new 
  
 OptionSet 
  
 { 
  
 "Creates a creative with HTML content for the given buyer account ID." 
 , 
  
 { 
  
 "h|help" 
 , 
  
 "Show help message and exit." 
 , 
  
 h 
  
 = 
>  
 showHelp 
  
 = 
  
 h 
  
 != 
  
 null 
  
 }, 
  
 { 
  
 "a|account_id=" 
 , 
  
 ( 
 "[Required] The resource ID of the buyers resource under which the " 
  
 + 
  
 "creatives were created. This will be used to construct the name used as " 
  
 + 
  
 "a path parameter for the creatives.get request." 
 ), 
  
 a 
  
 = 
>  
 accountId 
  
 = 
  
 a 
  
 }, 
  
 { 
  
 "advertiser_name=" 
 , 
  
 "The name of the company being advertised in the creative." 
 , 
  
 advertiser_name 
  
 = 
>  
 advertiserName 
  
 = 
  
 advertiser_name 
  
 }, 
  
 { 
  
 "c|creative_id=" 
 , 
  
 ( 
 "The user-specified creative ID. The maximum length of the creative ID is " 
  
 + 
  
 "128 bytes." 
 ), 
  
 c 
  
 = 
>  
 creativeId 
  
 = 
  
 c 
  
 }, 
  
 { 
  
 "declared_attributes=" 
 , 
  
 ( 
 "The creative attributes being declared. Specify this argument for each " 
  
 + 
  
 "value you intend to include." 
 ), 
  
 declared_attributes 
  
 = 
>  
 declaredAttributes 
 . 
 Add 
 ( 
 declared_attributes 
 ) 
  
 }, 
  
 { 
  
 "declared_click_urls=" 
 , 
  
 ( 
 "The click-through URLs being declared. Specify this argument for each " 
  
 + 
  
 "value you intend to include." 
 ), 
  
 declared_click_through_urls 
  
 = 
>  
 declaredClickUrls 
 . 
 Add 
 ( 
  
 declared_click_through_urls 
 ) 
  
 }, 
  
 { 
  
 "declared_restricted_categories=" 
 , 
  
 ( 
 "The restricted categories being declared. Specify this argument for each " 
  
 + 
  
 "value you intend to include." 
 ), 
  
 declared_restricted_categories 
  
 = 
>  
 declaredRestrictedCategories 
 . 
 Add 
 ( 
  
 declared_restricted_categories 
 ) 
  
 }, 
  
 { 
  
 "declared_vendor_ids=" 
 , 
  
 ( 
 "The vendor IDs being declared. Specify this argument for each value you " 
  
 + 
  
 "intend to include." 
 ), 
  
 ( 
 int 
  
 declared_vendor_ids 
 ) 
  
 = 
>  
 declaredVendorIds 
 . 
 Add 
 ( 
 declared_vendor_ids 
 ) 
  
 }, 
  
 { 
  
 "html_snippet=" 
 , 
  
 "The HTML snippet that displays the ad when inserted in the web page." 
 , 
  
 html_snippet 
  
 = 
>  
 htmlSnippet 
  
 = 
  
 html_snippet 
  
 }, 
  
 { 
  
 "html_height=" 
 , 
  
 "The height of the HTML snippet in pixels." 
 , 
  
 ( 
 int 
  
 html_height 
 ) 
  
 = 
>  
 htmlHeight 
  
 = 
  
 html_height 
  
 }, 
  
 { 
  
 "html_width=" 
 , 
  
 "The width of the HTML snippet in pixels." 
 , 
  
 ( 
 int 
  
 html_width 
 ) 
  
 = 
>  
 htmlWidth 
  
 = 
  
 html_width 
  
 }, 
  
 }; 
  
 List<string> 
  
 extras 
  
 = 
  
 options 
 . 
 Parse 
 ( 
 exampleArgs 
 ); 
  
 var 
  
 parsedArgs 
  
 = 
  
 new 
  
 Dictionary<string 
 , 
  
 object 
> (); 
  
 // Show help message. 
  
 if 
 ( 
 showHelp 
  
 == 
  
 true 
 ) 
  
 { 
  
 options 
 . 
 WriteOptionDescriptions 
 ( 
 Console 
 . 
 Out 
 ); 
  
 Environment 
 . 
 Exit 
 ( 
 0 
 ); 
  
 } 
  
 // Set arguments. 
  
 parsedArgs 
 [ 
 "account_id" 
 ] 
  
 = 
  
 accountId 
 ; 
  
 parsedArgs 
 [ 
 "advertiser_name" 
 ] 
  
 = 
  
 advertiserName 
  
 ?? 
  
 "Test" 
 ; 
  
 parsedArgs 
 [ 
 "creative_id" 
 ] 
  
 = 
  
 creativeId 
  
 ?? 
  
 String 
 . 
 Format 
 ( 
  
 "HTML_Creative_{0}" 
 , 
  
 System 
 . 
 Guid 
 . 
 NewGuid 
 ()); 
  
 if 
  
 ( 
 declaredAttributes 
 . 
 Count 
  
 == 
  
 0 
 ) 
  
 { 
  
 declaredAttributes 
 . 
 Add 
 ( 
 "CREATIVE_TYPE_HTML" 
 ); 
  
 } 
  
 parsedArgs 
 [ 
 "declared_attributes" 
 ] 
  
 = 
  
 declaredAttributes 
 ; 
  
 if 
  
 ( 
 declaredClickUrls 
 . 
 Count 
  
 == 
  
 0 
 ) 
  
 { 
  
 declaredClickUrls 
 . 
 Add 
 ( 
 "http://test.com" 
 ); 
  
 } 
  
 parsedArgs 
 [ 
 "declared_click_urls" 
 ] 
  
 = 
  
 declaredClickUrls 
 ; 
  
 parsedArgs 
 [ 
 "declared_restricted_categories" 
 ] 
  
 = 
  
 declaredRestrictedCategories 
 ; 
  
 parsedArgs 
 [ 
 "declared_vendor_ids" 
 ] 
  
 = 
  
 declaredVendorIds 
 ; 
  
 parsedArgs 
 [ 
 "html_snippet" 
 ] 
  
 = 
  
 htmlSnippet 
  
 ?? 
  
 defaultHtmlSnippet 
 ; 
  
 parsedArgs 
 [ 
 "html_height" 
 ] 
  
 = 
  
 htmlHeight 
  
 ?? 
  
 250 
 ; 
  
 parsedArgs 
 [ 
 "html_width" 
 ] 
  
 = 
  
 htmlWidth 
  
 ?? 
  
 300 
 ; 
  
 // Validate that options were set correctly. 
  
 Utilities 
 . 
 ValidateOptions 
 ( 
 options 
 , 
  
 parsedArgs 
 , 
  
 requiredOptions 
 , 
  
 extras 
 ); 
  
 return 
  
 parsedArgs 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Run the example. 
  
 /// </summary> 
  
 /// <param name="parsedArgs">Parsed arguments for the example.</param> 
  
 protected 
  
 override 
  
 void 
  
 Run 
 ( 
 Dictionary<string 
 , 
  
 object 
>  
 parsedArgs 
 ) 
  
 { 
  
 string 
  
 accountId 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "account_id" 
 ]; 
  
 string 
  
 parent 
  
 = 
  
 $"buyers/{accountId}" 
 ; 
  
 HtmlContent 
  
 htmlContent 
  
 = 
  
 new 
  
 HtmlContent 
 (); 
  
 htmlContent 
 . 
 Snippet 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "html_snippet" 
 ]; 
  
 htmlContent 
 . 
 Height 
  
 = 
  
 ( 
 int 
 ) 
  
 parsedArgs 
 [ 
 "html_height" 
 ]; 
  
 htmlContent 
 . 
 Width 
  
 = 
  
 ( 
 int 
 ) 
  
 parsedArgs 
 [ 
 "html_width" 
 ]; 
  
 Creative 
  
 newCreative 
  
 = 
  
 new 
  
 Creative 
 (); 
  
 newCreative 
 . 
 AdvertiserName 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "advertiser_name" 
 ]; 
  
 newCreative 
 . 
 CreativeId 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "creative_id" 
 ]; 
  
 newCreative 
 . 
 DeclaredAttributes 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "declared_attributes" 
 ]; 
  
 newCreative 
 . 
 DeclaredClickThroughUrls 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
  
 "declared_click_urls" 
 ]; 
  
 newCreative 
 . 
 DeclaredRestrictedCategories 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
  
 "declared_restricted_categories" 
 ]; 
  
 newCreative 
 . 
 DeclaredVendorIds 
  
 = 
  
 ( 
 IList<int 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "declared_vendor_ids" 
 ]; 
  
 newCreative 
 . 
 Html 
  
 = 
  
 htmlContent 
 ; 
  
 BuyersResource 
 . 
 CreativesResource 
 . 
 CreateRequest 
  
 request 
  
 = 
  
 rtbService 
 . 
 Buyers 
 . 
 Creatives 
 . 
 Create 
 ( 
 newCreative 
 , 
  
 parent 
 ); 
  
 Creative 
  
 response 
  
 = 
  
 null 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 "Creating HTML creative for buyer: {0}" 
 , 
  
 parent 
 ); 
  
 try 
  
 { 
  
 response 
  
 = 
  
 request 
 . 
 Execute 
 (); 
  
 } 
  
 catch 
  
 ( 
 System 
 . 
 Exception 
  
 exception 
 ) 
  
 { 
  
 throw 
  
 new 
  
 ApplicationException 
 ( 
  
 $"Real-time Bidding API returned error response:\n{exception.Message}" 
 ); 
  
 } 
  
 Utilities 
 . 
 PrintCreative 
 ( 
 response 
 ); 
  
 } 
  
 } 
 } 

 /* 
 * 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.api.services.samples.authorizedbuyers.realtimebidding.v1.buyers.creatives 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.RealTimeBidding 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.Creative 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.HtmlContent 
 ; 
 import 
  
 com.google.api.services.samples.authorizedbuyers.realtimebidding.Utils 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.security.GeneralSecurityException 
 ; 
 import 
  
 java.util.Collections 
 ; 
 import 
  
 java.util.UUID 
 ; 
 import 
  
 net.sourceforge.argparse4j.ArgumentParsers 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.ArgumentParser 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.ArgumentParserException 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.Namespace 
 ; 
 /** Creates a creative with HTML content for the given buyer account ID. */ 
 public 
  
 class 
 CreateHtmlCreatives 
  
 { 
  
 public 
  
 static 
  
 void 
  
 execute 
 ( 
 RealTimeBidding 
  
 client 
 , 
  
 Namespace 
  
 parsedArgs 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 Long 
  
 accountId 
  
 = 
  
 parsedArgs 
 . 
 getLong 
 ( 
 "account_id" 
 ); 
  
 String 
  
 parentBuyerName 
  
 = 
  
 String 
 . 
 format 
 ( 
 "buyers/%s" 
 , 
  
 accountId 
 ); 
  
 HtmlContent 
  
 htmlContent 
  
 = 
  
 new 
  
 HtmlContent 
 (); 
  
 htmlContent 
 . 
 setSnippet 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "html_snippet" 
 )); 
  
 htmlContent 
 . 
 setHeight 
 ( 
 parsedArgs 
 . 
 getInt 
 ( 
 "html_height" 
 )); 
  
 htmlContent 
 . 
 setWidth 
 ( 
 parsedArgs 
 . 
 getInt 
 ( 
 "html_width" 
 )); 
  
 Creative 
  
 newCreative 
  
 = 
  
 new 
  
 Creative 
 (); 
  
 newCreative 
 . 
 setAdvertiserName 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "advertiser_name" 
 )); 
  
 newCreative 
 . 
 setCreativeId 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "creative_id" 
 )); 
  
 newCreative 
 . 
 setDeclaredAttributes 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "declared_attributes" 
 )); 
  
 newCreative 
 . 
 setDeclaredClickThroughUrls 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "declared_click_urls" 
 )); 
  
 newCreative 
 . 
 setDeclaredRestrictedCategories 
 ( 
  
 parsedArgs 
 . 
< String>getList 
 ( 
 "declared_restricted_categories" 
 )); 
  
 newCreative 
 . 
 setDeclaredVendorIds 
 ( 
 parsedArgs 
 . 
< Integer>getList 
 ( 
 "declared_vendor_ids" 
 )); 
  
 newCreative 
 . 
 setHtml 
 ( 
 htmlContent 
 ); 
  
 Creative 
  
 creative 
  
 = 
  
 client 
 . 
 buyers 
 (). 
 creatives 
 (). 
 create 
 ( 
 parentBuyerName 
 , 
  
 newCreative 
 ). 
 execute 
 (); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Created creative for buyer Account ID '%s':\n" 
 , 
  
 accountId 
 ); 
  
 Utils 
 . 
 printCreative 
 ( 
 creative 
 ); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 { 
  
 ArgumentParser 
  
 parser 
  
 = 
  
 ArgumentParsers 
 . 
 newFor 
 ( 
 "CreateHtmlCreatives" 
 ) 
  
 . 
 build 
 () 
  
 . 
 defaultHelp 
 ( 
 true 
 ) 
  
 . 
 description 
 (( 
 "Creates an HTML creative for the given buyer account ID." 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "-a" 
 , 
  
 "--account_id" 
 ) 
  
 . 
 help 
 ( 
 "The resource ID of the buyers resource under which the creative is to be created. " 
 ) 
  
 . 
 required 
 ( 
 true 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--advertiser_name" 
 ) 
  
 . 
 help 
 ( 
 "The name of the company being advertised in the creative." 
 ) 
  
 . 
 setDefault 
 ( 
 "Test" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "-c" 
 , 
  
 "--creative_id" 
 ) 
  
 . 
 help 
 ( 
 "The user-specified creative ID. The maximum length of the creative ID is 128 bytes." 
 ) 
  
 . 
 setDefault 
 ( 
 String 
 . 
 format 
 ( 
 "HTML_Creative_%s" 
 , 
  
 UUID 
 . 
 randomUUID 
 ())); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_attributes" 
 ) 
  
 . 
 help 
 ( 
  
 "The creative attributes being declared. Specify each attribute separated by a " 
  
 + 
  
 "space." 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ) 
  
 . 
 setDefault 
 ( 
 Collections 
 . 
 singletonList 
 ( 
 "CREATIVE_TYPE_HTML" 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_click_urls" 
 ) 
  
 . 
 help 
 ( 
 "The click-through URLs being declared. Specify each URL separated by a space." 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ) 
  
 . 
 setDefault 
 ( 
 Collections 
 . 
 singletonList 
 ( 
 "http://test.com" 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_restricted_categories" 
 ) 
  
 . 
 help 
 ( 
  
 "The restricted categories being declared. Specify each category separated by a " 
  
 + 
  
 "space." 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_vendor_ids" 
 ) 
  
 . 
 help 
 ( 
 "The vendor IDs being declared. Specify each ID separated by a space." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--html_snippet" 
 ) 
  
 . 
 help 
 ( 
 "The HTML snippet that displays the ad when inserted in the web page." 
 ) 
  
 . 
 setDefault 
 ( 
  
 "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 " 
  
 + 
  
 "scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%" 
  
 + 
  
 "&wprice=%%WINNING_PRICE_ESC%%\"></iframe>" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--html_height" 
 ) 
  
 . 
 help 
 ( 
 "The height of the HTML snippet in pixels." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 250 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--html_width" 
 ) 
  
 . 
 help 
 ( 
 "The width of the HTML snippet in pixels." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 300 
 ); 
  
 Namespace 
  
 parsedArgs 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 parsedArgs 
  
 = 
  
 parser 
 . 
 parseArgs 
 ( 
 args 
 ); 
  
 } 
  
 catch 
  
 ( 
 ArgumentParserException 
  
 ex 
 ) 
  
 { 
  
 parser 
 . 
 handleError 
 ( 
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 RealTimeBidding 
  
 client 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 client 
  
 = 
  
 Utils 
 . 
 getRealTimeBiddingClient 
 (); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Unable to create RealTimeBidding API service:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "Did you specify a valid path to a service account key file?" 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 catch 
  
 ( 
 GeneralSecurityException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Unable to establish secure HttpTransport:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 try 
  
 { 
  
 execute 
 ( 
 client 
 , 
  
 parsedArgs 
 ); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "RealTimeBidding API returned error response:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 } 
 } 

< ?php 
 /** 
 * 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. 
 */ 
 namespace Google\Ads\AuthorizedBuyers\RealTimeBidding\Examples\V1\Buyers_Creatives; 
 use Google\Ads\AuthorizedBuyers\RealTimeBidding\ExampleUtil\BaseExample; 
 use Google\Ads\AuthorizedBuyers\RealTimeBidding\ExampleUtil\Config; 
 use Google_Service_RealTimeBidding_Creative; 
 use Google_Service_RealTimeBidding_HtmlContent; 
 /** 
 * This example illustrates how to create HTML creatives for a given buyer account. 
 */ 
 class CreateHtmlCreatives extends BaseExample 
 { 
 public function __construct($client) 
 { 
 $this->service = Config::getGoogleServiceRealTimeBidding($client); 
 } 
 /** 
 * @see BaseExample::getInputParameters() 
 */ 
 protected function getInputParameters() 
 { 
 return [ 
 [ 
 'name' => 'account_id', 
 'display' => 'Account ID', 
 'description' = 
> 'The resource ID of the buyers resource under which the creative is to be ' . 
 'created.', 
 'required' => true 
 ], 
 [ 
 'name' => 'advertiser_name', 
 'display' => 'Advertiser name', 
 'description' => 'The name of the company being advertised in the creative.', 
 'required' => false, 
 'default' => 'Test' 
 ], 
 [ 
 'name' => 'creative_id', 
 'display' => 'Creative ID', 
 'description' = 
> 'The user-specified creative ID. The maximum length of the creative ID is ' . 
 '128 bytes', 
 'required' => false, 
 'default' => 'HTML_Creative_' . uniqid() 
 ], 
 [ 
 'name' => 'declared_attributes', 
 'display' => 'Declared attributes', 
 'description' = 
> 'The creative attributes being declared. Specify each attribute separated ' . 
 'by a comma.', 
 'required' => false, 
 'is_array' => true, 
 'default' => ['CREATIVE_TYPE_HTML'] 
 ], 
 [ 
 'name' => 'declared_click_urls', 
 'display' => 'Declared click URLs', 
 'description' = 
> 'The click-through URLs being declared. Specify each URL separated by a ' . 
 'comma.', 
 'required' => false, 
 'is_array' => true, 
 'default' => ['http://test.com'] 
 ], 
 [ 
 'name' => 'declared_restricted_categories', 
 'display' => 'Declared restricted categories', 
 'description' = 
> 'The restricted categories being declared. Specify each category separated ' . 
 'by a comma.', 
 'required' => false, 
 'is_array' => true 
 ], 
 [ 
 'name' => 'declared_vendor_ids', 
 'display' => 'Declared vendor IDs', 
 'description' = 
> 'The vendor IDs being declared. Specify each ID separated by a comma.', 
 'required' => false, 
 'is_array' => true 
 ], 
 [ 
 'name' => 'html_snippet', 
 'display' => 'HTML snippet', 
 'description' = 
> 'The HTML snippet that displays the ad when inserted in the web page.', 
 'required' => false, 
 'default' = 
> '<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 ' . 
 'scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%' . 
 '&wprice=%%WINNING_PRICE_ESC%%\"></iframe>' 
 ], 
 [ 
 'name' => 'html_height', 
 'display' => 'Height', 
 'description' => 'The height of the HTML snippet in pixels.', 
 'required' => false, 
 'default' => 250 
 ], 
 [ 
 'name' => 'html_width', 
 'display' => 'Width', 
 'description' => 'The width of the HTML snippet in pixels.', 
 'required' => false, 
 'default' => 300 
 ] 
 ]; 
 } 
 /** 
 * @see BaseExample::run() 
 */ 
 public function run() 
 { 
 $values = $this->formValues; 
 $parentName = "buyers/$values[account_id]"; 
 $html = new Google_Service_RealTimeBidding_HtmlContent(); 
 $html->snippet = $values['html_snippet']; 
 $html->height = $values['html_height']; 
 $html->width = $values['html_width']; 
 $newCreative = new Google_Service_RealTimeBidding_Creative(); 
 $newCreative->advertiserName = $values['advertiser_name']; 
 $newCreative->creativeId = $values['creative_id']; 
 $newCreative->declaredAttributes = $values['declared_attributes']; 
 $newCreative->declaredClickThroughUrls = $values['declared_click_urls']; 
 $newCreative->declaredRestrictedCategories = $values['declared_restricted_categories']; 
 $newCreative->declaredVendorIds = $values['declared_vendor_ids']; 
 $newCreative->setHtml($html); 
 print "<h2>Creating Creative for '$parentName':</h2>"; 
 $result = $this->service->buyers_creatives->create($parentName, $newCreative); 
 $this->printResult($result); 
 } 
 /** 
 * @see BaseExample::getName() 
 */ 
 public function getName() 
 { 
 return 'Create Buyer HTML Creative'; 
 } 
 } 

 #!/usr/bin/python 
 # 
 # Copyright 2020 Google Inc. All Rights Reserved. 
 # 
 # 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. 
 """Creates a creative with HTML content for the given buyer account ID.""" 
 import 
  
 argparse 
 import 
  
 datetime 
 import 
  
 os 
 import 
  
 pprint 
 import 
  
 sys 
 import 
  
 uuid 
 sys 
 . 
 path 
 . 
 insert 
 ( 
 0 
 , 
 os 
 . 
 path 
 . 
 abspath 
 ( 
 '../../..' 
 )) 
 from 
  
 googleapiclient.errors 
  
 import 
 HttpError 
 import 
  
 util 
 _BUYER_NAME_TEMPLATE 
 = 
 'buyers/ 
 %s 
 ' 
 DEFAULT_BUYER_RESOURCE_ID 
 = 
 'ENTER_BUYER_RESOURCE_ID_HERE' 
 def 
  
 main 
 ( 
 realtimebidding 
 , 
 args 
 ): 
 account_id 
 = 
 args 
 . 
 account_id 
 creative 
 = 
 { 
 'advertiserName' 
 : 
 args 
 . 
 advertiser_name 
 , 
 'creativeId' 
 : 
 args 
 . 
 creative_id 
 , 
 'declaredAttributes' 
 : 
 args 
 . 
 declared_attributes 
 , 
 'declaredClickThroughUrls' 
 : 
 args 
 . 
 declared_click_urls 
 , 
 'declaredRestrictedCategories' 
 : 
 args 
 . 
 declared_restricted_categories 
 , 
 'declaredVendorIds' 
 : 
 [ 
 int 
 ( 
 id 
 ) 
 for 
 id 
 in 
 args 
 . 
 declared_vendor_ids 
 ], 
 'html' 
 : 
 { 
 'snippet' 
 : 
 args 
 . 
 html_snippet 
 , 
 'height' 
 : 
 args 
 . 
 html_height 
 , 
 'width' 
 : 
 args 
 . 
 html_width 
 } 
 } 
 print 
 ( 
 f 
 'Creating HTML creative for buyer account ID " 
 { 
 account_id 
 } 
 ":' 
 ) 
 try 
 : 
 # Construct and execute the request. 
 response 
 = 
 ( 
 realtimebidding 
 . 
 buyers 
 () 
 . 
 creatives 
 () 
 . 
 create 
 ( 
 parent 
 = 
 _BUYER_NAME_TEMPLATE 
 % 
 account_id 
 , 
 body 
 = 
 creative 
 ) 
 . 
 execute 
 ()) 
 except 
 HttpError 
 as 
 e 
 : 
 print 
 ( 
 e 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 pprint 
 . 
 pprint 
 ( 
 response 
 ) 
 if 
 __name__ 
 == 
 '__main__' 
 : 
 try 
 : 
 service 
 = 
 util 
 . 
 GetService 
 ( 
 version 
 = 
 'v1' 
 ) 
 except 
 IOError 
 as 
 ex 
 : 
 print 
 ( 
 f 
 'Unable to create realtimebidding service - 
 { 
 ex 
 } 
 ' 
 ) 
 print 
 ( 
 'Did you specify the key file in util.py?' 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 default_snippet_content 
 = 
 ( 
 '<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 ' 
 'width=160 scrolling=no src= 
 \" 
 https://test.com/ads?id=123456' 
 '&curl= 
 %% 
 CLICK_URL_ESC 
 %% 
& wprice= 
 %% 
 WINNING_PRICE_ESC 
 %% 
 \" 
>< /iframe>' 
 ) 
 parser 
 = 
 argparse 
 . 
 ArgumentParser 
 ( 
 description 
 = 
 ( 
 'Creates an HTML creative for the given buyer account ID.' 
 )) 
 # Required fields. 
 parser 
 . 
 add_argument 
 ( 
 '-a' 
 , 
 '--account_id' 
 , 
 default 
 = 
 DEFAULT_BUYER_RESOURCE_ID 
 , 
 help 
 = 
 ( 
 'The resource ID of the buyers resource under which the ' 
 'creative is to be created.' 
 )) 
 # Optional fields. 
 parser 
 . 
 add_argument 
 ( 
 '--advertiser_name' 
 , 
 default 
 = 
 'Test' 
 , 
 help 
 = 
 'The name of the company being advertised in the creative.' 
 ) 
 parser 
 . 
 add_argument 
 ( 
 '-c' 
 , 
 '--creative_id' 
 , 
 default 
 = 
 'HTML_Creative_ 
 %s 
 ' 
 % 
 uuid 
 . 
 uuid4 
 (), 
 help 
 = 
 ( 
 'The user-specified creative ID. The maximum length of the ' 
 'creative ID is 128 bytes.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_attributes' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [ 
 'CREATIVE_TYPE_HTML' 
 ], 
 help 
 = 
 ( 
 'The creative attributes being declared. Specify each attribute ' 
 'separated by a space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_click_urls' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [ 
 'http://test.com' 
 ], 
 help 
 = 
 ( 
 'The click-through URLs being declared. Specify each URL ' 
 'separated by a space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_restricted_categories' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The restricted categories being declared. Specify each category ' 
 'separated by a space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_vendor_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The vendor IDs being declared. Specify each ID separated by a ' 
 'space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--html_snippet' 
 , 
 default 
 = 
 default_snippet_content 
 , 
 help 
 = 
 ( 
 'The HTML snippet that displays the ad when inserted in the ' 
 'web page.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--html_height' 
 , 
 default 
 = 
 250 
 , 
 help 
 = 
 'The height of the HTML snippet in pixels.' 
 ) 
 parser 
 . 
 add_argument 
 ( 
 '--html_width' 
 , 
 default 
 = 
 300 
 , 
 help 
 = 
 'The width of the HTML snippet in pixels.' 
 ) 
 args 
 = 
 parser 
 . 
 parse_args 
 () 
 main 
 ( 
 service 
 , 
 args 
 ) 

 #!/usr/bin/env ruby 
 # Encoding: utf-8 
 # 
 # Copyright:: Copyright 2020 Google LLC 
 # 
 # License:: 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. 
 # 
 # Creates a creative with HTML content for the given buyer account ID. 
 require 
  
 'optparse' 
 require 
  
 'securerandom' 
 require_relative 
  
 '../../../util' 
 def 
  
 create_html_creatives 
 ( 
 realtimebidding 
 , 
  
 options 
 ) 
  
  
 parent 
  
 = 
  
 "buyers/ 
 #{ 
 options 
 [ 
 :account_id 
 ] 
 } 
 " 
  
 body 
  
 = 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 Creative 
 . 
 new 
 ( 
  
 advertiser_name 
 : 
  
 options 
 [ 
 :advertiser_name 
 ] 
 , 
  
 creative_id 
 : 
  
 options 
 [ 
 :creative_id 
 ] 
 , 
  
 declared_attributes 
 : 
  
 options 
 [ 
 :declared_attributes 
 ] 
 , 
  
 declared_click_through_urls 
 : 
  
 options 
 [ 
 :declared_click_urls 
 ] 
 , 
  
 declared_resricted_categories 
 : 
  
 options 
 [ 
 :declared_restricted_categories 
 ] 
 , 
  
 declared_vendor_ids 
 : 
  
 options 
 [ 
 :declared_vendor_ids 
 ] 
 , 
  
 html 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 HtmlContent 
 . 
 new 
 ( 
  
 snippet 
 : 
  
 options 
 [ 
 :html_snippet 
 ] 
 , 
  
 height 
 : 
  
 options 
 [ 
 :html_height 
 ] 
 , 
  
 width 
 : 
  
 options 
 [ 
 :html_width 
 ] 
  
 ) 
  
 ) 
  
 puts 
  
 "Creating HTML creative for buyer account ' 
 #{ 
 parent 
 } 
 '" 
  
 creative 
  
 = 
  
 realtimebidding 
 . 
 create_buyer_creative 
 ( 
 parent 
 , 
  
 creative_object 
 = 
 body 
 ) 
  
 print_creative 
 ( 
 creative 
 ) 
 end 
 if 
  
 __FILE__ 
  
 == 
  
 $0 
  
 begin 
  
 # Retrieve the service used to make API requests. 
  
 service 
  
 = 
  
 get_service 
 () 
  
 rescue 
  
 ArgumentError 
  
 = 
>  
 e 
  
 raise 
  
 'Unable to create service, with error message: 
 #{ 
 e 
 . 
 message 
 } 
 ' 
  
 rescue 
  
 Signet 
 :: 
 AuthorizationError 
  
 = 
>  
 e 
  
 raise 
  
 'Unable to create service, was the KEY_FILE in util.rb set? Error message: 
 #{ 
 e 
 . 
 message 
 } 
 ' 
  
 end 
  
 default_snippet_content 
  
 = 
  
<< ~ 
 SNIPPET 
  
< iframe 
  
 marginwidth 
 = 
 0 
  
 marginheight 
 = 
 0 
  
 height 
 = 
 600 
  
 frameborder 
 = 
 0 
  
 width 
 = 
 160 
  
 scrolling 
 = 
 no 
  
 src 
 = 
 "https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%" 
>  
< /iframe 
> SNIPPET 
 # Set options and default values for fields used in this example. 
 options = [ 
 Option.new( 
 'account_id', 
 'The resource ID of the buyers resource under which the creatives were created, This will be used to construct '\ 
 'the name used as a path parameter for the creatives.get request.', 
 type: Integer, short_alias: 'a', required: true, default_value: nil 
 ), 
 Option.new( 
 'creative_id', 'The user-specified creative ID. The maximum length of the creative ID is 128 bytes.', 
 short_alias: 'c', required: false, default_value: "HTML_Creative_ 
 #{ 
 SecureRandom 
 . 
 uuid 
 } 
 " 
 ), 
 Option.new( 
 'advertiser_name', 'The name of the company being advertised in the creative.', required: false, 
 default_value: 'Test' 
 ), 
 Option.new( 
 'declared_attributes', 'The creative attributes being declared. Specify each attribute separated by a comma.', 
 required: false, type: Array, default_value: ['CREATIVE_TYPE_HTML'] 
 ), 
 Option.new( 
 'declared_click_urls', 'The click-through URLs being declared. Specify each URL separated by a comma.', 
 required: false, type: Array, default_value: ['http:/ 
 / 
 test 
 . 
 com 
 '] 
 ), 
 Option.new( 
 ' 
 declared_restricted_categories 
 ', 
 ' 
 The 
  
 restricted 
  
 categories 
  
 being 
  
 declared 
 . 
  
 Specify 
  
 each 
  
 category 
  
 separated 
  
 by 
  
 a 
  
 comma 
 . 
 ', 
 required: false, type: Array, default_value: [] 
 ), 
 Option.new( 
 ' 
 declared_vendor_ids 
 ', ' 
 The 
  
 vendor 
  
 IDs 
  
 being 
  
 declared 
 . 
  
 Specify 
  
 each 
  
 ID 
  
 separated 
  
 by 
  
 a 
  
 space 
 . 
 ', 
 required: false, type: Array, default_value: [] 
 ), 
 Option.new( 
 ' 
 html_snippet 
 ', ' 
 The 
  
 HTML 
  
 snippet 
  
 that 
  
 displays 
  
 the 
  
 ad 
  
 when 
  
 inserted 
  
 in 
  
 the 
  
 web 
  
 page 
 . 
 ', required: false, 
 default_value: default_snippet_content 
 ), 
 Option.new(' 
 html_height 
 ', ' 
 The 
  
 height 
  
 of 
  
 the 
  
 HTML 
  
 snippet 
  
 in 
  
 pixels 
 . 
 ', required: false, default_value: 250), 
 Option.new(' 
 html_width 
 ', ' 
 The 
  
 width 
  
 of 
  
 the 
  
 HTML 
  
 snippet 
  
 in 
  
 pixels 
 . 
 ', required: false, default_value: 300), 
 ] 
 # Parse options. 
 parser = Parser.new(options) 
 opts = parser.parse(ARGV) 
 begin 
 create_html_creatives(service, opts) 
 rescue Google::Apis::ServerError => e 
 raise "The following server error occured: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
 rescue Google::Apis::ClientError => e 
 raise "Invalid client request: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
 rescue Google::Apis::AuthorizationError => e 
 raise "Authorization error occured: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
 end 
 end 

POST https://realtimebidding.googleapis.com/v1/buyers/<INSERT_ACCOUNT_ID_HERE>/creatives?alt=json
Authorization: Bearer <INSERT_ACCESS_TOKEN_HERE>
Content-Type: application/json
 
{
  "advertiserName": "Test",
  "creativeId": "Native_Creative_b7116b38-e9d4-4f63-a02a-3d27660730be",
  "declaredAttributes": [
    "NATIVE_ELIGIBILITY_ELIGIBLE"
  ],
  "declaredClickThroughUrls": [
    "http://test.com"
  ],
  "declaredRestrictedCategories": [],
  "declaredVendorIds": [],
  "native": {
    "headline": "Luxury Mars Cruises",
    "body": "Visit the planet in a luxury spaceship.",
    "callToAction": "Book today",
    "advertiserName": "Galactic Luxury Cruises",
    "image": {
      "url": "https://native.test.com/image?id=123456",
      "height": 627,
      "width": 1200
    },
    "logo": {
      "url": "https://native.test.com/logo?id=123456",
      "height": 100,
      "width": 100
    },
    "clickLinkUrl": "https://www.google.com",
    "clickTrackingUrl": "https://native.test.com/click?id=123456"
  }
}

{
  "name": "buyers/<ACCOUNT_ID>/creatives/Native_Creative_b7116b38-e9d4-4f63-a02a-3d27660730be",
  "accountId": "<ACCOUNT_ID>",
  "creativeId": "Native_Creative_b7116b38-e9d4-4f63-a02a-3d27660730be",
  "native": {
    "headline": "Luxury Mars Cruises",
    "body": "Visit the planet in a luxury spaceship.",
    "callToAction": "Book today",
    "advertiserName": "Galactic Luxury Cruises",
    "image": {
      "url": "https://native.test.com/image?id=123456",
      "width": 1200,
      "height": 627
    },
    "logo": {
      "url": "https://native.test.com/logo?id=123456",
      "width": 100,
      "height": 100
    },
    "clickTrackingUrl": "https://native.test.com/click?id=123456",
    "clickLinkUrl": "https://www.google.com"
  },
  "creativeFormat": "NATIVE",
  "declaredClickThroughUrls": [
    "http://test.com"
  ],
  "declaredAttributes": [
    "NATIVE_ELIGIBILITY_ELIGIBLE"
  ],
  "advertiserName": "Test",
  "version": 1,
  "apiUpdateTime": "2020-08-06T23:55:19.967732Z",
  "creativeServingDecision": {
    "lastStatusUpdate": "2020-08-06T23:55:20.076Z",
    "dealsPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "networkPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "platformPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "chinaPolicyCompliance": {
      "status": "PENDING_REVIEW"
    },
    "russiaPolicyCompliance": {
      "status": "PENDING_REVIEW"
    }
  }
}

 /* 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 
  
 Google.Apis.RealTimeBidding.v1 
 ; 
 using 
  
 Google.Apis.RealTimeBidding.v1.Data 
 ; 
 using 
  
 Mono.Options 
 ; 
 using 
  
 System 
 ; 
 using 
  
 System.Collections.Generic 
 ; 
 namespace 
  
 Google.Apis.RealTimeBidding.Examples.v1.Buyers.Creatives 
 { 
  
 /// <summary> 
  
 /// Creates a creative with native content for the given buyer account ID. 
  
 /// </summary> 
  
 public 
  
 class 
  
 CreateNativeCreatives 
  
 : 
  
 ExampleBase 
  
 { 
  
 private 
  
 RealTimeBiddingService 
  
 rtbService 
 ; 
  
 /// <summary> 
  
 /// Constructor. 
  
 /// </summary> 
  
 public 
  
 CreateNativeCreatives 
 () 
  
 { 
  
 rtbService 
  
 = 
  
 Utilities 
 . 
 GetRealTimeBiddingService 
 (); 
  
 } 
  
 /// <summary> 
  
 /// Returns a description about the code example. 
  
 /// </summary> 
  
 public 
  
 override 
  
 string 
  
 Description 
  
 { 
  
 get 
  
 = 
>  
 "This code example creates a creative with native content for the given " 
  
 + 
  
 "buyer account ID." 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Parse specified arguments. 
  
 /// </summary> 
  
 protected 
  
 override 
  
 Dictionary<string 
 , 
  
 object 
>  
 ParseArguments 
 ( 
 List<string> 
  
 exampleArgs 
 ) 
  
 { 
  
 string 
 [] 
  
 requiredOptions 
  
 = 
  
 new 
  
 string 
 [] 
  
 { 
 "account_id" 
 }; 
  
 bool 
  
 showHelp 
  
 = 
  
 false 
 ; 
  
 string 
  
 accountId 
  
 = 
  
 null 
 ; 
  
 string 
  
 advertiserName 
  
 = 
  
 null 
 ; 
  
 string 
  
 creativeId 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 declaredAttributes 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<string> 
  
 declaredClickUrls 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<string> 
  
 declaredRestrictedCategories 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<int 
 ? 
>  
 declaredVendorIds 
  
 = 
  
 new 
  
 List<int 
 ? 
> (); 
  
 string 
  
 nativeHeadline 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeBody 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeCallToAction 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeAdvertiserName 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeImageUrl 
  
 = 
  
 null 
 ; 
  
 int? 
  
 nativeImageHeight 
  
 = 
  
 null 
 ; 
  
 int? 
  
 nativeImageWidth 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeLogoUrl 
  
 = 
  
 null 
 ; 
  
 int? 
  
 nativeLogoHeight 
  
 = 
  
 null 
 ; 
  
 int? 
  
 nativeLogoWidth 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeClickLinkUrl 
  
 = 
  
 null 
 ; 
  
 string 
  
 nativeClickTrackingUrl 
  
 = 
  
 null 
 ; 
  
 OptionSet 
  
 options 
  
 = 
  
 new 
  
 OptionSet 
  
 { 
  
 "Creates a creative with native content for the given buyer account ID." 
 , 
  
 { 
  
 "h|help" 
 , 
  
 "Show help message and exit." 
 , 
  
 h 
  
 = 
>  
 showHelp 
  
 = 
  
 h 
  
 != 
  
 null 
  
 }, 
  
 { 
  
 "a|account_id=" 
 , 
  
 ( 
 "[Required] The resource ID of the buyers resource under which the " 
  
 + 
  
 "creatives were created. This will be used to construct the name used as " 
  
 + 
  
 "a path parameter for the creatives.get request." 
 ), 
  
 a 
  
 = 
>  
 accountId 
  
 = 
  
 a 
  
 }, 
  
 { 
  
 "advertiser_name=" 
 , 
  
 "The name of the company being advertised in the creative." 
 , 
  
 advertiser_name 
  
 = 
>  
 advertiserName 
  
 = 
  
 advertiser_name 
  
 }, 
  
 { 
  
 "c|creative_id=" 
 , 
  
 ( 
 "The user-specified creative ID. The maximum length of the creative ID is " 
  
 + 
  
 "128 bytes." 
 ), 
  
 c 
  
 = 
>  
 creativeId 
  
 = 
  
 c 
  
 }, 
  
 { 
  
 "declared_attributes=" 
 , 
  
 ( 
 "The creative attributes being declared. Specify this argument for each " 
  
 + 
  
 "value you intend to include." 
 ), 
  
 declared_attributes 
  
 = 
>  
 declaredAttributes 
 . 
 Add 
 ( 
 declared_attributes 
 ) 
  
 }, 
  
 { 
  
 "declared_click_urls=" 
 , 
  
 ( 
 "The click-through URLs being declared. Specify this argument for each " 
  
 + 
  
 "value you intend to include." 
 ), 
  
 declared_click_through_urls 
  
 = 
>  
 declaredClickUrls 
 . 
 Add 
 ( 
  
 declared_click_through_urls 
 ) 
  
 }, 
  
 { 
  
 "declared_restricted_categories=" 
 , 
  
 ( 
 "The restricted categories being declared. Specify this argument for each " 
  
 + 
  
 "value you intend to include." 
 ), 
  
 declared_restricted_categories 
  
 = 
>  
 declaredRestrictedCategories 
 . 
 Add 
 ( 
  
 declared_restricted_categories 
 ) 
  
 }, 
  
 { 
  
 "declared_vendor_ids=" 
 , 
  
 ( 
 "The vendor IDs being declared. Specify this argument for each value you " 
  
 + 
  
 "intend to include." 
 ), 
  
 ( 
 int 
  
 declared_vendor_ids 
 ) 
  
 = 
>  
 declaredVendorIds 
 . 
 Add 
 ( 
 declared_vendor_ids 
 ) 
  
 }, 
  
 { 
  
 "native_headline=" 
 , 
  
 "A short title for the ad." 
 , 
  
 native_headline 
  
 = 
>  
 nativeHeadline 
  
 = 
  
 native_headline 
  
 }, 
  
 { 
  
 "native_body=" 
 , 
  
 "A long description of the ad." 
 , 
  
 native_body 
  
 = 
>  
 nativeBody 
  
 = 
  
 native_body 
  
 }, 
  
 { 
  
 "native_call_to_action=" 
 , 
  
 "A label for the button that the user is supposed to click." 
 , 
  
 native_call_to_action 
  
 = 
>  
 nativeCallToAction 
  
 = 
  
 native_call_to_action 
  
 }, 
  
 { 
  
 "native_advertiser_name=" 
 , 
  
 "The name of the advertiser or sponsor, to be displayed in the ad creative." 
 , 
  
 native_advertiser_name 
  
 = 
>  
 nativeAdvertiserName 
  
 = 
  
 native_advertiser_name 
  
 }, 
  
 { 
  
 "native_image_url=" 
 , 
  
 "The URL of the large image to be included in the native ad." 
 , 
  
 native_image_url 
  
 = 
>  
 nativeImageUrl 
  
 = 
  
 native_image_url 
  
 }, 
  
 { 
  
 "native_image_height=" 
 , 
  
 "The height in pixels of the native ad's large image." 
 , 
  
 ( 
 int 
  
 native_image_height 
 ) 
  
 = 
>  
 nativeImageHeight 
  
 = 
  
 native_image_height 
  
 }, 
  
 { 
  
 "native_image_width=" 
 , 
  
 "The width in pixels of the native ad's large image." 
 , 
  
 ( 
 int 
  
 native_image_width 
 ) 
  
 = 
>  
 nativeImageWidth 
  
 = 
  
 native_image_width 
  
 }, 
  
 { 
  
 "native_logo_url=" 
 , 
  
 "The URL of a smaller image to be included in the native ad." 
 , 
  
 native_logo_url 
  
 = 
>  
 nativeLogoUrl 
  
 = 
  
 native_logo_url 
  
 }, 
  
 { 
  
 "native_logo_height=" 
 , 
  
 "The height in pixels of the native ad's smaller image." 
 , 
  
 ( 
 int 
  
 native_logo_height 
 ) 
  
 = 
>  
 nativeLogoHeight 
  
 = 
  
 native_logo_height 
  
 }, 
  
 { 
  
 "native_logo_width=" 
 , 
  
 "The height in pixels of the native ad's smaller image." 
 , 
  
 ( 
 int 
  
 native_logo_width 
 ) 
  
 = 
>  
 nativeLogoWidth 
  
 = 
  
 native_logo_width 
  
 }, 
  
 { 
  
 "native_click_link_url=" 
 , 
  
 "The URL that the browser/SDK will load when the user clicks the ad." 
 , 
  
 native_click_link_url 
  
 = 
>  
 nativeClickLinkUrl 
  
 = 
  
 native_click_link_url 
  
 }, 
  
 { 
  
 "native_click_tracking_url=" 
 , 
  
 "The URL to use for click tracking." 
 , 
  
 native_click_tracking_url 
  
 = 
>  
 nativeClickTrackingUrl 
  
 = 
  
 native_click_tracking_url 
  
 }, 
  
 }; 
  
 List<string> 
  
 extras 
  
 = 
  
 options 
 . 
 Parse 
 ( 
 exampleArgs 
 ); 
  
 var 
  
 parsedArgs 
  
 = 
  
 new 
  
 Dictionary<string 
 , 
  
 object 
> (); 
  
 // Show help message. 
  
 if 
 ( 
 showHelp 
  
 == 
  
 true 
 ) 
  
 { 
  
 options 
 . 
 WriteOptionDescriptions 
 ( 
 Console 
 . 
 Out 
 ); 
  
 Environment 
 . 
 Exit 
 ( 
 0 
 ); 
  
 } 
  
 // Set arguments. 
  
 parsedArgs 
 [ 
 "account_id" 
 ] 
  
 = 
  
 accountId 
 ; 
  
 parsedArgs 
 [ 
 "advertiser_name" 
 ] 
  
 = 
  
 advertiserName 
  
 ?? 
  
 "Test" 
 ; 
  
 parsedArgs 
 [ 
 "creative_id" 
 ] 
  
 = 
  
 creativeId 
  
 ?? 
  
 String 
 . 
 Format 
 ( 
  
 "Native_Creative_{0}" 
 , 
  
 System 
 . 
 Guid 
 . 
 NewGuid 
 ()); 
  
 if 
  
 ( 
 declaredAttributes 
 . 
 Count 
  
 == 
  
 0 
 ) 
  
 { 
  
 declaredAttributes 
 . 
 Add 
 ( 
 "NATIVE_ELIGIBILITY_ELIGIBLE" 
 ); 
  
 } 
  
 parsedArgs 
 [ 
 "declared_attributes" 
 ] 
  
 = 
  
 declaredAttributes 
 ; 
  
 if 
  
 ( 
 declaredClickUrls 
 . 
 Count 
  
 == 
  
 0 
 ) 
  
 { 
  
 declaredClickUrls 
 . 
 Add 
 ( 
 "http://test.com" 
 ); 
  
 } 
  
 parsedArgs 
 [ 
 "declared_click_urls" 
 ] 
  
 = 
  
 declaredClickUrls 
 ; 
  
 parsedArgs 
 [ 
 "declared_restricted_categories" 
 ] 
  
 = 
  
 declaredRestrictedCategories 
 ; 
  
 parsedArgs 
 [ 
 "declared_vendor_ids" 
 ] 
  
 = 
  
 declaredVendorIds 
 ; 
  
 parsedArgs 
 [ 
 "native_headline" 
 ] 
  
 = 
  
 nativeHeadline 
  
 ?? 
  
 "Luxury Mars Cruises" 
 ; 
  
 parsedArgs 
 [ 
 "native_body" 
 ] 
  
 = 
  
 nativeBody 
  
 ?? 
  
 "Visit the planet in a luxury spaceship." 
 ; 
  
 parsedArgs 
 [ 
 "native_call_to_action" 
 ] 
  
 = 
  
 nativeHeadline 
  
 ?? 
  
 "Book today" 
 ; 
  
 parsedArgs 
 [ 
 "native_advertiser_name" 
 ] 
  
 = 
  
 nativeAdvertiserName 
  
 ?? 
  
 "Galactic Luxury Cruises" 
 ; 
  
 parsedArgs 
 [ 
 "native_image_url" 
 ] 
  
 = 
  
 nativeImageUrl 
  
 ?? 
  
 "https://native.test.com/image?id=123456" 
 ; 
  
 parsedArgs 
 [ 
 "native_image_height" 
 ] 
  
 = 
  
 nativeImageHeight 
  
 ?? 
  
 627 
 ; 
  
 parsedArgs 
 [ 
 "native_image_width" 
 ] 
  
 = 
  
 nativeImageWidth 
  
 ?? 
  
 1200 
 ; 
  
 parsedArgs 
 [ 
 "native_image_url" 
 ] 
  
 = 
  
 "https://native.test.com/image?id=123456" 
 ; 
  
 parsedArgs 
 [ 
 "native_image_height" 
 ] 
  
 = 
  
 627 
 ; 
  
 parsedArgs 
 [ 
 "native_image_width" 
 ] 
  
 = 
  
 1200 
 ; 
  
 parsedArgs 
 [ 
 "native_logo_url" 
 ] 
  
 = 
  
 nativeLogoUrl 
  
 ?? 
  
 "https://native.test.com/logo?id=123456" 
 ; 
  
 parsedArgs 
 [ 
 "native_logo_height" 
 ] 
  
 = 
  
 nativeLogoHeight 
  
 ?? 
  
 100 
 ; 
  
 parsedArgs 
 [ 
 "native_logo_width" 
 ] 
  
 = 
  
 nativeLogoWidth 
  
 ?? 
  
 100 
 ; 
  
 parsedArgs 
 [ 
 "native_click_link_url" 
 ] 
  
 = 
  
 nativeClickLinkUrl 
  
 ?? 
  
 "https://www.google.com" 
 ; 
  
 parsedArgs 
 [ 
 "native_click_tracking_url" 
 ] 
  
 = 
  
 nativeClickTrackingUrl 
  
 ?? 
  
 "https://native.test.com/click?id=123456" 
 ; 
  
 // Validate that options were set correctly. 
  
 Utilities 
 . 
 ValidateOptions 
 ( 
 options 
 , 
  
 parsedArgs 
 , 
  
 requiredOptions 
 , 
  
 extras 
 ); 
  
 return 
  
 parsedArgs 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Run the example. 
  
 /// </summary> 
  
 /// <param name="parsedArgs">Parsed arguments for the example.</param> 
  
 protected 
  
 override 
  
 void 
  
 Run 
 ( 
 Dictionary<string 
 , 
  
 object 
>  
 parsedArgs 
 ) 
  
 { 
  
 string 
  
 accountId 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "account_id" 
 ]; 
  
 string 
  
 parent 
  
 = 
  
 $"buyers/{accountId}" 
 ; 
  
 Image 
  
 nativeImage 
  
 = 
  
 new 
  
 Image 
 (); 
  
 nativeImage 
 . 
 Url 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_image_url" 
 ]; 
  
 nativeImage 
 . 
 Height 
  
 = 
  
 ( 
 int? 
 ) 
  
 parsedArgs 
 [ 
 "native_image_height" 
 ]; 
  
 nativeImage 
 . 
 Width 
  
 = 
  
 ( 
 int? 
 ) 
  
 parsedArgs 
 [ 
 "native_image_width" 
 ]; 
  
 Image 
  
 nativeLogo 
  
 = 
  
 new 
  
 Image 
 (); 
  
 nativeLogo 
 . 
 Url 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_logo_url" 
 ]; 
  
 nativeLogo 
 . 
 Height 
  
 = 
  
 ( 
 int? 
 ) 
  
 parsedArgs 
 [ 
 "native_logo_height" 
 ]; 
  
 nativeLogo 
 . 
 Width 
  
 = 
  
 ( 
 int? 
 ) 
  
 parsedArgs 
 [ 
 "native_logo_width" 
 ]; 
  
 NativeContent 
  
 nativeContent 
  
 = 
  
 new 
  
 NativeContent 
 (); 
  
 nativeContent 
 . 
 Headline 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_headline" 
 ]; 
  
 nativeContent 
 . 
 Body 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_body" 
 ]; 
  
 nativeContent 
 . 
 CallToAction 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_call_to_action" 
 ]; 
  
 nativeContent 
 . 
 AdvertiserName 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_advertiser_name" 
 ]; 
  
 nativeContent 
 . 
 Image 
  
 = 
  
 nativeImage 
 ; 
  
 nativeContent 
 . 
 Logo 
  
 = 
  
 nativeLogo 
 ; 
  
 nativeContent 
 . 
 ClickLinkUrl 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_click_link_url" 
 ]; 
  
 nativeContent 
 . 
 ClickTrackingUrl 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "native_click_tracking_url" 
 ]; 
  
 Creative 
  
 newCreative 
  
 = 
  
 new 
  
 Creative 
 (); 
  
 newCreative 
 . 
 AdvertiserName 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "advertiser_name" 
 ]; 
  
 newCreative 
 . 
 CreativeId 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "creative_id" 
 ]; 
  
 newCreative 
 . 
 DeclaredAttributes 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "declared_attributes" 
 ]; 
  
 newCreative 
 . 
 DeclaredClickThroughUrls 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
  
 "declared_click_urls" 
 ]; 
  
 newCreative 
 . 
 DeclaredRestrictedCategories 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
  
 "declared_restricted_categories" 
 ]; 
  
 newCreative 
 . 
 DeclaredVendorIds 
  
 = 
  
 ( 
 IList<int 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "declared_vendor_ids" 
 ]; 
  
 newCreative 
 . 
 Native 
  
 = 
  
 nativeContent 
 ; 
  
 BuyersResource 
 . 
 CreativesResource 
 . 
 CreateRequest 
  
 request 
  
 = 
  
 rtbService 
 . 
 Buyers 
 . 
 Creatives 
 . 
 Create 
 ( 
 newCreative 
 , 
  
 parent 
 ); 
  
 Creative 
  
 response 
  
 = 
  
 null 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 "Creating native creative for buyer: {0}" 
 , 
  
 parent 
 ); 
  
 try 
  
 { 
  
 response 
  
 = 
  
 request 
 . 
 Execute 
 (); 
  
 } 
  
 catch 
  
 ( 
 System 
 . 
 Exception 
  
 exception 
 ) 
  
 { 
  
 throw 
  
 new 
  
 ApplicationException 
 ( 
  
 $"Real-time Bidding API returned error response:\n{exception.Message}" 
 ); 
  
 } 
  
 Utilities 
 . 
 PrintCreative 
 ( 
 response 
 ); 
  
 } 
  
 } 
 } 

 /* 
 * 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.api.services.samples.authorizedbuyers.realtimebidding.v1.buyers.creatives 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.RealTimeBidding 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.Creative 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.Image 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.NativeContent 
 ; 
 import 
  
 com.google.api.services.samples.authorizedbuyers.realtimebidding.Utils 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.security.GeneralSecurityException 
 ; 
 import 
  
 java.util.Collections 
 ; 
 import 
  
 java.util.UUID 
 ; 
 import 
  
 net.sourceforge.argparse4j.ArgumentParsers 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.ArgumentParser 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.ArgumentParserException 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.Namespace 
 ; 
 /** Creates a creative with native content for the given buyer account ID. */ 
 public 
  
 class 
 CreateNativeCreatives 
  
 { 
  
 public 
  
 static 
  
 void 
  
 execute 
 ( 
 RealTimeBidding 
  
 client 
 , 
  
 Namespace 
  
 parsedArgs 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 Long 
  
 accountId 
  
 = 
  
 parsedArgs 
 . 
 getLong 
 ( 
 "account_id" 
 ); 
  
 String 
  
 parentBuyerName 
  
 = 
  
 String 
 . 
 format 
 ( 
 "buyers/%s" 
 , 
  
 accountId 
 ); 
  
 Image 
  
 image 
  
 = 
  
 new 
  
 Image 
 (); 
  
 image 
 . 
 setUrl 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_image_url" 
 )); 
  
 image 
 . 
 setHeight 
 ( 
 parsedArgs 
 . 
 getInt 
 ( 
 "native_image_height" 
 )); 
  
 image 
 . 
 setWidth 
 ( 
 parsedArgs 
 . 
 getInt 
 ( 
 "native_image_width" 
 )); 
  
 Image 
  
 logo 
  
 = 
  
 new 
  
 Image 
 (); 
  
 logo 
 . 
 setUrl 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_logo_url" 
 )); 
  
 logo 
 . 
 setHeight 
 ( 
 parsedArgs 
 . 
 getInt 
 ( 
 "native_logo_height" 
 )); 
  
 logo 
 . 
 setWidth 
 ( 
 parsedArgs 
 . 
 getInt 
 ( 
 "native_logo_width" 
 )); 
  
 NativeContent 
  
 nativeContent 
  
 = 
  
 new 
  
 NativeContent 
 (); 
  
 nativeContent 
 . 
 setHeadline 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_headline" 
 )); 
  
 nativeContent 
 . 
 setBody 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_body" 
 )); 
  
 nativeContent 
 . 
 setCallToAction 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_call_to_action" 
 )); 
  
 nativeContent 
 . 
 setAdvertiserName 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_advertiser_name" 
 )); 
  
 nativeContent 
 . 
 setImage 
 ( 
 image 
 ); 
  
 nativeContent 
 . 
 setLogo 
 ( 
 logo 
 ); 
  
 nativeContent 
 . 
 setClickLinkUrl 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_click_link_url" 
 )); 
  
 nativeContent 
 . 
 setClickTrackingUrl 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "native_click_tracking_url" 
 )); 
  
 Creative 
  
 newCreative 
  
 = 
  
 new 
  
 Creative 
 (); 
  
 newCreative 
 . 
 setAdvertiserName 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "advertiser_name" 
 )); 
  
 newCreative 
 . 
 setCreativeId 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "creative_id" 
 )); 
  
 newCreative 
 . 
 setDeclaredAttributes 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "declared_attributes" 
 )); 
  
 newCreative 
 . 
 setDeclaredClickThroughUrls 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "declared_click_urls" 
 )); 
  
 newCreative 
 . 
 setDeclaredRestrictedCategories 
 ( 
  
 parsedArgs 
 . 
< String>getList 
 ( 
 "declared_restricted_categories" 
 )); 
  
 newCreative 
 . 
 setDeclaredVendorIds 
 ( 
 parsedArgs 
 . 
< Integer>getList 
 ( 
 "declared_vendor_ids" 
 )); 
  
 newCreative 
 . 
 setNative 
 ( 
 nativeContent 
 ); 
  
 Creative 
  
 creative 
  
 = 
  
 client 
 . 
 buyers 
 (). 
 creatives 
 (). 
 create 
 ( 
 parentBuyerName 
 , 
  
 newCreative 
 ). 
 execute 
 (); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Created creative for buyer Account ID '%s':\n" 
 , 
  
 accountId 
 ); 
  
 Utils 
 . 
 printCreative 
 ( 
 creative 
 ); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 { 
  
 ArgumentParser 
  
 parser 
  
 = 
  
 ArgumentParsers 
 . 
 newFor 
 ( 
 "CreateNativeCreatives" 
 ) 
  
 . 
 build 
 () 
  
 . 
 defaultHelp 
 ( 
 true 
 ) 
  
 . 
 description 
 (( 
 "Creates an native creative for the given buyer account ID." 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "-a" 
 , 
  
 "--account_id" 
 ) 
  
 . 
 help 
 ( 
 "The resource ID of the buyers resource under which the creative is to be created. " 
 ) 
  
 . 
 required 
 ( 
 true 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--advertiser_name" 
 ) 
  
 . 
 help 
 ( 
 "The name of the company being advertised in the creative." 
 ) 
  
 . 
 setDefault 
 ( 
 "Test" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "-c" 
 , 
  
 "--creative_id" 
 ) 
  
 . 
 help 
 ( 
 "The user-specified creative ID. The maximum length of the creative ID is 128 bytes." 
 ) 
  
 . 
 setDefault 
 ( 
 String 
 . 
 format 
 ( 
 "Native_Creative_%s" 
 , 
  
 UUID 
 . 
 randomUUID 
 ())); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_attributes" 
 ) 
  
 . 
 help 
 ( 
  
 "The creative attributes being declared. Specify each attribute separated by a " 
  
 + 
  
 "space." 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ) 
  
 . 
 setDefault 
 ( 
 Collections 
 . 
 singletonList 
 ( 
 "NATIVE_ELIGIBILITY_ELIGIBLE" 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_click_urls" 
 ) 
  
 . 
 help 
 ( 
 "The click-through URLs being declared. Specify each URL separated by a space." 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ) 
  
 . 
 setDefault 
 ( 
 Collections 
 . 
 singletonList 
 ( 
 "http://test.com" 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_restricted_categories" 
 ) 
  
 . 
 help 
 ( 
  
 "The restricted categories being declared. Specify each category separated by a " 
  
 + 
  
 "space." 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--declared_vendor_ids" 
 ) 
  
 . 
 help 
 ( 
 "The vendor IDs being declared. Specify each ID separated by a space." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_headline" 
 ) 
  
 . 
 help 
 ( 
 "A short title for the ad." 
 ) 
  
 . 
 setDefault 
 ( 
 "Luxury Mars Cruises" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_body" 
 ) 
  
 . 
 help 
 ( 
 "A long description of the ad." 
 ) 
  
 . 
 setDefault 
 ( 
 "Visit the planet in a luxury spaceship." 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_call_to_action" 
 ) 
  
 . 
 help 
 ( 
 "A label for the button that the user is supposed to click." 
 ) 
  
 . 
 setDefault 
 ( 
 "Book today" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_advertiser_name" 
 ) 
  
 . 
 help 
 ( 
 "The name of the advertiser or sponsor, to be displayed in the ad creative." 
 ) 
  
 . 
 setDefault 
 ( 
 "Galactic Luxury Cruises" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_image_url" 
 ) 
  
 . 
 help 
 ( 
 "The URL of the large image to be included in the native ad." 
 ) 
  
 . 
 setDefault 
 ( 
 "https://native.test.com/image?id=123456" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_image_height" 
 ) 
  
 . 
 help 
 ( 
 "The height in pixels of the native ad's large image." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 627 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_image_width" 
 ) 
  
 . 
 help 
 ( 
 "The width in pixels of the native ad's large image." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 1200 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_logo_url" 
 ) 
  
 . 
 help 
 ( 
 "The URL of a smaller image to be included in the native ad." 
 ) 
  
 . 
 setDefault 
 ( 
 "https://native.test.com/logo?id=123456" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_logo_height" 
 ) 
  
 . 
 help 
 ( 
 "The height in pixels of the native ad's smaller image." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 100 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_logo_width" 
 ) 
  
 . 
 help 
 ( 
 "The width in pixels of the native ad's smaller image." 
 ) 
  
 . 
 type 
 ( 
 Integer 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 100 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_click_link_url" 
 ) 
  
 . 
 help 
 ( 
 "The URL that the browser/SDK will load when the user clicks the ad." 
 ) 
  
 . 
 setDefault 
 ( 
 "https://www.google.com" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--native_click_tracking_url" 
 ) 
  
 . 
 help 
 ( 
 "The URL to use for click tracking." 
 ) 
  
 . 
 setDefault 
 ( 
 "https://native.test.com/click?id=123456" 
 ); 
  
 Namespace 
  
 parsedArgs 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 parsedArgs 
  
 = 
  
 parser 
 . 
 parseArgs 
 ( 
 args 
 ); 
  
 } 
  
 catch 
  
 ( 
 ArgumentParserException 
  
 ex 
 ) 
  
 { 
  
 parser 
 . 
 handleError 
 ( 
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 RealTimeBidding 
  
 client 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 client 
  
 = 
  
 Utils 
 . 
 getRealTimeBiddingClient 
 (); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Unable to create RealTimeBidding API service:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "Did you specify a valid path to a service account key file?" 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 catch 
  
 ( 
 GeneralSecurityException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Unable to establish secure HttpTransport:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 try 
  
 { 
  
 execute 
 ( 
 client 
 , 
  
 parsedArgs 
 ); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "RealTimeBidding API returned error response:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 } 
 } 

< ?php 
 /** 
 * 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. 
 */ 
 namespace Google\Ads\AuthorizedBuyers\RealTimeBidding\Examples\V1\Buyers_Creatives; 
 use Google\Ads\AuthorizedBuyers\RealTimeBidding\ExampleUtil\BaseExample; 
 use Google\Ads\AuthorizedBuyers\RealTimeBidding\ExampleUtil\Config; 
 use Google_Service_RealTimeBidding_Creative; 
 use Google_Service_RealTimeBidding_Image; 
 use Google_Service_RealTimeBidding_NativeContent; 
 /** 
 * This example illustrates how to create native creatives for a given buyer account. 
 */ 
 class CreateNativeCreatives extends BaseExample 
 { 
 public function __construct($client) 
 { 
 $this->service = Config::getGoogleServiceRealTimeBidding($client); 
 } 
 /** 
 * @see BaseExample::getInputParameters() 
 */ 
 protected function getInputParameters() 
 { 
 return [ 
 [ 
 'name' => 'account_id', 
 'display' => 'Account ID', 
 'description' = 
> 'The resource ID of the buyers resource under which the creative is to be ' . 
 'created.', 
 'required' => true 
 ], 
 [ 
 'name' => 'advertiser_name', 
 'display' => 'Advertiser name', 
 'description' => 'The name of the company being advertised in the creative.', 
 'required' => false, 
 'default' => 'Test' 
 ], 
 [ 
 'name' => 'creative_id', 
 'display' => 'Creative ID', 
 'description' = 
> 'The user-specified creative ID. The maximum length of the creative ID is ' . 
 '128 bytes', 
 'required' => false, 
 'default' => 'Native_Creative_' . uniqid() 
 ], 
 [ 
 'name' => 'declared_attributes', 
 'display' => 'Declared attributes', 
 'description' = 
> 'The creative attributes being declared. Specify each attribute separated ' . 
 'by a comma.', 
 'required' => false, 
 'is_array' => true, 
 'default' => ['NATIVE_ELIGIBILITY_ELIGIBLE'] 
 ], 
 [ 
 'name' => 'declared_click_urls', 
 'display' => 'Declared click URLs', 
 'description' = 
> 'The click-through URLs being declared. Specify each URL separated by a ' . 
 'comma.', 
 'required' => false, 
 'is_array' => true, 
 'default' => ['http://test.com'] 
 ], 
 [ 
 'name' => 'declared_restricted_categories', 
 'display' => 'Declared restricted categories', 
 'description' = 
> 'The restricted categories being declared. Specify each category separated ' . 
 'by a comma.', 
 'required' => false, 
 'is_array' => true 
 ], 
 [ 
 'name' => 'declared_vendor_ids', 
 'display' => 'Declared vendor IDs', 
 'description' = 
> 'The vendor IDs being declared. Specify each ID separated by a comma.', 
 'required' => false, 
 'is_array' => true 
 ], 
 [ 
 'name' => 'native_headline', 
 'display' => 'Native ad headline', 
 'description' => 'A short title for the ad.', 
 'required' => false, 
 'default' => 'Luxury Mars Cruises' 
 ], 
 [ 
 'name' => 'native_body', 
 'display' => 'Native ad body', 
 'description' => 'A long description of the ad.', 
 'required' => false, 
 'default' => 'Visit the planet in a luxury spaceship.' 
 ], 
 [ 
 'name' => 'native_call_to_action', 
 'display' => 'Native ad call to action', 
 'description' => 'A label for the button that the user is supposed to click.', 
 'required' => false, 
 'default' => 'Book today' 
 ], 
 [ 
 'name' => 'native_advertiser_name', 
 'display' => 'Native ad advertiser name', 
 'description' = 
> 'The name of the advertiser or sponsor, to be displayed in the ad creative.', 
 'required' => false, 
 'default' => 'Galactic Luxury Cruises' 
 ], 
 [ 
 'name' => 'native_image_url', 
 'display' => 'Native ad image url', 
 'description' => 'The URL of the large image to be included in the native ad.', 
 'required' => false, 
 'default' => 'https://native.test.com/image?id=123456' 
 ], 
 [ 
 'name' => 'native_image_height', 
 'display' => 'Native ad image height', 
 'description' => 'The height in pixels of the native ad\'s large image.', 
 'required' => false, 
 'default' => 627 
 ], 
 [ 
 'name' => 'native_image_width', 
 'display' => 'Native ad image width', 
 'description' => 'The width in pixels of the native ad\'s large image.', 
 'required' => false, 
 'default' => 1200 
 ], 
 [ 
 'name' => 'native_logo_url', 
 'display' => 'Native ad logo url', 
 'description' => 'The URL of a smaller image to be included in the native ad.', 
 'required' => false, 
 'default' => 'https://native.test.com/logo?id=123456' 
 ], 
 [ 
 'name' => 'native_logo_height', 
 'display' => 'Native ad logo height', 
 'description' => 'The height in pixels of the native ad\'s smaller image.', 
 'required' => false, 
 'default' => 100 
 ], 
 [ 
 'name' => 'native_logo_width', 
 'display' => 'Native ad logo width', 
 'description' => 'The width in pixels of the native ad\'s smaller image.', 
 'required' => false, 
 'default' => 100 
 ], 
 [ 
 'name' => 'native_click_link_url', 
 'display' => 'Native ad click link URL', 
 'description' = 
> 'The URL that the browser/SDK will load when the user clicks ' . 
 'the ad.', 
 'required' => false, 
 'default' => 'https://www.google.com' 
 ], 
 [ 
 'name' => 'native_click_tracking_url', 
 'display' => 'Native ad click tracking URL', 
 'description' => 'The URL to use for click tracking.', 
 'required' => false, 
 'default' => 'https://native.test.com/click?id=123456' 
 ] 
 ]; 
 } 
 /** 
 * @see BaseExample::run() 
 */ 
 public function run() 
 { 
 $values = $this->formValues; 
 $parentName = "buyers/$values[account_id]"; 
 $image = new Google_Service_RealTimeBidding_Image(); 
 $image->url = $values['native_image_url']; 
 $image->height = $values['native_image_height']; 
 $image->width = $values['native_image_width']; 
 $logo = new Google_Service_RealTimeBidding_Image(); 
 $logo->url = $values['native_logo_url']; 
 $logo->height = $values['native_logo_height']; 
 $logo->width = $values['native_logo_width']; 
 $native = new Google_Service_RealTimeBidding_NativeContent(); 
 $native->headline = $values['native_headline']; 
 $native->body = $values['native_body']; 
 $native->callToAction = $values['native_call_to_action']; 
 $native->advertiserName = $values['native_advertiser_name']; 
 $native->setImage($image); 
 $native->setLogo($logo); 
 $newCreative = new Google_Service_RealTimeBidding_Creative(); 
 $newCreative->advertiserName = $values['advertiser_name']; 
 $newCreative->creativeId = $values['creative_id']; 
 $newCreative->declaredAttributes = $values['declared_attributes']; 
 $newCreative->declaredClickThroughUrls = $values['declared_click_urls']; 
 $newCreative->declaredRestrictedCategories = $values['declared_restricted_categories']; 
 $newCreative->declaredVendorIds = $values['declared_vendor_ids']; 
 $newCreative->setNative($native); 
 print "<h2>Creating Creative for '$parentName':</h2>"; 
 $result = $this->service->buyers_creatives->create($parentName, $newCreative); 
 $this->printResult($result); 
 } 
 /** 
 * @see BaseExample::getName() 
 */ 
 public function getName() 
 { 
 return 'Create Buyer Native Creative'; 
 } 
 } 

 #!/usr/bin/python 
 # 
 # Copyright 2020 Google Inc. All Rights Reserved. 
 # 
 # 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. 
 """Creates a creative with native content for the given buyer account ID.""" 
 import 
  
 argparse 
 import 
  
 datetime 
 import 
  
 os 
 import 
  
 pprint 
 import 
  
 sys 
 import 
  
 uuid 
 sys 
 . 
 path 
 . 
 insert 
 ( 
 0 
 , 
 os 
 . 
 path 
 . 
 abspath 
 ( 
 '../../..' 
 )) 
 from 
  
 googleapiclient.errors 
  
 import 
 HttpError 
 import 
  
 util 
 _BUYER_NAME_TEMPLATE 
 = 
 'buyers/ 
 %s 
 ' 
 DEFAULT_BUYER_RESOURCE_ID 
 = 
 'ENTER_BUYER_RESOURCE_ID_HERE' 
 def 
  
 main 
 ( 
 realtimebidding 
 , 
 args 
 ): 
 account_id 
 = 
 args 
 . 
 account_id 
 creative 
 = 
 { 
 'advertiserName' 
 : 
 args 
 . 
 advertiser_name 
 , 
 'creativeId' 
 : 
 args 
 . 
 creative_id 
 , 
 'declaredAttributes' 
 : 
 args 
 . 
 declared_attributes 
 , 
 'declaredClickThroughUrls' 
 : 
 args 
 . 
 declared_click_urls 
 , 
 'declaredRestrictedCategories' 
 : 
 args 
 . 
 declared_restricted_categories 
 , 
 'declaredVendorIds' 
 : 
 [ 
 int 
 ( 
 id 
 ) 
 for 
 id 
 in 
 args 
 . 
 declared_vendor_ids 
 ], 
 'native' 
 : 
 { 
 'headline' 
 : 
 args 
 . 
 native_headline 
 , 
 'body' 
 : 
 args 
 . 
 native_body 
 , 
 'callToAction' 
 : 
 args 
 . 
 native_call_to_action 
 , 
 'advertiserName' 
 : 
 args 
 . 
 native_advertiser_name 
 , 
 'image' 
 : 
 { 
 'url' 
 : 
 args 
 . 
 native_image_url 
 , 
 'height' 
 : 
 args 
 . 
 native_image_height 
 , 
 'width' 
 : 
 args 
 . 
 native_image_width 
 }, 
 'logo' 
 : 
 { 
 'url' 
 : 
 args 
 . 
 native_logo_url 
 , 
 'height' 
 : 
 args 
 . 
 native_logo_height 
 , 
 'width' 
 : 
 args 
 . 
 native_logo_width 
 }, 
 'clickLinkUrl' 
 : 
 args 
 . 
 native_click_link_url 
 , 
 'clickTrackingUrl' 
 : 
 args 
 . 
 native_click_tracking_url 
 } 
 } 
 print 
 ( 
 f 
 'Creating native creative for buyer account ID " 
 { 
 account_id 
 } 
 ":' 
 ) 
 try 
 : 
 # Construct and execute the request. 
 response 
 = 
 ( 
 realtimebidding 
 . 
 buyers 
 () 
 . 
 creatives 
 () 
 . 
 create 
 ( 
 parent 
 = 
 _BUYER_NAME_TEMPLATE 
 % 
 account_id 
 , 
 body 
 = 
 creative 
 ) 
 . 
 execute 
 ()) 
 except 
 HttpError 
 as 
 e 
 : 
 print 
 ( 
 e 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 pprint 
 . 
 pprint 
 ( 
 response 
 ) 
 if 
 __name__ 
 == 
 '__main__' 
 : 
 try 
 : 
 service 
 = 
 util 
 . 
 GetService 
 ( 
 version 
 = 
 'v1' 
 ) 
 except 
 IOError 
 as 
 ex 
 : 
 print 
 ( 
 f 
 'Unable to create realtimebidding service - 
 { 
 ex 
 } 
 ' 
 ) 
 print 
 ( 
 'Did you specify the key file in util.py?' 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 parser 
 = 
 argparse 
 . 
 ArgumentParser 
 ( 
 description 
 = 
 ( 
 'Creates a native creative for the given buyer account ID.' 
 ) 
 ) 
 # Required fields. 
 parser 
 . 
 add_argument 
 ( 
 '-a' 
 , 
 '--account_id' 
 , 
 default 
 = 
 DEFAULT_BUYER_RESOURCE_ID 
 , 
 help 
 = 
 ( 
 'The resource ID of the buyers resource under which the ' 
 'creative is to be created.' 
 )) 
 # Optional fields. 
 parser 
 . 
 add_argument 
 ( 
 '--advertiser_name' 
 , 
 default 
 = 
 'Test' 
 , 
 help 
 = 
 'The name of the company being advertised in the creative.' 
 ) 
 parser 
 . 
 add_argument 
 ( 
 '-c' 
 , 
 '--creative_id' 
 , 
 default 
 = 
 'Native_Creative_ 
 %s 
 ' 
 % 
 uuid 
 . 
 uuid4 
 (), 
 help 
 = 
 ( 
 'The user-specified creative ID. The maximum length of the ' 
 'creative ID is 128 bytes.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_attributes' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [ 
 'NATIVE_ELIGIBILITY_ELIGIBLE' 
 ], 
 help 
 = 
 ( 
 'The creative attributes being declared. Specify each attribute ' 
 'separated by a space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_click_urls' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [ 
 'http://test.com' 
 ], 
 help 
 = 
 ( 
 'The click-through URLs being declared. Specify each URL ' 
 'separated by a space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_restricted_categories' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The restricted categories being declared. Specify each category ' 
 'separated by a space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--declared_vendor_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The vendor IDs being declared. Specify each ID separated by a ' 
 'space.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--native_headline' 
 , 
 default 
 = 
 'Luxury Mars Cruises' 
 , 
 help 
 = 
 ( 
 'A short title for the ad.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--native_body' 
 , 
 default 
 = 
 'Visit the planet in a luxury spaceship.' 
 , 
 help 
 = 
 'A long description of the ad.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_call_to_action' 
 , 
 default 
 = 
 'Book today' 
 , 
 help 
 = 
 'A label for the button that the user is supposed to click.' 
 ) 
 parser 
 . 
 add_argument 
 ( 
 '--native_advertiser_name' 
 , 
 default 
 = 
 'Galactic Luxury Cruises' 
 , 
 help 
 = 
 ( 
 'The name of the advertiser or sponsor, to be displayed in the ad ' 
 'creative.' 
 )), 
 parser 
 . 
 add_argument 
 ( 
 '--native_image_url' 
 , 
 default 
 = 
 'https://native.test.com/image?id=123456' 
 , 
 help 
 = 
 'The URL of the large image to be included in the native ad.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_image_height' 
 , 
 default 
 = 
 627 
 , 
 help 
 = 
 'The height in pixels of the native ad 
 \' 
 s large image.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_image_width' 
 , 
 default 
 = 
 1200 
 , 
 help 
 = 
 'The width in pixels of the native ad 
 \' 
 s large image.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_logo_url' 
 , 
 default 
 = 
 'https://native.test.com/logo?id=123456' 
 , 
 help 
 = 
 'The URL of a smaller image to be included in the native ad.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_logo_height' 
 , 
 default 
 = 
 100 
 , 
 help 
 = 
 'The height in pixels of the native ad 
 \' 
 s smaller image.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_logo_width' 
 , 
 default 
 = 
 100 
 , 
 help 
 = 
 'The width in pixels of the native ad 
 \' 
 s smaller image.' 
 ), 
 parser 
 . 
 add_argument 
 ( 
 '--native_click_link_url' 
 , 
 default 
 = 
 'https://www.google.com' 
 , 
 help 
 = 
 ( 
 'The URL that the browser/SDK will load when the user clicks the ' 
 'ad.' 
 )), 
 parser 
 . 
 add_argument 
 ( 
 '--native_click_tracking_url' 
 , 
 default 
 = 
 'https://native.test.com/click?id=123456' 
 , 
 help 
 = 
 'The URL to use for click tracking.' 
 ), 
 args 
 = 
 parser 
 . 
 parse_args 
 () 
 main 
 ( 
 service 
 , 
 args 
 ) 

 #!/usr/bin/env ruby 
 # Encoding: utf-8 
 # 
 # Copyright:: Copyright 2020 Google LLC 
 # 
 # License:: 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. 
 # 
 # Creates a creative with native content for the given buyer account ID. 
 require 
  
 'optparse' 
 require 
  
 'securerandom' 
 require_relative 
  
 '../../../util' 
 def 
  
 create_native_creatives 
 ( 
 realtimebidding 
 , 
  
 options 
 ) 
  
 parent 
  
 = 
  
 "buyers/ 
 #{ 
 options 
 [ 
 :account_id 
 ] 
 } 
 " 
  
 body 
  
 = 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 Creative 
 . 
 new 
 ( 
  
 advertiser_name 
 : 
  
 options 
 [ 
 :advertiser_name 
 ] 
 , 
  
 creative_id 
 : 
  
 options 
 [ 
 :creative_id 
 ] 
 , 
  
 declared_attributes 
 : 
  
 options 
 [ 
 :declared_attributes 
 ] 
 , 
  
 declared_click_through_urls 
 : 
  
 options 
 [ 
 :declared_click_urls 
 ] 
 , 
  
 declared_resricted_categories 
 : 
  
 options 
 [ 
 :declared_restricted_categories 
 ] 
 , 
  
 declared_vendor_ids 
 : 
  
 options 
 [ 
 :declared_vendor_ids 
 ] 
 , 
  
 native 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 NativeContent 
 . 
 new 
 ( 
  
 headline 
 : 
  
 options 
 [ 
 :native_headline 
 ] 
 , 
  
 body 
 : 
  
 options 
 [ 
 :native_body 
 ] 
 , 
  
 call_to_action 
 : 
  
 options 
 [ 
 :native_call_to_action 
 ] 
 , 
  
 advertiser_name 
 : 
  
 options 
 [ 
 :native_advertiser_name 
 ] 
 , 
  
 image 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 Image 
 . 
 new 
 ( 
  
 url 
 : 
  
 options 
 [ 
 :native_image_url 
 ] 
 , 
  
 height 
 : 
  
 options 
 [ 
 :native_image_height 
 ] 
 , 
  
 width 
 : 
  
 options 
 [ 
 :native_image_width 
 ] 
  
 ), 
  
 logo 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 Image 
 . 
 new 
 ( 
  
 url 
 : 
  
 options 
 [ 
 :native_logo_url 
 ] 
 , 
  
 height 
 : 
  
 options 
 [ 
 :native_logo_height 
 ] 
 , 
  
 width 
 : 
  
 options 
 [ 
 :native_logo_width 
 ] 
  
 ), 
  
 click_link_url 
 : 
  
 options 
 [ 
 :native_click_link_url 
 ] 
 , 
  
 click_tracking_url 
 : 
  
 options 
 [ 
 :native_click_tracking_url 
 ] 
  
 ) 
  
 ) 
  
 puts 
  
 "Creating native creative for buyer account ' 
 #{ 
 parent 
 } 
 '" 
  
 creative 
  
 = 
  
 realtimebidding 
 . 
 create_buyer_creative 
 ( 
 parent 
 , 
  
 creative_object 
 = 
 body 
 ) 
  
 print_creative 
 ( 
 creative 
 ) 
 end 
 if 
  
 __FILE__ 
  
 == 
  
 $0 
  
 begin 
  
 # Retrieve the service used to make API requests. 
  
 service 
  
 = 
  
 get_service 
 () 
  
 rescue 
  
 ArgumentError 
  
 = 
>  
 e 
  
 raise 
  
 'Unable to create service, with error message: 
 #{ 
 e 
 . 
 message 
 } 
 ' 
  
 rescue 
  
 Signet 
 :: 
 AuthorizationError 
  
 = 
>  
 e 
  
 raise 
  
 'Unable to create service, was the KEY_FILE in util.rb set? Error message: 
 #{ 
 e 
 . 
 message 
 } 
 ' 
  
 end 
  
 # Set options and default values for fields used in this example. 
  
 options 
  
 = 
  
 [ 
  
 Option 
 . 
 new 
 ( 
  
 'account_id' 
 , 
  
 'The resource ID of the buyers resource under which the creatives were created, This will be used to construct ' 
 \ 
  
 'the name used as a path parameter for the creatives.get request.' 
 , 
  
 type 
 : 
  
 Integer 
 , 
  
 short_alias 
 : 
  
 'a' 
 , 
  
 required 
 : 
  
 true 
 , 
  
 default_value 
 : 
  
 nil 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'creative_id' 
 , 
  
 'The user-specified creative ID. The maximum length of the creative ID is 128 bytes.' 
 , 
  
 short_alias 
 : 
  
 'c' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 "Native_Creative_ 
 #{ 
 SecureRandom 
 . 
 uuid 
 } 
 " 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'advertiser_name' 
 , 
  
 'The name of the company being advertised in the creative.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'Test' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'declared_attributes' 
 , 
  
 'The creative attributes being declared. Specify each attribute separated by a comma.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [ 
 'NATIVE_ELIGIBILITY_ELIGIBLE' 
 ] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'declared_click_urls' 
 , 
  
 'The click-through URLs being declared. Specify each URL separated by a comma.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [ 
 'http://test.com' 
 ] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'declared_restricted_categories' 
 , 
  
 'The restricted categories being declared. Specify each category separated by a comma.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'declared_vendor_ids' 
 , 
  
 'The vendor IDs being declared. Specify each ID separated by a space.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
 'native_headline' 
 , 
  
 'A short title for the ad.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'Luxury Mars Cruises' 
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_body' 
 , 
  
 'A long description of the ad.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'Visit the planet in a luxury spaceship.' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_call_to_action' 
 , 
  
 'A label for the button that the user is supposed to click.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'Book today' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_advertiser_name' 
 , 
  
 'The name of the advertiser or sponsor, to be displayed in the ad creative' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'Galactic Luxury Cruises' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_image_url' 
 , 
  
 'The URL of the large image to be included in the native ad.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'https://native.test.com/image?id=123456' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_image_height' 
 , 
  
 'The height in pixels of the native ad 
 \' 
 s large image.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 627 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_image_width' 
 , 
  
 'The width in pixels of the native ad 
 \' 
 s large image.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 1200 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_logo_url' 
 , 
  
 'The URL of a smaller image to be included in the native ad.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'https://native.test.com/logo?id=123456' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_logo_height' 
 , 
  
 'The height in pixels of the native ad 
 \' 
 s smaller image.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 100 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_logo_width' 
 , 
  
 'The width in pixels of the native ad 
 \' 
 s smaller image.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 100 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_click_link_url' 
 , 
  
 'The URL that the browser/SDK will load when the user clicks the ad.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'https://www.google.com' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'native_click_tracking_url' 
 , 
  
 'The URL to use for click tracking.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'https://native.test.com/click?id=123456' 
  
 ), 
  
 ] 
  
 # Parse options. 
  
 parser 
  
 = 
  
 Parser 
 . 
 new 
 ( 
 options 
 ) 
  
 opts 
  
 = 
  
 parser 
 . 
 parse 
 ( 
 ARGV 
 ) 
  
 begin 
  
 create_native_creatives 
 ( 
 service 
 , 
  
 opts 
 ) 
  
 rescue 
  
 Google 
 :: 
 Apis 
 :: 
 ServerError 
  
 = 
>  
 e 
  
 raise 
  
 "The following server error occured: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 rescue 
  
 Google 
 :: 
 Apis 
 :: 
 ClientError 
  
 = 
>  
 e 
  
 raise 
  
 "Invalid client request: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 rescue 
  
 Google 
 :: 
 Apis 
 :: 
 AuthorizationError 
  
 = 
>  
 e 
  
 raise 
  
 "Authorization error occured: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 end 
 end