Activate resources

After creating and configuring your Demand Gen resources, you can update their entityStatus fields to ENTITY_STATUS_ACTIVE to begin serving ads. All three resources must be active to begin serving ads.

LineItem resources must be created with the "draft" EntityStatus and activated in a subsequent request. AdGroup and AdGroupAd resources can be created with the "active" EntityStatus , but it is recommended that you create these resources with a "paused" status. That way you can assign targeting and verify correct configuration before activating the resources in subsequent requests.

Activate line item

Here's how to activate a line item:

Python

 # The ID of the line item's parent advertiser. 
 advertiser_id 
 = 
  advertiser 
 - 
 id 
 
 # The ID of the Demand Gen line item. 
 line_item_id 
 = 
  line 
 - 
 item 
 - 
 id 
 
 line_item_obj 
 = 
 { 
 "entityStatus" 
 : 
 "ENTITY_STATUS_ACTIVE" 
 , 
 } 
 # Build and execute request. 
 response 
 = 
 ( 
 service 
 . 
 advertisers 
 () 
 . 
 lineItems 
 () 
 . 
 patch 
 ( 
 advertiserId 
 = 
 advertiser_id 
 , 
 lineItemId 
 = 
 line_item_id 
 , 
 updateMask 
 = 
 "entityStatus" 
 , 
 body 
 = 
 line_item_obj 
 , 
 ) 
 . 
 execute 
 () 
 ) 
 # Display the line item's new entity status 
 print 
 ( 
 f 
 "Line item 
 { 
 response 
 [ 
 'name' 
 ] 
 } 
 now has entity status " 
 f 
 " 
 { 
 response 
 [ 
 'entityStatus' 
 ] 
 } 
 ." 
 ) 

Activate ad group

Here's how to activate an ad group:

Python

 # The ID of the ad group's parent advertiser. 
 advertiser_id 
 = 
  advertiser 
 - 
 id 
 
 # The ID of the Demand Gen ad group. 
 ad_group_id 
 = 
  ad 
 - 
 group 
 - 
 id 
 
 ad_group_obj 
 = 
 { 
 "entityStatus" 
 : 
 "ENTITY_STATUS_ACTIVE" 
 , 
 } 
 # Build and execute request. 
 response 
 = 
 ( 
 service 
 . 
 advertisers 
 () 
 . 
 adGroups 
 () 
 . 
 patch 
 ( 
 advertiserId 
 = 
 advertiser_id 
 , 
 adGroupId 
 = 
 ad_group_id 
 , 
 updateMask 
 = 
 "entityStatus" 
 , 
 body 
 = 
 ad_group_obj 
 , 
 ) 
 . 
 execute 
 () 
 ) 
 # Display the ad group's new entity status 
 print 
 ( 
 f 
 "Ad group 
 { 
 response 
 [ 
 'name' 
 ] 
 } 
 now has entity status " 
 f 
 " 
 { 
 response 
 [ 
 'entityStatus' 
 ] 
 } 
 ." 
 ) 

Activate ad

Here's how to activate an ad:

Python

 # The ID of the ad's parent advertiser. 
 advertiser_id 
 = 
  advertiser 
 - 
 id 
 
 # The ID of the Demand Gen ad. 
 ad_id 
 = 
  ad 
 - 
 group 
 - 
 ad 
 - 
 id 
 
 ad_obj 
 = 
 { 
 "entityStatus" 
 : 
 "ENTITY_STATUS_ACTIVE" 
 , 
 } 
 # Build and execute request. 
 response 
 = 
 ( 
 service 
 . 
 advertisers 
 () 
 . 
 adGroupAds 
 () 
 . 
 patch 
 ( 
 advertiserId 
 = 
 advertiser_id 
 , 
 adGroupAdId 
 = 
 ad_id 
 , 
 updateMask 
 = 
 "entityStatus" 
 , 
 body 
 = 
 ad_obj 
 , 
 ) 
 . 
 execute 
 () 
 ) 
 # Display the ad's new entity status 
 print 
 ( 
 f 
 "Ad 
 { 
 response 
 [ 
 'name' 
 ] 
 } 
 now has entity status " 
 f 
 " 
 { 
 response 
 [ 
 'entityStatus' 
 ] 
 } 
 ." 
 ) 
Create a Mobile Website
View Site in Mobile | Classic
Share by: