get(accountId, buyerCreativeId, adgroupId)
Gets the status for a single creative.
Submit a new creative.
list(pageToken=None, maxResults=None)
Retrieves a list of the authenticated user's active creatives.
get(accountId, buyerCreativeId, adgroupId)
Gets the status for a single creative. Args: accountId: integer, The id for the account that will serve this creative. (required) buyerCreativeId: string, The buyer-specific id for this creative. (required) adgroupId: string, The adgroup this creative belongs to. (required) Returns: An object of the form: { "productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests. 42, ], "advertiserName": "A String", # The name of the company being advertised in the creative. "adgroupId": "A String", # The pretargeting adgroup id that this creative will be associated with. "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set. "width": 42, # Ad width. "attribute": [ # All attributes for the ads that may be shown from this snippet. 42, ], "kind": "adexchangebuyer#creative", # Resource type. "height": 42, # Ad height. "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. "A String", ], "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. "status": "A String", # Creative serving status. Read-only. This field should not be set in requests. "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. "clickThroughUrl": [ # The set of destination urls for the snippet. "A String", ], "vendorType": [ # All vendor types for the ads that may be shown from this snippet. 42, ], "disapprovalReasons": [ # The reason for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests. "A String", ], "sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests. 42, ], "accountId": 42, # Account id. }
insert(body)
Submit a new creative. Args: body: object, The request body. (required) The object takes the form of: { "productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests. 42, ], "advertiserName": "A String", # The name of the company being advertised in the creative. "adgroupId": "A String", # The pretargeting adgroup id that this creative will be associated with. "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set. "width": 42, # Ad width. "attribute": [ # All attributes for the ads that may be shown from this snippet. 42, ], "kind": "adexchangebuyer#creative", # Resource type. "height": 42, # Ad height. "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. "A String", ], "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. "status": "A String", # Creative serving status. Read-only. This field should not be set in requests. "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. "clickThroughUrl": [ # The set of destination urls for the snippet. "A String", ], "vendorType": [ # All vendor types for the ads that may be shown from this snippet. 42, ], "disapprovalReasons": [ # The reason for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests. "A String", ], "sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests. 42, ], "accountId": 42, # Account id. } Returns: An object of the form: { "productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests. 42, ], "advertiserName": "A String", # The name of the company being advertised in the creative. "adgroupId": "A String", # The pretargeting adgroup id that this creative will be associated with. "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set. "width": 42, # Ad width. "attribute": [ # All attributes for the ads that may be shown from this snippet. 42, ], "kind": "adexchangebuyer#creative", # Resource type. "height": 42, # Ad height. "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. "A String", ], "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. "status": "A String", # Creative serving status. Read-only. This field should not be set in requests. "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. "clickThroughUrl": [ # The set of destination urls for the snippet. "A String", ], "vendorType": [ # All vendor types for the ads that may be shown from this snippet. 42, ], "disapprovalReasons": [ # The reason for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests. "A String", ], "sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests. 42, ], "accountId": 42, # Account id. }
list(pageToken=None, maxResults=None)
Retrieves a list of the authenticated user's active creatives. Args: pageToken: string, A continuation token, used to page through ad clients. To retrieve the next page, set this parameter to the value of "nextPageToken" from the previous response. Optional. maxResults: integer, Maximum number of entries returned on one result page. If not set, the default is 100. Optional. Returns: An object of the form: { "items": [ # A list of creatives. { "productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests. 42, ], "advertiserName": "A String", # The name of the company being advertised in the creative. "adgroupId": "A String", # The pretargeting adgroup id that this creative will be associated with. "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set. "width": 42, # Ad width. "attribute": [ # All attributes for the ads that may be shown from this snippet. 42, ], "kind": "adexchangebuyer#creative", # Resource type. "height": 42, # Ad height. "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. "A String", ], "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. "status": "A String", # Creative serving status. Read-only. This field should not be set in requests. "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. "clickThroughUrl": [ # The set of destination urls for the snippet. "A String", ], "vendorType": [ # All vendor types for the ads that may be shown from this snippet. 42, ], "disapprovalReasons": [ # The reason for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests. "A String", ], "sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests. 42, ], "accountId": 42, # Account id. }, ], "kind": "adexchangebuyer#creativesList", # Resource type. }