AdGroupAd

An ad group ad.

JSON representation
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "policySummary": {
    object (AdGroupAdPolicySummary)
  },
  "adStrength": enum (AdStrength),
  "actionItems": [
    string
  ],
  "labels": [
    string
  ],
  "primaryStatus": enum (AdGroupAdPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupAdPrimaryStatusReason)
  ],
  "adGroup": string
}
Fields
resourceName

string

Immutable. The resource name of the ad. Ad group ad resource names have the form:

customers/{customerId}/adGroupAds/{adGroupId}~{ad_id}

status

enum (AdGroupAdStatus)

The status of the ad.

ad

object (Ad)

Immutable. The ad.

policySummary

object (AdGroupAdPolicySummary)

Output only. Policy information for the ad.

adStrength

enum (AdStrength)

Output only. Overall ad strength for this ad group ad.

actionItems[]

string

Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.".

labels[]

string

Output only. The resource names of labels attached to this ad group ad.

primaryStatus

enum (AdGroupAdPrimaryStatus)

Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally.

primaryStatusReasons[]

enum (AdGroupAdPrimaryStatusReason)

Output only. Provides reasons for why an ad group ad is not serving or not serving optimally.

adGroup

string

Immutable. The ad group to which the ad belongs.

AdGroupAdStatus

The possible statuses of an AdGroupAd.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The ad group ad is enabled.
PAUSED The ad group ad is paused.
REMOVED The ad group ad is removed.

AdGroupAdPolicySummary

Contains policy information for an ad.

JSON representation
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Fields
policyTopicEntries[]

object (PolicyTopicEntry)

Output only. The list of policy findings for this ad.

reviewStatus

enum (PolicyReviewStatus)

Output only. Where in the review process this ad is.

approvalStatus

enum (PolicyApprovalStatus)

Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries.

AdGroupAdPrimaryStatus

The possible statuses of an AdGroupAd.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
ELIGIBLE The ad group ad is eligible to serve.
PAUSED The ad group ad is paused.
REMOVED The ad group ad is removed.
PENDING The ad cannot serve now, but may serve later without advertiser action.
LIMITED The ad group ad is serving in a limited capacity.
NOT_ELIGIBLE The ad group ad is not eligible to serve.

AdGroupAdPrimaryStatusReason

Possible ad group ad status reasons.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
CAMPAIGN_REMOVED The user-specified campaign status is removed. Contributes to AdGroupAdPrimaryStatus.REMOVED.
CAMPAIGN_PAUSED The user-specified campaign status is paused. Contributes to AdGroupAdPrimaryStatus.PAUSED.
CAMPAIGN_PENDING The user-specified time for this campaign to start is in the future. Contributes to AdGroupAdPrimaryStatus.PENDING.
CAMPAIGN_ENDED The user-specified time for this campaign to end has passed. Contributes to AdGroupAdPrimaryStatus.ENDED.
AD_GROUP_PAUSED The user-specified ad group status is paused. Contributes to AdGroupAdPrimaryStatus.PAUSED.
AD_GROUP_REMOVED The user-specified ad group status is removed. Contributes to AdGroupAdPrimaryStatus.REMOVED.
AD_GROUP_AD_PAUSED The user-specified ad status is paused. Contributes to AdGroupAdPrimaryStatus.PAUSED.
AD_GROUP_AD_REMOVED The user-specified ad status is removed. Contributes to AdGroupAdPrimaryStatus.REMOVED.
AD_GROUP_AD_DISAPPROVED The ad is disapproved. Contributes to AdGroupAdPrimaryStatus.NOT_ELIGIBLE.
AD_GROUP_AD_UNDER_REVIEW The ad is under review. Contributes to AdGroupAdPrimaryStatus.PENDING.
AD_GROUP_AD_POOR_QUALITY The ad is poor quality. This is determined by the serving stack that served the Ad. Contributes to AdGroupAdPrimaryStatus.LIMITED.
AD_GROUP_AD_NO_ADS No eligible ads instances could be generated. Contributes to AdGroupAdPrimaryStatus.PENDING.
AD_GROUP_AD_APPROVED_LABELED The ad is internally labeled with a limiting label. Contributes to AdGroupAdPrimaryStatus.LIMITED.
AD_GROUP_AD_AREA_OF_INTEREST_ONLY The ad is only serving in the user-specified area of interest. Contributes to AdGroupAdPrimaryStatus.LIMITED.
AD_GROUP_AD_UNDER_APPEAL The ad is part of an ongoing appeal. This reason does not impact AdGroupAdPrimaryStatus.