Creatives

The Creatives resource provides a way to submit new creatives to Google's creative verification pipeline.

For a list of methods for this resource, see the end of this page.

Resource representations

A creative and its classification data.

{
  "kind": "adexchangebuyer#creative",
  "accountId": integer,
  "buyerCreativeId": string,
  "agencyId": long,
  "HTMLSnippet": string,
  "videoURL": string,
  "clickThroughUrl": [
    string
  ],
  "vendorType": [
    integer
  ],
  "attribute": [
    integer
  ],
  "width": integer,
  "height": integer,
  "advertiserName": string,
  "status": string,
  "disapprovalReasons": [
    {
      "reason": string,
      "details": [
        string
      ]
    }
  ],
  "advertiserId": [
    long
  ],
  "sensitiveCategories": [
    integer
  ],
  "restrictedCategories": [
    integer
  ],
  "productCategories": [
    integer
  ],
  "corrections": [
    {
      "reason": string,
      "details": [
        string
      ]
    }
  ],
  "filteringReasons": {
    "date": string,
    "reasons": [
      {
        "filteringStatus": integer,
        "filteringCount": long
      }
    ]
  }
}
Property name Value Description Notes
HTMLSnippet string The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. writable
accountId integer Account ID.
advertiserId[] list Detected advertiser ID, if any. Read-only. This field should not be set in requests.
advertiserName string The name of the company being advertised in the creative.
agencyId long The agency id for this creative. writable
attribute[] list List of buyer selectable attributes for the ads that may be shown from this snippet. Each attribute is represented by an integer as defined in the buyer-declarable-creative-attributes.txt file. writable
buyerCreativeId string A buyer-specific ID identifying the creative in this ad.
clickThroughUrl[] list The set of destination URLs for the snippet.
corrections[] list Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests.
corrections[].details[] list Additional details about the correction.
corrections[].reason string The type of correction that was applied to the creative.

Acceptable values are:
  • "FLASHLESS_ATTRIBUTE"
  • "FLASH_ATTRIBUTE"
  • "REQUIRED_ATTRIBUTE"
  • "REQUIRED_VENDOR"
  • "SSL_ATTRIBUTE"
  • "SSL_ATTRIBUTE_ADDED"
  • "VENDOR_IDS"
disapprovalReasons[] list The reasons 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.
disapprovalReasons[].details[] list Additional details about the reason for disapproval.
disapprovalReasons[].reason string The categorized reason for disapproval.

