Ad
Ad entity that links an ad creative to an ad group for serving.
Declaration
object AdProperties
| Name | Type | Description |
|---|---|---|
id | int64 | The unique identifier of the ad. Read-only. |
name | string | Advertiser-given name of the ad. Mutable. |
status | Ad.Status | Advertiser-configurable status. Use to pause or enable the ad. See AdStatus. Mutable. |
adAccountId | int64 | The identifier of the ad account this ad belongs to. Immutable after creation. |
campaignId | int64 | The identifier of the campaign this ad belongs to. Immutable after creation. |
adGroupId | int64 | The identifier of the ad group this ad belongs to. Immutable after creation. |
creativeId | int64 | The unique identifier of the ad creative this ad was created from. Immutable after creation. |
systemStatus | Ad.SystemStatus | System-computed serving status of the ad. See AdSystemStatus. Read-only. |
systemStatusReasons | [Ad.SystemStatusReasons] | Reasons for the current system status. Populated when the ad is not serving. Possible values: |
systemStatusLimitingReasons | [Ad.SystemStatusLimitingReasons] | System status limited reasons for the ad. Possible values: |
creationTime | date-time | Timestamp when the ad was created. Read-only. |
modificationTime | date-time | Timestamp of the last modification to the ad. Read-only. |
displayStatus | Ad.DisplayStatus | Rolled-up delivery state combining ad, ad group, and campaign conditions. Possible values: |
deleted | boolean | Indicates whether the ad is deleted. Read-only. |
Discussion
An Ad links a Creative to an AdGroup and is the atomic serving unit, the object that appears to users. To serve a different ad creative on an ad group, create a new ad rather than modifying an existing one.
The status field is the advertiser-controlled on/off switch. The ENABLED value allows the ad to participate in auctions. The PAUSED value suspends it.
When systemStatus is NOT_RUNNING, inspect systemStatusReasons for the cause. Common causes include ad creative review pending (AD_APPROVAL_PENDING), a rejected ad creative (AD_APPROVAL_CREATIVE_DOC_REJECTED), or an incompatible product page (PRODUCT_PAGE_INCOMPATIBLE).
Fields you can filter and sort on when querying ads are listed in Query Ads.
Example
{
"id": 777888999,
"name": "AwayFinder - Default Product Page",
"status": "ENABLED",
"adAccountId": 123456789,
"campaignId": 444555666,
"adGroupId": 555666777,
"creativeId": 666777888,
"systemStatus": "RUNNING",
"systemStatusReasons": [],
"systemStatusLimitingReasons": [],
"creationTime": "2025-09-01T08:00:00.000",
"modificationTime": "2025-09-01T08:00:00.000",
"displayStatus": "RUNNING",
"deleted": false
}