--- title: "GET /v2beta1/accounts/{accountId}/creatives" method: GET path: "/v2beta1/accounts/{accountId}/creatives" tags: ["accounts"] --- # GET /v2beta1/accounts/{accountId}/creatives `GET /v2beta1/accounts/{accountId}/creatives` ## Request - Base URL: `https://adexchangebuyer.googleapis.com` - URL: `https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/creatives` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/adexchange.buyer` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/adexchange.buyer` Lists creatives. ## Path parameters - `accountId` string, required ## Query parameters - `pageSize` integer - `pageToken` string - `query` string ## Response `200` Successful response - ListCreativesResponse: A response for listing creatives. - `creatives` Creative[]: The list of creatives. - `accountId` string: The account that this creative belongs to. Can be used to filter the response of the creatives.list method. - `adChoicesDestinationUrl` string: The link to AdChoices destination page. - `adTechnologyProviders` AdTechnologyProviders: Detected ad technology provider information. - `detectedProviderIds` string[]: The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. - `hasUnidentifiedProvider` boolean: Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. - `advertiserName` string: The name of the company being advertised in the creative. - `agencyId` string, int64: The agency ID for this creative. - `apiUpdateTime` string, google-datetime: Output only. The last update timestamp of the creative through the API. - `attributes` string[]: All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. - `clickThroughUrls` string[]: The set of destination URLs for the creative. - `corrections` Correction[]: Output only. Shows any corrections that were applied to this creative. - `contexts` ServingContext[]: The contexts for the correction. - `all` 'SIMPLE_CONTEXT': Matches all contexts. - `appType` AppContext: Output only. The app type the restriction applies to for mobile device. - `appTypes` string[]: The app types this restriction applies to. - `auctionType` AuctionContext: Output only. The auction type the restriction applies to. - `auctionTypes` string[]: The auction types this restriction applies to. - `location` LocationContext: Output only. The Geo criteria the restriction applies to. - `geoCriteriaIds` integer[]: IDs representing the geo location for this context. Refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. - `platform` PlatformContext: Output only. The type of platform the restriction applies to. - `platforms` string[]: The platforms this restriction applies to. - `securityType` SecurityContext: Output only. A security context. - `securities` string[]: The security types in this context. - `details` string[]: Additional details about what was corrected. - `type` 'CORRECTION_TYPE_UNSPECIFIED' | 'VENDOR_IDS_ADDED' | 'SSL_ATTRIBUTE_REMOVED' | 'FLASH_FREE_ATTRIBUTE_REMOVED' | 'FLASH_FREE_ATTRIBUTE_ADDED' | 'REQUIRED_ATTRIBUTE_ADDED' | 'REQUIRED_VENDOR_ADDED' | 'SSL_ATTRIBUTE_ADDED' | 'IN_BANNER_VIDEO_ATTRIBUTE_ADDED' | 'MRAID_ATTRIBUTE_ADDED' | 'FLASH_ATTRIBUTE_REMOVED' | 'VIDEO_IN_SNIPPET_ATTRIBUTE_ADDED': The type of correction that was applied to the creative. - `creativeId` string: 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. - `declaredClickThroughUrls` string[]: The set of declared destination URLs for the creative. - `detectedAdvertiserIds` string[]: Output only. Detected advertiser IDs, if any. - `detectedDomains` string[]: Output only. The detected domains for this creative. - `detectedLanguages` string[]: 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. - `detectedProductCategories` integer[]: Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. - `detectedSensitiveCategories` integer[]: 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. - `html` HtmlContent: HTML content for a creative. - `height` integer: The height of the HTML snippet in pixels. - `snippet` string: The HTML snippet that displays the ad when inserted in the web page. - `width` integer: The width of the HTML snippet in pixels. - `impressionTrackingUrls` string[]: The set of URLs to be called to record an impression. - `native` NativeContent: Native content for a creative. - `advertiserName` string: The name of the advertiser or sponsor, to be displayed in the ad creative. - `appIcon` Image: An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. - `height` integer: Image height in pixels. - `url` string: The URL of the image. - `width` integer: Image width in pixels. - `body` string: A long description of the ad. - `callToAction` string: A label for the button that the user is supposed to click. - `clickLinkUrl` string: The URL that the browser/SDK will load when the user clicks the ad. - `clickTrackingUrl` string: The URL to use for click tracking. - `headline` string: A short title for the ad. - `image` Image: An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. - `height` integer: Image height in pixels. - `url` string: The URL of the image. - `width` integer: Image width in pixels. - `logo` Image: An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. - `height` integer: Image height in pixels. - `url` string: The URL of the image. - `width` integer: Image width in pixels. - `priceDisplayText` string: The price of the promoted app including currency info. - `starRating` number, double: The app rating in the app store. Must be in the range [0-5]. - `storeUrl` string: The URL to the app store to purchase/download the promoted app. - `videoUrl` string: The URL to fetch a native video ad. - `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. - `restrictedCategories` string[]: All restricted categories for the ads that may be shown from this creative. - `servingRestrictions` ServingRestriction[]: Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS versus HTTP request, or the type of auction). - `contexts` ServingContext[]: The contexts for the restriction. - `all` 'SIMPLE_CONTEXT': Matches all contexts. - `appType` AppContext: Output only. The app type the restriction applies to for mobile device. - `appTypes` string[]: The app types this restriction applies to. - `auctionType` AuctionContext: Output only. The auction type the restriction applies to. - `auctionTypes` string[]: The auction types this restriction applies to. - `location` LocationContext: Output only. The Geo criteria the restriction applies to. - `geoCriteriaIds` integer[]: IDs representing the geo location for this context. Refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. - `platform` PlatformContext: Output only. The type of platform the restriction applies to. - `platforms` string[]: The platforms this restriction applies to. - `securityType` SecurityContext: Output only. A security context. - `securities` string[]: The security types in this context. - `disapproval` Disapproval: Output only. The reason and details for a disapproval. - `details` string[]: Additional details about the reason for disapproval. - `reason` 'LENGTH_OF_IMAGE_ANIMATION' | 'BROKEN_URL' | 'MEDIA_NOT_FUNCTIONAL' | 'INVALID_FOURTH_PARTY_CALL' | 'INCORRECT_REMARKETING_DECLARATION' | 'LANDING_PAGE_ERROR' | 'AD_SIZE_DOES_NOT_MATCH_AD_SLOT' | 'NO_BORDER' | 'FOURTH_PARTY_BROWSER_COOKIES' | 'LSO_OBJECTS' | 'BLANK_CREATIVE' | 'DESTINATION_URLS_UNDECLARED' | 'PROBLEM_WITH_CLICK_MACRO' | 'INCORRECT_AD_TECHNOLOGY_DECLARATION' | 'INCORRECT_DESTINATION_URL_DECLARATION' | 'EXPANDABLE_INCORRECT_DIRECTION' | 'EXPANDABLE_DIRECTION_NOT_SUPPORTED' | 'EXPANDABLE_INVALID_VENDOR' | 'EXPANDABLE_FUNCTIONALITY' | 'VIDEO_INVALID_VENDOR' | 'VIDEO_UNSUPPORTED_LENGTH' | 'VIDEO_UNSUPPORTED_FORMAT' | 'VIDEO_FUNCTIONALITY' | 'LANDING_PAGE_DISABLED' | 'MALWARE_SUSPECTED' | 'ADULT_IMAGE_OR_VIDEO' | 'INACCURATE_AD_TEXT' | 'COUNTERFEIT_DESIGNER_GOODS' | 'POP_UP' | 'INVALID_RTB_PROTOCOL_USAGE' | 'RAW_IP_ADDRESS_IN_SNIPPET' | 'UNACCEPTABLE_CONTENT_SOFTWARE' | 'UNAUTHORIZED_COOKIE_ON_GOOGLE_DOMAIN' | 'UNDECLARED_FLASH_OBJECTS' | 'INVALID_SSL_DECLARATION' | 'DIRECT_DOWNLOAD_IN_AD' | 'MAXIMUM_DOWNLOAD_SIZE_EXCEEDED' | 'DESTINATION_URL_SITE_NOT_CRAWLABLE' | 'BAD_URL_LEGAL_DISAPPROVAL' | 'PHARMA_GAMBLING_ALCOHOL_NOT_ALLOWED' | 'DYNAMIC_DNS_AT_DESTINATION_URL' | 'POOR_IMAGE_OR_VIDEO_QUALITY' | 'UNACCEPTABLE_IMAGE_CONTENT' | 'INCORRECT_IMAGE_LAYOUT' | 'IRRELEVANT_IMAGE_OR_VIDEO' | 'DESTINATION_SITE_DOES_NOT_ALLOW_GOING_BACK' | 'MISLEADING_CLAIMS_IN_AD' | 'RESTRICTED_PRODUCTS' | 'UNACCEPTABLE_CONTENT' | 'AUTOMATED_AD_CLICKING' | 'INVALID_URL_PROTOCOL' | 'UNDECLARED_RESTRICTED_CONTENT' | 'INVALID_REMARKETING_LIST_USAGE' | 'DESTINATION_SITE_NOT_CRAWLABLE_ROBOTS_TXT' | 'CLICK_TO_DOWNLOAD_NOT_AN_APP' | 'INACCURATE_REVIEW_EXTENSION' | 'SEXUALLY_EXPLICIT_CONTENT' | 'GAINING_AN_UNFAIR_ADVANTAGE' | 'GAMING_THE_GOOGLE_NETWORK' | 'DANGEROUS_PRODUCTS_KNIVES' | 'DANGEROUS_PRODUCTS_EXPLOSIVES' | 'DANGEROUS_PRODUCTS_GUNS' | 'DANGEROUS_PRODUCTS_DRUGS' | 'DANGEROUS_PRODUCTS_TOBACCO' | 'DANGEROUS_PRODUCTS_WEAPONS' | 'UNCLEAR_OR_IRRELEVANT_AD' | 'PROFESSIONAL_STANDARDS' | 'DYSFUNCTIONAL_PROMOTION' | 'INVALID_INTEREST_BASED_AD' | 'MISUSE_OF_PERSONAL_INFORMATION' | 'OMISSION_OF_RELEVANT_INFORMATION' | 'UNAVAILABLE_PROMOTIONS' | 'MISLEADING_PROMOTIONS' | 'INAPPROPRIATE_CONTENT' | 'SENSITIVE_EVENTS' | 'SHOCKING_CONTENT' | 'ENABLING_DISHONEST_BEHAVIOR' | 'TECHNICAL_REQUIREMENTS' | 'RESTRICTED_POLITICAL_CONTENT' | 'UNSUPPORTED_CONTENT' | 'INVALID_BIDDING_METHOD' | 'VIDEO_TOO_LONG' | 'VIOLATES_JAPANESE_PHARMACY_LAW' | 'UNACCREDITED_PET_PHARMACY' | 'ABORTION' | 'CONTRACEPTIVES' | 'NEED_CERTIFICATES_TO_ADVERTISE_IN_CHINA' | 'KCDSP_REGISTRATION' | 'NOT_FAMILY_SAFE' | 'CLINICAL_TRIAL_RECRUITMENT' | 'MAXIMUM_NUMBER_OF_HTTP_CALLS_EXCEEDED' | 'MAXIMUM_NUMBER_OF_COOKIES_EXCEEDED' | 'PERSONAL_LOANS' | 'UNSUPPORTED_FLASH_CONTENT' | 'MISUSE_BY_OMID_SCRIPT' | 'NON_WHITELISTED_OMID_VENDOR' | 'DESTINATION_EXPERIENCE' | 'UNSUPPORTED_LANGUAGE' | 'NON_SSL_COMPLIANT' | 'TEMPORARY_PAUSE' | 'BAIL_BONDS' | 'EXPERIMENTAL_MEDICAL_TREATMENT': The categorized reason for disapproval. - `disapprovalReasons` Disapproval[]: Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; use disapproval field instead. - `details` string[]: Additional details about the reason for disapproval. - `reason` 'LENGTH_OF_IMAGE_ANIMATION' | 'BROKEN_URL' | 'MEDIA_NOT_FUNCTIONAL' | 'INVALID_FOURTH_PARTY_CALL' | 'INCORRECT_REMARKETING_DECLARATION' | 'LANDING_PAGE_ERROR' | 'AD_SIZE_DOES_NOT_MATCH_AD_SLOT' | 'NO_BORDER' | 'FOURTH_PARTY_BROWSER_COOKIES' | 'LSO_OBJECTS' | 'BLANK_CREATIVE' | 'DESTINATION_URLS_UNDECLARED' | 'PROBLEM_WITH_CLICK_MACRO' | 'INCORRECT_AD_TECHNOLOGY_DECLARATION' | 'INCORRECT_DESTINATION_URL_DECLARATION' | 'EXPANDABLE_INCORRECT_DIRECTION' | 'EXPANDABLE_DIRECTION_NOT_SUPPORTED' | 'EXPANDABLE_INVALID_VENDOR' | 'EXPANDABLE_FUNCTIONALITY' | 'VIDEO_INVALID_VENDOR' | 'VIDEO_UNSUPPORTED_LENGTH' | 'VIDEO_UNSUPPORTED_FORMAT' | 'VIDEO_FUNCTIONALITY' | 'LANDING_PAGE_DISABLED' | 'MALWARE_SUSPECTED' | 'ADULT_IMAGE_OR_VIDEO' | 'INACCURATE_AD_TEXT' | 'COUNTERFEIT_DESIGNER_GOODS' | 'POP_UP' | 'INVALID_RTB_PROTOCOL_USAGE' | 'RAW_IP_ADDRESS_IN_SNIPPET' | 'UNACCEPTABLE_CONTENT_SOFTWARE' | 'UNAUTHORIZED_COOKIE_ON_GOOGLE_DOMAIN' | 'UNDECLARED_FLASH_OBJECTS' | 'INVALID_SSL_DECLARATION' | 'DIRECT_DOWNLOAD_IN_AD' | 'MAXIMUM_DOWNLOAD_SIZE_EXCEEDED' | 'DESTINATION_URL_SITE_NOT_CRAWLABLE' | 'BAD_URL_LEGAL_DISAPPROVAL' | 'PHARMA_GAMBLING_ALCOHOL_NOT_ALLOWED' | 'DYNAMIC_DNS_AT_DESTINATION_URL' | 'POOR_IMAGE_OR_VIDEO_QUALITY' | 'UNACCEPTABLE_IMAGE_CONTENT' | 'INCORRECT_IMAGE_LAYOUT' | 'IRRELEVANT_IMAGE_OR_VIDEO' | 'DESTINATION_SITE_DOES_NOT_ALLOW_GOING_BACK' | 'MISLEADING_CLAIMS_IN_AD' | 'RESTRICTED_PRODUCTS' | 'UNACCEPTABLE_CONTENT' | 'AUTOMATED_AD_CLICKING' | 'INVALID_URL_PROTOCOL' | 'UNDECLARED_RESTRICTED_CONTENT' | 'INVALID_REMARKETING_LIST_USAGE' | 'DESTINATION_SITE_NOT_CRAWLABLE_ROBOTS_TXT' | 'CLICK_TO_DOWNLOAD_NOT_AN_APP' | 'INACCURATE_REVIEW_EXTENSION' | 'SEXUALLY_EXPLICIT_CONTENT' | 'GAINING_AN_UNFAIR_ADVANTAGE' | 'GAMING_THE_GOOGLE_NETWORK' | 'DANGEROUS_PRODUCTS_KNIVES' | 'DANGEROUS_PRODUCTS_EXPLOSIVES' | 'DANGEROUS_PRODUCTS_GUNS' | 'DANGEROUS_PRODUCTS_DRUGS' | 'DANGEROUS_PRODUCTS_TOBACCO' | 'DANGEROUS_PRODUCTS_WEAPONS' | 'UNCLEAR_OR_IRRELEVANT_AD' | 'PROFESSIONAL_STANDARDS' | 'DYSFUNCTIONAL_PROMOTION' | 'INVALID_INTEREST_BASED_AD' | 'MISUSE_OF_PERSONAL_INFORMATION' | 'OMISSION_OF_RELEVANT_INFORMATION' | 'UNAVAILABLE_PROMOTIONS' | 'MISLEADING_PROMOTIONS' | 'INAPPROPRIATE_CONTENT' | 'SENSITIVE_EVENTS' | 'SHOCKING_CONTENT' | 'ENABLING_DISHONEST_BEHAVIOR' | 'TECHNICAL_REQUIREMENTS' | 'RESTRICTED_POLITICAL_CONTENT' | 'UNSUPPORTED_CONTENT' | 'INVALID_BIDDING_METHOD' | 'VIDEO_TOO_LONG' | 'VIOLATES_JAPANESE_PHARMACY_LAW' | 'UNACCREDITED_PET_PHARMACY' | 'ABORTION' | 'CONTRACEPTIVES' | 'NEED_CERTIFICATES_TO_ADVERTISE_IN_CHINA' | 'KCDSP_REGISTRATION' | 'NOT_FAMILY_SAFE' | 'CLINICAL_TRIAL_RECRUITMENT' | 'MAXIMUM_NUMBER_OF_HTTP_CALLS_EXCEEDED' | 'MAXIMUM_NUMBER_OF_COOKIES_EXCEEDED' | 'PERSONAL_LOANS' | 'UNSUPPORTED_FLASH_CONTENT' | 'MISUSE_BY_OMID_SCRIPT' | 'NON_WHITELISTED_OMID_VENDOR' | 'DESTINATION_EXPERIENCE' | 'UNSUPPORTED_LANGUAGE' | 'NON_SSL_COMPLIANT' | 'TEMPORARY_PAUSE' | 'BAIL_BONDS' | 'EXPERIMENTAL_MEDICAL_TREATMENT': The categorized reason for disapproval. - `status` 'STATUS_UNSPECIFIED' | 'DISAPPROVAL' | 'PENDING_REVIEW': The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). - `vendorIds` integer[]: 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. - `version` integer: Output only. The version of this creative. - `video` VideoContent: Video content for a creative. - `videoUrl` string: The URL to fetch a video ad. - `videoVastXml` string: The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. - `nextPageToken` string: A token to retrieve the next page of results. Pass this value in the ListCreativesRequest.page_token field in the subsequent call to `ListCreatives` method to retrieve the next page of results. ## Changes - **2026-10-10** `af1a744df07b`: 1 breaking - removed the media type `*/*` for the response with the status `200` [Operation history](https://skmtc.dev/google/apis/adexchangebuyer2/changes/v2beta1/accounts/:accountId/creatives/get.md) --- [API](https://skmtc.dev/google/apis/adexchangebuyer2.md) - [All operations](https://skmtc.dev/google/apis/adexchangebuyer2/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/adexchangebuyer2/revisions/0aaaaa1fffb0?raw)