See the overview for an explanation of format.
| Field | Required | Type | Writable | Description |
|---|---|---|---|---|
| Ad Id | Required only when editing existing Ads | integer | No | Numeric ID value of the ad group ad. If left blank a new Ad will be created and a unique ID will be assigned. |
| Ad Group Id | Yes | integer | No | Numeric ID value of the parent ad group. You can specify a custom identifier (for example, "ext[custom ad group ID]") for an Ad Group that you are creating at the same time as this Ad. |
| Name | Yes | string | Yes | The name of the entry. |
| Status | Yes | string | Yes | The status setting for the entry.
|
| Video Id | Yes | string | Yes | The YouTube video ID |
| In-stream Display URL | Yes for In-stream | string | Yes | The ad display URL |
| In-stream Landing Page URL | Yes for In-stream | string | Yes | The ad landing page URL |
| In-stream Click Tracker URL | No | string | Yes | The ad click tracker URL |
| In-stream Custom Parameters | No | string, list of lists | Yes | The click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc. |
| Video Discovery Video Thumbnail | Yes for Video Discovery | string | Yes | The video thumbnail to use for video discovery ads
|
| Video Discovery Headline | Yes for Video Discovery | string | Yes | The discovery ad headline text |
| Video Discovery Description 1 | Yes for Video Discovery | string | Yes | The discovery ad description 1 text |
| Video Discovery Description 2 | Yes for Video Discovery | string | Yes | The discovery ad description 2 text |
| Video Discovery Landing Page | Yes for Video Discovery | string | Yes | The discovery ad landing page |
| Mobile App Id | Yes for Mobile App Install subtype | string | Yes | The mobile app used for mobile app install ads. Format:com.google.android.gm or 422689480 |