- [Resource: Creative](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives#Creative) - [JSON representation](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives#Creative.SCHEMA_REPRESENTATION) - [Methods](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives#METHODS_SUMMARY) ## Resource: Creative A creative and its classification data. | JSON representation | |---| | ``` { "name": string, "accountId": string, "creativeId": string, "creativeFormat": enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.CreativeFormat`), "agencyId": string, "declaredClickThroughUrls": [ string ], "impressionTrackingUrls": [ string ], "adChoicesDestinationUrl": string, "restrictedCategories": [ enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.RestrictedCategory`) ], "declaredAttributes": [ enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.CreativeAttribute`) ], "declaredVendorIds": [ integer ], "declaredRestrictedCategories": [ enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.RestrictedCategory`) ], "advertiserName": string, "version": integer, "apiUpdateTime": string, "dealIds": [ string ], "creativeServingDecision": { object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.CreativeServingDecision`) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "html": { object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.HtmlContent`) }, "video": { object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.VideoContent`) }, "native": { object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.NativeContent`) }, "renderUrl": string // End of mutually exclusive fields. } ``` | | Fields || |---|---| | `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. | | `accountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method with equality and inequality check. | | `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 `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. The maximum length of the creative ID is 128 bytes. | | `creativeFormat` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.CreativeFormat`)`` Output only. The format of this creative. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. | | `agencyId` | `string (https://developers.google.com/discovery/v1/type-format format)` The agency ID for this creative. | | `declaredClickThroughUrls[]` | `string` The set of declared destination URLs for the creative. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. | | `impressionTrackingUrls[]` | `string` The set of URLs to be called to record an impression. | | `adChoicesDestinationUrl` | `string` The link to AdChoices destination page. This is only supported for native ads. | | `restrictedCategories[] (deprecated)` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.RestrictedCategory`)`` > [!WARNING] > Prefer declared_restricted_categories field over this field. All restricted categories for the ads that may be shown from this creative. | | `declaredAttributes[]` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.CreativeAttribute`)`` All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` 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. | | `declaredVendorIds[]` | `integer` IDs for the declared ad technology vendors that may be used by this creative. See for possible values. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. | | `declaredRestrictedCategories[] (deprecated)` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.RestrictedCategory`)`` > [!WARNING] > Restricted categories will be detected by Google. Buyers are no longer required to declare them. All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. | | `advertiserName` | `string` The name of the company being advertised in the creative. Can be used to filter the response of the `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. | | `version (deprecated)` | `integer` > [!WARNING] > Output only. Deprecated: Don't rely on `version` in your integration. Output only. The version of the creative. Version for a new creative is 1 and it increments during subsequent creative updates. | | `apiUpdateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The last update timestamp of the creative through the API. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. | | `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 `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list#google.ads.realtimebidding.v1.Creatives.ListCreatives` method. | | `creativeServingDecision` | ``object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.CreativeServingDecision`)`` Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. | | Creative content in different formats. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: || | `html` | ``object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.HtmlContent`)`` An HTML creative. | | `video` | ``object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.VideoContent`)`` A video creative. | | `native` | ``object (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives#Creative.NativeContent`)`` A native creative. | | `renderUrl (deprecated)` | `string` > [!WARNING] > This item is deprecated! Deprecated: FLEDGE is no longer supported. See: Experimental field that can be used during the [FLEDGE Origin Trial](https://developers.google.com/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). | | End of mutually exclusive fields. || | ## Methods || |---|---| | ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/addDeals` | Adds a list of deals to a creative, which submits the creative for publisher review. | | ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/create` | Creates a creative. | | ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/get` | Gets a creative. | | ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list` | Lists creatives as they are at the time of the initial request. | | ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/patch` | Updates a creative. |