--- title: "POST /v1/{+parent}/creatives" method: POST path: "/v1/{+parent}/creatives" tags: ["buyers"] --- # POST /v1/{+parent}/creatives `POST /v1/{+parent}/creatives` Creates a creative. ## Path parameters - `parent` string, required ## Request body - Creative — A creative and its classification data. - `native` NativeContent — Native content for a creative. - `videoVastXml` string — The contents of a VAST document for a native video ad. - `body` string — A long description of the ad. - `appIcon` Image — An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. - `url` string — The URL of the image. - `height` integer — Image height in pixels. - `width` integer — Image width in pixels. - `advertiserName` string — The name of the advertiser or sponsor, to be displayed in the ad creative. - `clickTrackingUrl` string — The URL to use for click tracking. - `videoUrl` string — The URL to fetch a native video ad. - `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]. - `logo` Image — An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. - `url` string — The URL of the image. - `height` integer — Image height in pixels. - `width` integer — Image width in pixels. - `image` Image — An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. - `url` string — The URL of the image. - `height` integer — Image height in pixels. - `width` integer — Image width in pixels. - `callToAction` string — A label for the button that the user is supposed to click. - `headline` string — A short title for the ad. - `clickLinkUrl` string — The URL that the browser/SDK will load when the user clicks the ad. - `declaredClickThroughUrls` string[] — The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. - `declaredAttributes` string[] — All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. - `restrictedCategories` string[] — All restricted categories for the ads that may be shown from this creative. - `declaredRestrictedCategories` string[] — All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. - `creativeId` string — Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. - `impressionTrackingUrls` string[] — The set of URLs to be called to record an impression. - `apiUpdateTime` string, google-datetime — Output only. The last update timestamp of the creative through the API. - `adChoicesDestinationUrl` string — The link to AdChoices destination page. This is only supported for native ads. - `version` integer — Output only. The version of the creative. Version for a new creative is 1 and it increments during subsequent creative updates. - `html` HtmlContent — HTML content for a creative. - `snippet` string — The HTML snippet that displays the ad when inserted in the web page. - `height` integer — The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. - `width` integer — The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. - `agencyId` string, int64 — The agency ID for this creative. - `video` VideoContent — Video content for a creative. - `videoUrl` string — The URL to fetch a video ad. The URL should return an XML response that conforms to the VAST 2.0, 3.0 or 4.x standard. - `videoVastXml` string — The contents of a VAST document for a video ad. This document should conform to the VAST 2.0, 3.0, or 4.x standard. - `videoMetadata` VideoMetadata — Video metadata for a creative. - `vastVersion` 'VAST_VERSION_UNSPECIFIED' | 'VAST_VERSION_1_0' | 'VAST_VERSION_2_0' | 'VAST_VERSION_3_0' | 'VAST_VERSION_4_0' — The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. - `isValidVast` boolean — Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. - `skipOffset` string, google-duration — The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. - `duration` string, google-duration — The duration of the ad. Can be used to filter the response of the creatives.list method. - `mediaFiles` MediaFile[] — The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. - `mimeType` 'VIDEO_MIME_TYPE_UNSPECIFIED' | 'MIME_VIDEO_XFLV' | 'MIME_VIDEO_WEBM' | 'MIME_VIDEO_MP4' | 'MIME_VIDEO_OGG' | 'MIME_VIDEO_YT_HOSTED' | 'MIME_VIDEO_X_MS_WMV' | 'MIME_VIDEO_3GPP' | 'MIME_VIDEO_MOV' | 'MIME_APPLICATION_SWF' | 'MIME_APPLICATION_SURVEY' | 'MIME_APPLICATION_JAVASCRIPT' | 'MIME_APPLICATION_SILVERLIGHT' | 'MIME_APPLICATION_MPEGURL' | 'MIME_APPLICATION_MPEGDASH' | 'MIME_AUDIO_MP4A' | 'MIME_AUDIO_MP3' | 'MIME_AUDIO_OGG' — The MIME type of this media file. Can be used to filter the response of the creatives.list method. - `bitrate` string, int64 — Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. - `isVpaid` boolean — Is this a VPAID ad? Can be used to filter the response of the creatives.list method. - `dealIds` string[] — Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. - `renderUrl` string — Deprecated: FLEDGE is no longer supported. See: https://privacysandbox.google.com/blog/update-on-plans-for-privacy-sandbox-technologies Experimental field that can be used during the [FLEDGE Origin Trial](/authorized-buyers/rtb/fledge-origin-trial). The URL to fetch an interest group ad used in [TURTLEDOVE on-device auction](https://github.com/WICG/turtledove/blob/main/FLEDGE.md#1-browsers-record-interest-groups"). This should be unique among all creatives for a given `accountId`. This URL should be the same as the URL returned by [generateBid()](https://github.com/WICG/turtledove/blob/main/FLEDGE.md#32-on-device-bidding). - `name` string — Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. - `creativeServingDecision` CreativeServingDecision — Top level status and detected attributes of a creative. - `detectedSensitiveCategories` integer[] — Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. - `russiaPolicyCompliance` PolicyCompliance — Policy compliance of the creative for a transaction type or a region. - `status` 'STATUS_UNSPECIFIED' | 'PENDING_REVIEW' | 'DISAPPROVED' | 'APPROVED' | 'CERTIFICATE_REQUIRED' — Serving status for the given transaction type (for example, open auction, deals) or region (for example, China, Russia). Can be used to filter the response of the creatives.list method. - `topics` PolicyTopicEntry[] — Topics related to the policy compliance for this transaction type (for example, open auction, deals) or region (for example, China, Russia). Topics may be present only if status is DISAPPROVED. - `evidences` PolicyTopicEvidence[] — Pieces of evidence associated with this policy topic entry. - `destinationNotCrawlable` DestinationNotCrawlableEvidence — Evidence that the creative's destination URL was not crawlable by Google. - `crawledUrl` string — Destination URL that was attempted to be crawled. - `reason` 'REASON_UNSPECIFIED' | 'UNREACHABLE_ROBOTS' | 'TIMEOUT_ROBOTS' | 'ROBOTED_DENIED' | 'UNKNOWN' — Reason of destination not crawlable. - `crawlTime` string, google-datetime — Approximate time of the crawl. - `domainCall` DomainCallEvidence — Number of HTTP calls made by a creative, broken down by domain. - `topHttpCallDomains` DomainCalls[] — Breakdown of the most frequent domains called through HTTP by the creative. - … - `totalHttpCallCount` integer — The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. - `downloadSize` DownloadSizeEvidence — Total download size and URL-level download size breakdown for resources in a creative. - `totalDownloadSizeKb` integer — Total download size (in kilobytes) for all the resources in the creative. - `topUrlDownloadSizeBreakdowns` UrlDownloadSize[] — Download size broken down by URLs with the top download size. - … - `destinationNotWorking` DestinationNotWorkingEvidence — Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. - `expandedUrl` string — The full non-working URL. - `dnsError` 'DNS_ERROR_UNSPECIFIED' | 'ERROR_DNS' | 'GOOGLE_CRAWLER_DNS_ISSUE' — DNS lookup errors. - `platform` 'PLATFORM_UNSPECIFIED' | 'PERSONAL_COMPUTER' | 'ANDROID' | 'IOS' — Platform of the non-working URL. - `redirectionError` 'REDIRECTION_ERROR_UNSPECIFIED' | 'TOO_MANY_REDIRECTS' | 'INVALID_REDIRECT' | 'EMPTY_REDIRECT' | 'REDIRECT_ERROR_UNKNOWN' — HTTP redirect chain error. - `invalidPage` 'INVALID_PAGE_UNSPECIFIED' | 'EMPTY_OR_ERROR_PAGE' — Page was crawled successfully, but was detected as either a page with no content or an error page. - `lastCheckTime` string, google-datetime — Approximate time when the ad destination was last checked. - `httpError` integer — HTTP error code (for example, 404 or 5xx) - `urlRejected` 'URL_REJECTED_UNSPECIFIED' | 'BAD_REQUEST' | 'MALFORMED_URL' | 'URL_REJECTED_UNKNOWN' — Rejected because of malformed URLs or invalid requests. - `httpCall` HttpCallEvidence — HTTP calls made by a creative that resulted in policy violations. - `urls` string[] — URLs of HTTP calls made by the creative. - `httpCookie` HttpCookieEvidence — Evidence for HTTP cookie-related policy violations. - `cookieNames` string[] — Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. - `maxCookieCount` integer — The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. - `destinationUrl` DestinationUrlEvidence — The full landing page URL of the destination. - `destinationUrl` string — The full landing page URL of the destination. - `missingCertificate` boolean — Whether or not the policy topic is missing a certificate. Some policy topics require a certificate to unblock serving in some regions. For more information about creative certification, refer to: https://support.google.com/authorizedbuyers/answer/7450776 - `policyTopic` string — Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method - `helpCenterUrl` string — URL of the help center article describing this policy topic. - `detectedAttributes` string[] — Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. - `chinaPolicyCompliance` PolicyCompliance — Policy compliance of the creative for a transaction type or a region. - `status` 'STATUS_UNSPECIFIED' | 'PENDING_REVIEW' | 'DISAPPROVED' | 'APPROVED' | 'CERTIFICATE_REQUIRED' — Serving status for the given transaction type (for example, open auction, deals) or region (for example, China, Russia). Can be used to filter the response of the creatives.list method. - `topics` PolicyTopicEntry[] — Topics related to the policy compliance for this transaction type (for example, open auction, deals) or region (for example, China, Russia). Topics may be present only if status is DISAPPROVED. - `evidences` PolicyTopicEvidence[] — Pieces of evidence associated with this policy topic entry. - `destinationNotCrawlable` DestinationNotCrawlableEvidence — Evidence that the creative's destination URL was not crawlable by Google. - `crawledUrl` string — Destination URL that was attempted to be crawled. - `reason` 'REASON_UNSPECIFIED' | 'UNREACHABLE_ROBOTS' | 'TIMEOUT_ROBOTS' | 'ROBOTED_DENIED' | 'UNKNOWN' — Reason of destination not crawlable. - `crawlTime` string, google-datetime — Approximate time of the crawl. - `domainCall` DomainCallEvidence — Number of HTTP calls made by a creative, broken down by domain. - `topHttpCallDomains` DomainCalls[] — Breakdown of the most frequent domains called through HTTP by the creative. - … - `totalHttpCallCount` integer — The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. - `downloadSize` DownloadSizeEvidence — Total download size and URL-level download size breakdown for resources in a creative. - `totalDownloadSizeKb` integer — Total download size (in kilobytes) for all the resources in the creative. - `topUrlDownloadSizeBreakdowns` UrlDownloadSize[] — Download size broken down by URLs with the top download size. - … - `destinationNotWorking` DestinationNotWorkingEvidence — Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. - `expandedUrl` string — The full non-working URL. - `dnsError` 'DNS_ERROR_UNSPECIFIED' | 'ERROR_DNS' | 'GOOGLE_CRAWLER_DNS_ISSUE' — DNS lookup errors. - `platform` 'PLATFORM_UNSPECIFIED' | 'PERSONAL_COMPUTER' | 'ANDROID' | 'IOS' — Platform of the non-working URL. - `redirectionError` 'REDIRECTION_ERROR_UNSPECIFIED' | 'TOO_MANY_REDIRECTS' | 'INVALID_REDIRECT' | 'EMPTY_REDIRECT' | 'REDIRECT_ERROR_UNKNOWN' — HTTP redirect chain error. - `invalidPage` 'INVALID_PAGE_UNSPECIFIED' | 'EMPTY_OR_ERROR_PAGE' — Page was crawled successfully, but was detected as either a page with no content or an error page. - `lastCheckTime` string, google-datetime — Approximate time when the ad destination was last checked. - `httpError` integer — HTTP error code (for example, 404 or 5xx) - `urlRejected` 'URL_REJECTED_UNSPECIFIED' | 'BAD_REQUEST' | 'MALFORMED_URL' | 'URL_REJECTED_UNKNOWN' — Rejected because of malformed URLs or invalid requests. - `httpCall` HttpCallEvidence — HTTP calls made by a creative that resulted in policy violations. - `urls` string[] — URLs of HTTP calls made by the creative. - `httpCookie` HttpCookieEvidence — Evidence for HTTP cookie-related policy violations. - `cookieNames` string[] — Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. - `maxCookieCount` integer — The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. - `destinationUrl` DestinationUrlEvidence — The full landing page URL of the destination. - `destinationUrl` string — The full landing page URL of the destination. - `missingCertificate` boolean — Whether or not the policy topic is missing a certificate. Some policy topics require a certificate to unblock serving in some regions. For more information about creative certification, refer to: https://support.google.com/authorizedbuyers/answer/7450776 - `policyTopic` string — Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method - `helpCenterUrl` string — URL of the help center article describing this policy topic. - `detectedClickThroughUrls` string[] — The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. - `detectedCategoriesTaxonomy` 'AD_CATEGORY_TAXONOMY_UNSPECIFIED' | 'GOOGLE_AD_CATEGORY_TAXONOMY' | 'IAB_CONTENT_1_0' — Output only. The taxonomy in which the detected_categories field is expressed. - `networkPolicyCompliance` PolicyCompliance — Policy compliance of the creative for a transaction type or a region. - `status` 'STATUS_UNSPECIFIED' | 'PENDING_REVIEW' | 'DISAPPROVED' | 'APPROVED' | 'CERTIFICATE_REQUIRED' — Serving status for the given transaction type (for example, open auction, deals) or region (for example, China, Russia). Can be used to filter the response of the creatives.list method. - `topics` PolicyTopicEntry[] — Topics related to the policy compliance for this transaction type (for example, open auction, deals) or region (for example, China, Russia). Topics may be present only if status is DISAPPROVED. - `evidences` PolicyTopicEvidence[] — Pieces of evidence associated with this policy topic entry. - `destinationNotCrawlable` DestinationNotCrawlableEvidence — Evidence that the creative's destination URL was not crawlable by Google. - `crawledUrl` string — Destination URL that was attempted to be crawled. - `reason` 'REASON_UNSPECIFIED' | 'UNREACHABLE_ROBOTS' | 'TIMEOUT_ROBOTS' | 'ROBOTED_DENIED' | 'UNKNOWN' — Reason of destination not crawlable. - `crawlTime` string, google-datetime — Approximate time of the crawl. - `domainCall` DomainCallEvidence — Number of HTTP calls made by a creative, broken down by domain. - `topHttpCallDomains` DomainCalls[] — Breakdown of the most frequent domains called through HTTP by the creative. - … - `totalHttpCallCount` integer — The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. - `downloadSize` DownloadSizeEvidence — Total download size and URL-level download size breakdown for resources in a creative. - `totalDownloadSizeKb` integer — Total download size (in kilobytes) for all the resources in the creative. - `topUrlDownloadSizeBreakdowns` UrlDownloadSize[] — Download size broken down by URLs with the top download size. - … - `destinationNotWorking` DestinationNotWorkingEvidence — Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. - `expandedUrl` string — The full non-working URL. - `dnsError` 'DNS_ERROR_UNSPECIFIED' | 'ERROR_DNS' | 'GOOGLE_CRAWLER_DNS_ISSUE' — DNS lookup errors. - `platform` 'PLATFORM_UNSPECIFIED' | 'PERSONAL_COMPUTER' | 'ANDROID' | 'IOS' — Platform of the non-working URL. - `redirectionError` 'REDIRECTION_ERROR_UNSPECIFIED' | 'TOO_MANY_REDIRECTS' | 'INVALID_REDIRECT' | 'EMPTY_REDIRECT' | 'REDIRECT_ERROR_UNKNOWN' — HTTP redirect chain error. - `invalidPage` 'INVALID_PAGE_UNSPECIFIED' | 'EMPTY_OR_ERROR_PAGE' — Page was crawled successfully, but was detected as either a page with no content or an error page. - `lastCheckTime` string, google-datetime — Approximate time when the ad destination was last checked. - `httpError` integer — HTTP error code (for example, 404 or 5xx) - `urlRejected` 'URL_REJECTED_UNSPECIFIED' | 'BAD_REQUEST' | 'MALFORMED_URL' | 'URL_REJECTED_UNKNOWN' — Rejected because of malformed URLs or invalid requests. - `httpCall` HttpCallEvidence — HTTP calls made by a creative that resulted in policy violations. - `urls` string[] — URLs of HTTP calls made by the creative. - `httpCookie` HttpCookieEvidence — Evidence for HTTP cookie-related policy violations. - `cookieNames` string[] — Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. - `maxCookieCount` integer — The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. - `destinationUrl` DestinationUrlEvidence — The full landing page URL of the destination. - `destinationUrl` string — The full landing page URL of the destination. - `missingCertificate` boolean — Whether or not the policy topic is missing a certificate. Some policy topics require a certificate to unblock serving in some regions. For more information about creative certification, refer to: https://support.google.com/authorizedbuyers/answer/7450776 - `policyTopic` string — Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method - `helpCenterUrl` string — URL of the help center article describing this policy topic. - `detectedProductCategories` integer[] — Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. - `adTechnologyProviders` AdTechnologyProviders — The list of detected Ad Technology Providers for this creative. Bids placed for inventory that will serve to EEA or UK users are expected to comply with GDPR requirements. You must ensure that the creatives used in such bids should contain only user consented ad technology providers as indicated in the bid request. Google reserves the right to filter non-compliant bids. User consented ad technology providers can be found in the [Google Protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) with the `BidRequest.adslot.consented_providers_settings` field, and can be found as an [OpenRTB extension](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto) with the `BidRequest.user.ext.consented_providers_settings` and `BidRequest.user.ext.consent` fields. See https://support.google.com/authorizedbuyers/answer/9789378 for additional information about the Google TCF v2 integration. - `detectedProviderIds` string[] — The detected [Google Ad Tech Providers (ATP)](https://support.google.com/admanager/answer/9012903) 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. - `detectedGvlIds` string[] — The detected IAB Global Vendor List (GVL) IDs for this creative. See the IAB Global Vendor List at https://vendor-list.consensu.org/v2/vendor-list.json for details about the vendors. - `unidentifiedProviderDomains` string[] — Domains of detected unidentified ad technology providers (if any). You must ensure that the creatives used in bids placed for inventory that will serve to EEA or UK users does not contain unidentified ad technology providers. Google reserves the right to filter non-compliant bids. - `dealsPolicyCompliance` PolicyCompliance — Policy compliance of the creative for a transaction type or a region. - `status` 'STATUS_UNSPECIFIED' | 'PENDING_REVIEW' | 'DISAPPROVED' | 'APPROVED' | 'CERTIFICATE_REQUIRED' — Serving status for the given transaction type (for example, open auction, deals) or region (for example, China, Russia). Can be used to filter the response of the creatives.list method. - `topics` PolicyTopicEntry[] — Topics related to the policy compliance for this transaction type (for example, open auction, deals) or region (for example, China, Russia). Topics may be present only if status is DISAPPROVED. - `evidences` PolicyTopicEvidence[] — Pieces of evidence associated with this policy topic entry. - `destinationNotCrawlable` DestinationNotCrawlableEvidence — Evidence that the creative's destination URL was not crawlable by Google. - `crawledUrl` string — Destination URL that was attempted to be crawled. - `reason` 'REASON_UNSPECIFIED' | 'UNREACHABLE_ROBOTS' | 'TIMEOUT_ROBOTS' | 'ROBOTED_DENIED' | 'UNKNOWN' — Reason of destination not crawlable. - `crawlTime` string, google-datetime — Approximate time of the crawl. - `domainCall` DomainCallEvidence — Number of HTTP calls made by a creative, broken down by domain. - `topHttpCallDomains` DomainCalls[] — Breakdown of the most frequent domains called through HTTP by the creative. - … - `totalHttpCallCount` integer — The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. - `downloadSize` DownloadSizeEvidence — Total download size and URL-level download size breakdown for resources in a creative. - `totalDownloadSizeKb` integer — Total download size (in kilobytes) for all the resources in the creative. - `topUrlDownloadSizeBreakdowns` UrlDownloadSize[] — Download size broken down by URLs with the top download size. - … - `destinationNotWorking` DestinationNotWorkingEvidence — Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. - `expandedUrl` string — The full non-working URL. - `dnsError` 'DNS_ERROR_UNSPECIFIED' | 'ERROR_DNS' | 'GOOGLE_CRAWLER_DNS_ISSUE' — DNS lookup errors. - `platform` 'PLATFORM_UNSPECIFIED' | 'PERSONAL_COMPUTER' | 'ANDROID' | 'IOS' — Platform of the non-working URL. - `redirectionError` 'REDIRECTION_ERROR_UNSPECIFIED' | 'TOO_MANY_REDIRECTS' | 'INVALID_REDIRECT' | 'EMPTY_REDIRECT' | 'REDIRECT_ERROR_UNKNOWN' — HTTP redirect chain error. - `invalidPage` 'INVALID_PAGE_UNSPECIFIED' | 'EMPTY_OR_ERROR_PAGE' — Page was crawled successfully, but was detected as either a page with no content or an error page. - `lastCheckTime` string, google-datetime — Approximate time when the ad destination was last checked. - `httpError` integer — HTTP error code (for example, 404 or 5xx) - `urlRejected` 'URL_REJECTED_UNSPECIFIED' | 'BAD_REQUEST' | 'MALFORMED_URL' | 'URL_REJECTED_UNKNOWN' — Rejected because of malformed URLs or invalid requests. - `httpCall` HttpCallEvidence — HTTP calls made by a creative that resulted in policy violations. - `urls` string[] — URLs of HTTP calls made by the creative. - `httpCookie` HttpCookieEvidence — Evidence for HTTP cookie-related policy violations. - `cookieNames` string[] — Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. - `maxCookieCount` integer — The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. - `destinationUrl` DestinationUrlEvidence — The full landing page URL of the destination. - `destinationUrl` string — The full landing page URL of the destination. - `missingCertificate` boolean — Whether or not the policy topic is missing a certificate. Some policy topics require a certificate to unblock serving in some regions. For more information about creative certification, refer to: https://support.google.com/authorizedbuyers/answer/7450776 - `policyTopic` string — Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method - `helpCenterUrl` string — URL of the help center article describing this policy topic. - `lastStatusUpdate` string, google-datetime — The last time the creative status was updated. Can be used to filter the response of the creatives.list method. - `detectedDomains` string[] — The detected domains for this creative. - `detectedLanguages` string[] — 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. Can be used to filter the response of the creatives.list method. - `detectedAdvertisers` AdvertiserAndBrand[] — Detected advertisers and brands. - `brandName` string — Brand name. Can be used to filter the response of the creatives.list method. - `advertiserName` string — Advertiser name. Can be used to filter the response of the creatives.list method. - `brandId` string, int64 — Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. - `advertiserId` string, int64 — See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. - `detectedVendorIds` integer[] — IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. - `platformPolicyCompliance` PolicyCompliance — Policy compliance of the creative for a transaction type or a region. - `status` 'STATUS_UNSPECIFIED' | 'PENDING_REVIEW' | 'DISAPPROVED' | 'APPROVED' | 'CERTIFICATE_REQUIRED' — Serving status for the given transaction type (for example, open auction, deals) or region (for example, China, Russia). Can be used to filter the response of the creatives.list method. - `topics` PolicyTopicEntry[] — Topics related to the policy compliance for this transaction type (for example, open auction, deals) or region (for example, China, Russia). Topics may be present only if status is DISAPPROVED. - `evidences` PolicyTopicEvidence[] — Pieces of evidence associated with this policy topic entry. - `destinationNotCrawlable` DestinationNotCrawlableEvidence — Evidence that the creative's destination URL was not crawlable by Google. - `crawledUrl` string — Destination URL that was attempted to be crawled. - `reason` 'REASON_UNSPECIFIED' | 'UNREACHABLE_ROBOTS' | 'TIMEOUT_ROBOTS' | 'ROBOTED_DENIED' | 'UNKNOWN' — Reason of destination not crawlable. - `crawlTime` string, google-datetime — Approximate time of the crawl. - `domainCall` DomainCallEvidence — Number of HTTP calls made by a creative, broken down by domain. - `topHttpCallDomains` DomainCalls[] — Breakdown of the most frequent domains called through HTTP by the creative. - … - `totalHttpCallCount` integer — The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. - `downloadSize` DownloadSizeEvidence — Total download size and URL-level download size breakdown for resources in a creative. - `totalDownloadSizeKb` integer — Total download size (in kilobytes) for all the resources in the creative. - `topUrlDownloadSizeBreakdowns` UrlDownloadSize[] — Download size broken down by URLs with the top download size. - … - `destinationNotWorking` DestinationNotWorkingEvidence — Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. - `expandedUrl` string — The full non-working URL. - `dnsError` 'DNS_ERROR_UNSPECIFIED' | 'ERROR_DNS' | 'GOOGLE_CRAWLER_DNS_ISSUE' — DNS lookup errors. - `platform` 'PLATFORM_UNSPECIFIED' | 'PERSONAL_COMPUTER' | 'ANDROID' | 'IOS' — Platform of the non-working URL. - `redirectionError` 'REDIRECTION_ERROR_UNSPECIFIED' | 'TOO_MANY_REDIRECTS' | 'INVALID_REDIRECT' | 'EMPTY_REDIRECT' | 'REDIRECT_ERROR_UNKNOWN' — HTTP redirect chain error. - `invalidPage` 'INVALID_PAGE_UNSPECIFIED' | 'EMPTY_OR_ERROR_PAGE' — Page was crawled successfully, but was detected as either a page with no content or an error page. - `lastCheckTime` string, google-datetime — Approximate time when the ad destination was last checked. - `httpError` integer — HTTP error code (for example, 404 or 5xx) - `urlRejected` 'URL_REJECTED_UNSPECIFIED' | 'BAD_REQUEST' | 'MALFORMED_URL' | 'URL_REJECTED_UNKNOWN' — Rejected because of malformed URLs or invalid requests. - `httpCall` HttpCallEvidence — HTTP calls made by a creative that resulted in policy violations. - `urls` string[] — URLs of HTTP calls made by the creative. - `httpCookie` HttpCookieEvidence — Evidence for HTTP cookie-related policy violations. - `cookieNames` string[] — Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. - `maxCookieCount` integer — The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. - `destinationUrl` DestinationUrlEvidence — The full landing page URL of the destination. - `destinationUrl` string — The full landing page URL of the destination. - `missingCertificate` boolean — Whether or not the policy topic is missing a certificate. Some policy topics require a certificate to unblock serving in some regions. For more information about creative certification, refer to: https://support.google.com/authorizedbuyers/answer/7450776 - `policyTopic` string — Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method - `helpCenterUrl` string — URL of the help center article describing this policy topic. - `detectedCategories` string[] — Output only. IDs of the detected categories. The taxonomy in which the categories are expressed is specified by the detected_categories_taxonomy field. Use this in conjunction with BidRequest.bcat to avoid bidding on impressions where a given ad category is blocked, or to troubleshoot filtered bids. Can be used to filter the response of the creatives.list method. - `creativeFormat` 'CREATIVE_FORMAT_UNSPECIFIED' | 'HTML' | 'VIDEO' | 'NATIVE' — Output only. The format of this creative. Can be used to filter the response of the creatives.list method. - `declaredVendorIds` integer[] — IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. - `advertiserName` string — The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. - `accountId` string, int64 — Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/realtimebidding.md) · [All operations](https://skmtc.net/google/apis/realtimebidding/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/realtimebidding/revisions/da99d215fb25/schema)