CreateCreativeOperationMetadata
Stay organized with collections
Save and categorize content based on your preferences.
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\u003eThis documentation details the metadata for long-running operations returned by creatives.create, specifically focusing on the ingest status and potential failure reasons.\u003c/p\u003e\n"],["\u003cp\u003eThe metadata includes crucial information like the creative URL, a unique identifier for the video creative upon successful ingest, creation time, and the current YouTube ingest status.\u003c/p\u003e\n"],["\u003cp\u003eIngestionStatus provides insights into the ingest state of a video creative, potential failure reasons if the ingest fails, and the last update time of the ingest job.\u003c/p\u003e\n"],["\u003cp\u003eFailureReason elaborates on the cause of creative ingest failure, offering a description and an HTTP status code in cases of download errors.\u003c/p\u003e\n"]]],["This content details metadata for video creative ingestion operations. Key information includes: `creativeUrl` (creative's URL), `gvRegistryId` (unique identifier), `createTime` (ingest request time), and `youtubeStatus` (current ingest status). The `IngestionStatus` provides the current `state`, `updateTime`, and a `failureReason` if applicable. `FailureReason` includes a description (`reason`) and an HTTP status `code` if a download error occurred.\n"],null,["# CreateCreativeOperationMetadata\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [IngestionStatus](#IngestionStatus)\n - [JSON representation](#IngestionStatus.SCHEMA_REPRESENTATION)\n- [FailureReason](#FailureReason)\n - [JSON representation](#FailureReason.SCHEMA_REPRESENTATION)\n\nMetadata for long running operation returned by creatives.create. Present as [metadata](/video-creative-ingest/rest/v1/operations#Operation.FIELDS.metadata).\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"creativeUrl\": string, \"gvRegistryId\": string, \"createTime\": string, \"youtubeStatus\": { object (/video-creative-ingest/rest/v1/CreateCreativeOperationMetadata#IngestionStatus) } } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `creativeUrl` | `string` The URL of the creative that was used for ingest. This is the selected mezzanine URL or media rendition URL, which was chosen based on the properties provided in the request. |\n| `gvRegistryId` | `string` A unique identifier for the video creative, if ingest is successful. The name of the Creative resource is creatives/`gvRegistryId`. |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Time that ingest request was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 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\"`. |\n| `youtubeStatus` | `object (`[IngestionStatus](/video-creative-ingest/rest/v1/CreateCreativeOperationMetadata#IngestionStatus)`)` Current YouTube ingest status. |\n\nIngestionStatus\n---------------\n\nThe ingest status of the Create Creative request.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"state\": enum (/video-creative-ingest/rest/v1/State), \"failureReason\": { object (/video-creative-ingest/rest/v1/CreateCreativeOperationMetadata#FailureReason) }, \"updateTime\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `state` | `enum (`[State](/video-creative-ingest/rest/v1/State)`)` The current ingest state of a video creative. |\n| `failureReason` | `object (`[FailureReason](/video-creative-ingest/rest/v1/CreateCreativeOperationMetadata#FailureReason)`)` The reason the creative failed to be ingested, if ingest fails. |\n| `updateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The time the ingest job was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 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\"`. |\n\nFailureReason\n-------------\n\nReason for creative ingest failure.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------|\n| ``` { \"reason\": enum (/video-creative-ingest/rest/v1/Reason), \"code\": integer } ``` |\n\n| Fields ||\n|----------|----------------------------------------------------------------------------------------------------|\n| `reason` | `enum (`[Reason](/video-creative-ingest/rest/v1/Reason)`)` Description of creative ingest failure. |\n| `code` | `integer` HTTP status code of failure if reason is DOWNLOAD_ERROR. |"]]