Method: creatives.create
Stay organized with collections
Save and categorize content based on your preferences.
Creates a Creative. Returns a Creative in the response
field when it completes successfully, or a google.rpc.Code
upon failure. Returns CreateCreativeOperationMetadata including the status of ingestion in the metadata
field.
HTTP request
POST https://dai.googleapis.com/v1/creatives
The URL uses gRPC Transcoding syntax.
Request body
The request body contains data with the following structure:
Fields |
creative |
object (Creative )
The creative to be ingested.
|
dynamicCreativeInfo |
object (DynamicCreativeInfo )
Information about the dynamic creative. Required if the creative to be ingested is dynamic.
|
Response body
If successful, the response body contains a newly created instance of Operation
.
DynamicCreativeInfo
Information necessary for a dynamic creative to perform VCL processing.
JSON representation |
{
"dynamicGroupId": string,
"activeDuration": string
} |
Fields |
dynamicGroupId |
string
An ID that represents the core video ad of the creative. All dynamic creatives under the same dynamic group id can be considered to have the same content but with different dynamic aspects to the creative.
|
activeDuration |
string (Duration format)
The duration for which this creative is considered active and in use for. After this time, the creative will be scheduled for deletion in the video creative repository. The duration will be capped at 180 days. If this field is left unspecified, a default duration time of 30 days will be applied. A duration in seconds with up to nine fractional digits, ending with 's '. Example: "3.5s" .
|
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 2025-03-19 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-19 UTC."],[[["\u003cp\u003eCreates a Creative with a \u003ccode\u003ePOST\u003c/code\u003e request to the specified endpoint, returning the Creative or an error code.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include \u003ccode\u003ecreative\u003c/code\u003e information and \u003ccode\u003edynamicCreativeInfo\u003c/code\u003e if the creative is dynamic.\u003c/p\u003e\n"],["\u003cp\u003eA successful response includes an \u003ccode\u003eOperation\u003c/code\u003e object with ingestion status metadata.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDynamicCreativeInfo\u003c/code\u003e provides necessary details for dynamic creatives, including a shared group ID and an active duration before deletion.\u003c/p\u003e\n"]]],["This document details how to create a creative via an HTTP POST request to `https://dai.googleapis.com/v1/creatives`. The request body requires a `creative` object and a `dynamicCreativeInfo` object for dynamic creatives. `DynamicCreativeInfo` includes `dynamicGroupId`, a string representing the core video ad's group, and `activeDuration`, specifying the creative's active lifespan. Upon success, the response contains an `Operation` instance; otherwise, a `google.rpc.Code` is returned.\n"],null,["# Method: creatives.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [DynamicCreativeInfo](#DynamicCreativeInfo)\n - [JSON representation](#DynamicCreativeInfo.SCHEMA_REPRESENTATION)\n\nCreates a Creative. Returns a Creative in the [response](/video-creative-ingest/rest/v1/operations#Operation.FIELDS.response) field when it completes successfully, or a `google.rpc.Code` upon failure. Returns CreateCreativeOperationMetadata including the status of ingestion in the [metadata](/video-creative-ingest/rest/v1/operations#Operation.FIELDS.metadata) field.\n\n### HTTP request\n\n`POST https://dai.googleapis.com/v1/creatives`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"creative\": { object (/video-creative-ingest/rest/v1/creatives#Creative) }, \"dynamicCreativeInfo\": { object (/video-creative-ingest/rest/v1/creatives/create#DynamicCreativeInfo) } } ``` |\n\n| Fields ||\n|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `creative` | `object (`[Creative](/video-creative-ingest/rest/v1/creatives#Creative)`)` The creative to be ingested. |\n| `dynamicCreativeInfo` | `object (`[DynamicCreativeInfo](/video-creative-ingest/rest/v1/creatives/create#DynamicCreativeInfo)`)` Information about the dynamic creative. Required if the creative to be ingested is dynamic. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/video-creative-ingest/rest/v1/operations#Operation).\n\nDynamicCreativeInfo\n-------------------\n\nInformation necessary for a dynamic creative to perform VCL processing.\n\n| JSON representation |\n|----------------------------------------------------------------|\n| ``` { \"dynamicGroupId\": string, \"activeDuration\": string } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dynamicGroupId` | `string` An ID that represents the core video ad of the creative. All dynamic creatives under the same dynamic group id can be considered to have the same content but with different dynamic aspects to the creative. |\n| `activeDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The duration for which this creative is considered active and in use for. After this time, the creative will be scheduled for deletion in the video creative repository. The duration will be capped at 180 days. If this field is left unspecified, a default duration time of 30 days will be applied. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |"]]