Method: accounts.creatives.create
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{creative.accountId}/creatives
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
creative.accountId |
string
The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
|
Query parameters
| Parameters |
duplicateIdMode |
enum (DuplicateIdMode)
Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative).
|
Request body
The request body contains an instance of Creative.
Response body
If successful, the response body contains a newly created instance of Creative.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adexchange.buyer
DuplicateIdMode
A mode to describe how IDs will be treated.
| Enums |
NO_DUPLICATES |
Recommended. This means that an ID will be unique to a single creative. Multiple creatives will not share an ID. |
FORCE_ENABLE_DUPLICATE_IDS |
Not recommended. Using this option will allow multiple creatives to share the same ID. Get and Update requests will not be possible for any ID that has more than one creative associated. (List will still function.) This is only intended for backwards compatibility in cases where a single ID is already shared by multiple creatives from previous APIs. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eCreates a creative using an HTTP POST request to the specified endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a path parameter to specify the account ID and an optional query parameter to handle duplicate creative IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a Creative object, and a successful response will return the newly created Creative object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/adexchange.buyer\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eDuplicateIdMode allows for controlling the uniqueness of creative IDs, with \u003ccode\u003eNO_DUPLICATES\u003c/code\u003e being the recommended approach for ensuring each creative has a distinct ID.\u003c/p\u003e\n"]]],["This document details how to create a creative using a POST request to the specified URL. The request requires a `creative.accountId` path parameter to identify the owning account. The `duplicateIdMode` query parameter controls whether multiple creatives can share an ID, defaulting to no duplicates. The request body should contain a `Creative` instance. A successful request returns a new `Creative` instance in the response. The request need to be authorized with the `adexchange.buyer` OAuth scope.\n"],null,["# Method: accounts.creatives.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [DuplicateIdMode](#DuplicateIdMode)\n- [Try it!](#try-it)\n\nCreates a creative.\n\n### HTTP request\n\n`POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{creative.accountId}/creatives`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `creative.accountId` | `string` The account that this creative belongs to. Can be used to filter the response of the [creatives.list](/authorized-buyers/apis/reference/rest/v2beta1/accounts.creatives/list#google.ads.adexchange.buyer.v2beta1.Creatives.ListCreatives) method. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `duplicateIdMode` | `enum (`[DuplicateIdMode](/authorized-buyers/apis/reference/rest/v2beta1/accounts.creatives/create#DuplicateIdMode)`)` Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative). |\n\n### Request body\n\nThe request body contains an instance of [Creative](/authorized-buyers/apis/reference/rest/v2beta1/accounts.creatives#Creative).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Creative](/authorized-buyers/apis/reference/rest/v2beta1/accounts.creatives#Creative).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adexchange.buyer`\n\nDuplicateIdMode\n---------------\n\nA mode to describe how IDs will be treated.\n\n| Enums ||\n|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `NO_DUPLICATES` | Recommended. This means that an ID will be unique to a single creative. Multiple creatives will not share an ID. |\n| `FORCE_ENABLE_DUPLICATE_IDS` | Not recommended. Using this option will allow multiple creatives to share the same ID. Get and Update requests will not be possible for any ID that has more than one creative associated. (List will still function.) This is only intended for backwards compatibility in cases where a single ID is already shared by multiple creatives from previous APIs. |"]]
