GOgoogle
accounts

POST /v2beta1/accounts/{accountId}/creatives

Changed on

Creates a creative.

Request

  • Base URL
    https://adexchangebuyer.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/adexchange.buyer
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/adexchange.buyer

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

accountIdstring

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

adChoicesDestinationUrlstring

The link to AdChoices destination page.

advertiserNamestring

The name of the company being advertised in the creative.

agencyIdstring int64

The agency ID for this creative.

apiUpdateTimestring google-datetime

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

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.

clickThroughUrlsstring[]

The set of destination URLs for the creative.

creativeIdstring

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

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.

declaredClickThroughUrlsstring[]

The set of declared destination URLs for the creative.

detectedAdvertiserIdsstring[]

Output only. Detected advertiser IDs, if any.

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.

detectedProductCategoriesinteger[]

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

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.

impressionTrackingUrlsstring[]

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

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.

restrictedCategoriesstring[]

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

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.

versioninteger

Output only. The version of this creative.

Response

Successful response

accountIdstring

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

adChoicesDestinationUrlstring

The link to AdChoices destination page.

advertiserNamestring

The name of the company being advertised in the creative.

agencyIdstring int64

The agency ID for this creative.

apiUpdateTimestring google-datetime

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

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.

clickThroughUrlsstring[]

The set of destination URLs for the creative.

creativeIdstring

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

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.

declaredClickThroughUrlsstring[]

The set of declared destination URLs for the creative.

detectedAdvertiserIdsstring[]

Output only. Detected advertiser IDs, if any.

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.

detectedProductCategoriesinteger[]

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

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.

impressionTrackingUrlsstring[]

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

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.

restrictedCategoriesstring[]

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

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.

versioninteger

Output only. The version of this creative.

Changes

  • af1a744df07bRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status