Acceptable values are:
  • "ADULT_IMAGE_OR_VIDEO"
  • "AD_SIZE_DOES_NOT_MATCH_AD_SLOT"
  • "AUTOMATED_AD_CLICKING"
  • "BAD_URL_LEGAL_DISAPPROVAL"
  • "BLANK_CREATIVE"
  • "BROKEN_URL"
  • "CLICK_TO_DOWNLOAD_NOT_AN_APP"
  • "COUNTERFEIT_DESIGNER_GOODS"
  • "DANGEROUS_PRODUCTS_DRUGS"
  • "DANGEROUS_PRODUCTS_EXPLOSIVES"
  • "DANGEROUS_PRODUCTS_GUNS"
  • "DANGEROUS_PRODUCTS_KNIVES"
  • "DANGEROUS_PRODUCTS_TOBACCO"
  • "DANGEROUS_PRODUCTS_WEAPONS"
  • "DESTINATION_SITE_DOES_NOT_ALLOW_GOING_BACK"
  • "DESTINATION_SITE_NOT_CRAWLABLE_ROBOTS_TXT"
  • "DESTINATION_URLS_UNDECLARED"
  • "DESTINATION_URL_SITE_NOT_CRAWLABLE"
  • "DIRECT_DOWNLOAD_IN_AD"
  • "DYNAMIC_DNS_AT_DESTINATION_URL"
  • "DYSFUNCTIONAL_PROMOTION"
  • "ENABLING_DISHONEST_BEHAVIOR"
  • "EXPANDABLE_DIRECTION_NOT_SUPPORTED"
  • "EXPANDABLE_FUNCTIONALITY"
  • "EXPANDABLE_INCORRECT_DIRECTION"
  • "EXPANDABLE_INVALID_VENDOR"
  • "FOURTH_PARTY_BROWSER_COOKIES"
  • "GAINING_AN_UNFAIR_ADVANTAGE"
  • "GAMING_THE_GOOGLE_NETWORK"
  • "INACCURATE_AD_TEXT"
  • "INACCURATE_REVIEW_EXTENSION"
  • "INAPPROPRIATE_CONTENT"
  • "INCORRECT_AD_TECHNOLOGY_DECLARATION"
  • "INCORRECT_DESTINATION_URL_DECLARATION"
  • "INCORRECT_IMAGE_LAYOUT"
  • "INCORRECT_REMARKETING_DECLARATION"
  • "INVALID_BIDDING_METHOD"
  • "INVALID_CREATIVE_DOWNLOAD_SIZE"
  • "INVALID_FOURTH_PARTY_CALL"
  • "INVALID_INTEREST_BASED_AD"
  • "INVALID_REMARKETING_LIST_USAGE"
  • "INVALID_RTB_PROTOCOL_USAGE"
  • "INVALID_SSL_DECLARATION"
  • "INVALID_URL_PROTOCOL"
  • "IRRELEVANT_IMAGE_OR_VIDEO"
  • "LANDING_PAGE_DISABLED"
  • "LANDING_PAGE_ERROR"
  • "LENGTH_OF_IMAGE_ANIMATION"
  • "LSO_OBJECTS"
  • "MALWARE_SUSPECTED"
  • "MEDIA_NOT_FUNCTIONAL"
  • "MISLEADING_CLAIMS_IN_AD"
  • "MISLEADING_PROMOTIONS"
  • "MISUSE_OF_PERSONAL_INFORMATION"
  • "NO_BORDER"
  • "OMISSION_OF_RELEVANT_INFORMATION"
  • "PHARMA_GAMBLING_ALCOHOL_NOT_ALLOWED"
  • "POOR_IMAGE_OR_VIDEO_QUALITY"
  • "POP_UP"
  • "PROBLEM_WITH_CLICK_MACRO"
  • "PROFESSIONAL_STANDARDS"
  • "RAW_IP_ADDRESS_IN_SNIPPET"
  • "RESTRICTED_POLITICAL_CONTENT"
  • "RESTRICTED_PRODUCTS"
  • "SENSITIVE_EVENTS"
  • "SEXUALLY_EXPLICIT_CONTENT"
  • "SHOCKING_CONTENT"
  • "TECHNICAL_REQUIREMENTS"
  • "UNACCEPTABLE_CONTENT"
  • "UNACCEPTABLE_CONTENT_SOFTWARE"
  • "UNACCEPTABLE_IMAGE_CONTENT"
  • "UNAUTHORIZED_COOKIE_ON_GOOGLE_DOMAIN"
  • "UNAVAILABLE_PROMOTIONS"
  • "UNCLEAR_OR_IRRELEVANT_AD"
  • "UNDECLARED_FLASH_OBJECTS"
  • "UNDECLARED_RESTRICTED_CONTENT"
  • "UNSUPPORTED_CONTENT"
  • "VIDEO_FUNCTIONALITY"
  • "VIDEO_INVALID_VENDOR"
  • "VIDEO_UNSUPPORTED_FORMAT"
  • "VIDEO_UNSUPPORTED_LENGTH"
filteringReasons object The filtering reasons for the creative. Read-only. This field should not be set in requests.
filteringReasons.date string The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
filteringReasons.reasons[] list The filtering reasons.
filteringReasons.reasons[].filteringCount long The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.
filteringReasons.reasons[].filteringStatus integer The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.
height integer Ad height in pixels.
kind string Resource type. This is always "adexchangebuyer#creative".
productCategories[] list Detected product categories, if any. Read-only. Each category is represented by an integer as defined in the ad-product-categories.txt file. This field should not be set in requests.
restrictedCategories[] list All restricted categories for the ads that may be shown from this snippet. Each category is represented by an integer as defined in the ad-restricted-categories.txt file. writable
sensitiveCategories[] list Detected sensitive categories, if any. Read-only. Each category is represented by an integer as defined in the ad-sensitive-categories.txt file. This field should not be set in requests.
status string Creative serving status. Read-only. This field should not be set in requests.

Acceptable values are:
  • "APPROVED"
  • "DISAPPROVED"
  • "NOT_CHECKED"
  • "UNKNOWN"
vendorType[] list List of vendor types for the ads that may be shown from this snippet. Each vendor type is represented by an integer as defined in the vendors.txt file. writable
videoURL string The URL from which a video ad loads; that is, the URL to use to fetch that video ad. The resource at this URL is usually an XML document that contains a standard format for loading the video, plus tracking information. This is not the same as an HTML snippet, which is only for non-video ads. If set, HTMLSnippet should not be set. writable
width integer Ad width in pixels.

Methods

get
Gets the status for a single creative. A creative will be available 30-40 minutes after submission.
insert
Inserts a new creative into Google's creative verification pipeline.
list
Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.