REST Resource: creatives
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Creative
JSON representation |
{
"name": string,
"advertiser": string,
"adSystem": string,
"adTitle": string,
"adDescription": string,
"mezzanines": [
{
object (MediaFile )
}
],
"mediaFiles": [
{
object (MediaFile )
}
],
"networkCode": string
} |
Fields |
name |
string
Output only. The unique name (Google Video ID) of the Creative resource, in the format creatives/id .
|
advertiser |
string
The name of the advertiser featured in this creative.
|
adSystem |
string
Required. The name of ad system generating the ingest request.
|
adTitle |
string
The title of the advertisement.
|
adDescription |
string
The description of the advertisement.
|
mezzanines[] |
object (MediaFile )
The ad's mezzanine file URLs and their properties. At least one of mezannines or mediaFiles is required.
|
mediaFiles[] |
object (MediaFile )
The ad's media file URLs and their properties. At least one of mezannines or mediaFiles is required.
|
networkCode |
string
Optional. The Google Ad Manager network code of the publisher for which the creative is intended. Required if the creative is dynamic and has DynamicCreativeInfo populated in the CreateCreativeRequest.
|
Delivery
Enums |
DELIVERY_UNSPECIFIED |
Default delivery value. |
DELIVERY_PROGRESSIVE |
Progressive video delivery. |
DELIVERY_STREAMING |
Streaming video delivery. |
Methods |
|
Creates a Creative. |
|
Deletes a Creative. |
|
Gets a Creative. |
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\u003eCreatives, represented in JSON format, contain essential information like advertiser, ad system, title, description, and media files.\u003c/p\u003e\n"],["\u003cp\u003eMedia files, also in JSON, include details such as the file's URI, delivery type, dimensions, MIME type, and bitrate range.\u003c/p\u003e\n"],["\u003cp\u003eThe Delivery enum defines how the creative content is delivered, either progressively or via streaming.\u003c/p\u003e\n"],["\u003cp\u003eSupported operations on creatives include creation, deletion, and retrieval using designated methods.\u003c/p\u003e\n"]]],["The content outlines the structure and properties of 'Creative' and 'MediaFile' resources. A Creative includes details like advertiser, ad system, title, description, and media files. It requires either mezzanine or media files. MediaFiles detail properties such as URI, delivery type (progressive or streaming), height, width, MIME type, and bitrate ranges. The content also defines methods for creating, deleting, and retrieving Creatives. Delivery types are specified as either progressive or streaming.\n"],null,["# REST Resource: creatives\n\n- [Resource: Creative](#Creative)\n - [JSON representation](#Creative.SCHEMA_REPRESENTATION)\n- [MediaFile](#MediaFile)\n - [JSON representation](#MediaFile.SCHEMA_REPRESENTATION)\n- [Delivery](#Delivery)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Creative\n------------------\n\nA Creative resource. Present as [response](/video-creative-ingest/rest/v1/operations#Operation.FIELDS.response) upon completion of [PartnerDiscoveryService.CreateCreative](/video-creative-ingest/rest/v1/creatives/create#google.ads.dai.v1.PartnerDiscoveryService.CreateCreative).\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"advertiser\": string, \"adSystem\": string, \"adTitle\": string, \"adDescription\": string, \"mezzanines\": [ { object (/video-creative-ingest/rest/v1/creatives#MediaFile) } ], \"mediaFiles\": [ { object (/video-creative-ingest/rest/v1/creatives#MediaFile) } ], \"networkCode\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The unique name (Google Video ID) of the Creative resource, in the format creatives/`id`. |\n| `advertiser` | `string` The name of the advertiser featured in this creative. |\n| `adSystem` | `string` Required. The name of ad system generating the ingest request. |\n| `adTitle` | `string` The title of the advertisement. |\n| `adDescription` | `string` The description of the advertisement. |\n| `mezzanines[]` | `object (`[MediaFile](/video-creative-ingest/rest/v1/creatives#MediaFile)`)` The ad's mezzanine file URLs and their properties. At least one of mezannines or mediaFiles is required. |\n| `mediaFiles[]` | `object (`[MediaFile](/video-creative-ingest/rest/v1/creatives#MediaFile)`)` The ad's media file URLs and their properties. At least one of mezannines or mediaFiles is required. |\n| `networkCode` | `string` Optional. The Google Ad Manager network code of the publisher for which the creative is intended. Required if the creative is dynamic and has DynamicCreativeInfo populated in the CreateCreativeRequest. |\n\nMediaFile\n---------\n\nThe properties related to a given media file.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"uri\": string, \"delivery\": enum (/video-creative-ingest/rest/v1/creatives#Delivery), \"height\": integer, \"width\": integer, \"mimeType\": string, \"minBitrate\": integer, \"maxBitrate\": integer } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| `uri` | `string` Required. The unique URL to the creative's media file. |\n| `delivery` | `enum (`[Delivery](/video-creative-ingest/rest/v1/creatives#Delivery)`)` Required. The delivery type of the creative. |\n| `height` | `integer` The native height of video file, in pixels. |\n| `width` | `integer` The native width of video file, in pixels. |\n| `mimeType` | `string` Required. The MIME type for the file container. Popular MIME types include \"video/x-flv\" for Flash Video and \"video/mp4\" for MP4. |\n| `minBitrate` | `integer` The minimum bitrate of media file. For progressive load video, this value should be the average bitrate. |\n| `maxBitrate` | `integer` The maximum bitrate of media file. For progressive load video, this value should be the average bitrate. |\n\nDelivery\n--------\n\nDelivery types.\n\n| Enums ||\n|------------------------|-----------------------------|\n| `DELIVERY_UNSPECIFIED` | Default delivery value. |\n| `DELIVERY_PROGRESSIVE` | Progressive video delivery. |\n| `DELIVERY_STREAMING` | Streaming video delivery. |\n\n| Methods ------- ||\n|---------------------------------------------------------------|---------------------|\n| ### [create](/video-creative-ingest/rest/v1/creatives/create) | Creates a Creative. |\n| ### [delete](/video-creative-ingest/rest/v1/creatives/delete) | Deletes a Creative. |\n| ### [get](/video-creative-ingest/rest/v1/creatives/get) | Gets a Creative. |"]]