AdGroupAd

广告组广告。

JSON 表示法
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "policySummary": {
    object (AdGroupAdPolicySummary)
  },
  "adStrength": enum (AdStrength),
  "actionItems": [
    string
  ],
  "labels": [
    string
  ],
  "primaryStatus": enum (AdGroupAdPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupAdPrimaryStatusReason)
  ],
  "adGroupAdAssetAutomationSettings": [
    {
      object (AdGroupAdAssetAutomationSetting)
    }
  ],
  "adGroup": string
}
字段
resourceName

string

不可变。广告的资源名称。广告组广告资源名称的格式如下:

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

status

enum (AdGroupAdStatus)

广告的状态。

ad

object (Ad)

不可变。广告。

policySummary

object (AdGroupAdPolicySummary)

仅限输出。广告的政策信息。

adStrength

enum (AdStrength)

仅限输出。广告组广告的整体广告效力。

actionItems[]

string

仅限输出。一系列有助于提升广告效力的建议。例如,系统可能会建议您“尝试再添加一些独具特色的标题,或取消固定部分素材资源”。

labels[]

string

仅限输出。附加到此广告组广告的标签的资源名称。

primaryStatus

enum (AdGroupAdPrimaryStatus)

仅限输出。提供汇总视图,让您了解广告组广告未投放或未以最佳方式投放的原因。

primaryStatusReasons[]

enum (AdGroupAdPrimaryStatusReason)

仅限输出。提供广告组广告未投放或未以最佳方式投放的原因。

adGroupAdAssetAutomationSettings[]

object (AdGroupAdAssetAutomationSetting)

用于控制素材资源自动化操作类型的设置。如需了解每种类型的默认选择启用/停用行为,请参阅 AssetAutomationTypeEnum 文档。

adGroup

string

不可变。广告所属的广告组。

AdGroupAdStatus

AdGroupAd 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

这是仅限响应的值。

ENABLED 广告组广告已启用。
PAUSED 广告组中的广告已暂停。
REMOVED 广告组广告已移除。

AdGroupAdPolicySummary

包含广告的政策信息。

JSON 表示法
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
字段
policyTopicEntries[]

object (PolicyTopicEntry)

仅限输出。此广告的政策违规处置结果列表。

reviewStatus

enum (PolicyReviewStatus)

仅限输出。此广告在审核流程的哪个阶段。

approvalStatus

enum (PolicyApprovalStatus)

仅限输出。此广告的整体审批状态,根据其各个政策主题条目的状态计算得出。

AdGroupAdPrimaryStatus

AdGroupAd 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ELIGIBLE 广告组的广告符合投放条件。
PAUSED 广告组中的广告已暂停。
REMOVED 广告组广告已移除。
PENDING 广告目前无法投放,但在广告客户不采取任何措施的情况下,日后或许可以投放。
LIMITED 广告组广告的投放量受限。
NOT_ELIGIBLE 广告组广告不符合投放条件。

AdGroupAdPrimaryStatusReason

可能导致广告组广告处于此状态的原因。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CAMPAIGN_REMOVED 系统会移除用户指定的广告系列状态。会导致 AdGroupAdPrimaryStatus.REMOVED。
CAMPAIGN_PAUSED 用户指定的广告系列状态为“暂停”。会影响 AdGroupAdPrimaryStatus.PAUSED。
CAMPAIGN_PENDING 用户为此广告系列指定的开始时间是未来的某个时间。会影响 AdGroupAdPrimaryStatus.PENDING。
CAMPAIGN_ENDED 用户指定的此广告系列的结束时间已过。会影响 AdGroupAdPrimaryStatus.ENDED。
AD_GROUP_PAUSED 用户指定的广告组状态为“暂停”。会影响 AdGroupAdPrimaryStatus.PAUSED。
AD_GROUP_REMOVED 系统会移除用户指定的广告组状态。会导致 AdGroupAdPrimaryStatus.REMOVED。
AD_GROUP_AD_PAUSED 用户指定的广告状态为“暂停”。会影响 AdGroupAdPrimaryStatus.PAUSED。
AD_GROUP_AD_REMOVED 系统会移除用户指定的广告状态。会导致 AdGroupAdPrimaryStatus.REMOVED。
AD_GROUP_AD_DISAPPROVED 广告被拒登。会导致 AdGroupAdPrimaryStatus.NOT_ELIGIBLE。
AD_GROUP_AD_UNDER_REVIEW 广告正在接受审核。会影响 AdGroupAdPrimaryStatus.PENDING。
AD_GROUP_AD_POOR_QUALITY 广告画质不佳。这由投放广告的广告投放堆栈决定。会影响 AdGroupAdPrimaryStatus.LIMITED。
AD_GROUP_AD_NO_ADS 无法生成任何符合条件的广告实例。会影响 AdGroupAdPrimaryStatus.PENDING。
AD_GROUP_AD_APPROVED_LABELED 系统会在内部为广告添加限制性标签。会影响 AdGroupAdPrimaryStatus.LIMITED。
AD_GROUP_AD_AREA_OF_INTEREST_ONLY 广告仅在用户指定的兴趣所在地投放。会影响 AdGroupAdPrimaryStatus.LIMITED。
AD_GROUP_AD_UNDER_APPEAL 广告正在接受申诉。此原因不会影响 AdGroupAdPrimaryStatus。

AdGroupAdAssetAutomationSetting

AdGroupAd 的素材资源自动化设置。

JSON 表示法
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
字段
assetAutomationType

enum (AssetAutomationType)

此设置配置的素材资源自动化类型。

assetAutomationStatus

enum (AssetAutomationStatus)

指定的素材资源自动化类型的“用户选择启用/停用”状态。