Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1350108168.1 KB
accounts

Creates a creative.

post/v2beta1/accounts/{accountId}/creatives

Path parameters

accountIdstring required

The account that this creative belongs to. Can be used to filter the response of the creatives.list method.

Query parameters

duplicateIdMode'NO_DUPLICATES' | 'FORCE_ENABLE_DUPLICATE_IDS'

Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative).

Request body

agencyIdstring int64

The agency ID for this creative.

apiUpdateTimestring google-datetime

Output only. The last update timestamp of the creative through the API.

dealsStatus'STATUS_UNSPECIFIED' | 'NOT_CHECKED' | 'CONDITIONALLY_APPROVED' | 'APPROVED' | 'DISAPPROVED' | 'PENDING_REVIEW' | 'STATUS_TYPE_UNSPECIFIED'

Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.

adChoicesDestinationUrlstring

The link to AdChoices destination page.

vendorIdsinteger[]

All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.

creativeIdstring

The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.

declaredClickThroughUrlsstring[]

The set of declared destination URLs for the creative.

restrictedCategoriesstring[]

All restricted categories for the ads that may be shown from this creative.

accountIdstring

The account that this creative belongs to. Can be used to filter the response of the creatives.list method.

detectedAdvertiserIdsstring[]

Output only. Detected advertiser IDs, if any.

detectedProductCategoriesinteger[]

Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.

openAuctionStatus'STATUS_UNSPECIFIED' | 'NOT_CHECKED' | 'CONDITIONALLY_APPROVED' | 'APPROVED' | 'DISAPPROVED' | 'PENDING_REVIEW' | 'STATUS_TYPE_UNSPECIFIED'

Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.

clickThroughUrlsstring[]

The set of destination URLs for the creative.

detectedSensitiveCategoriesinteger[]

Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.

versioninteger

Output only. The version of this creative.

impressionTrackingUrlsstring[]

The set of URLs to be called to record an impression.

attributesstring[]

All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.

advertiserNamestring

The name of the company being advertised in the creative.

detectedDomainsstring[]

Output only. The detected domains for this creative.

detectedLanguagesstring[]

Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.

Response

Successful response