资源元数据

您可以使用 GoogleAdsFieldService 动态请求资源目录、资源字段、细分 GoogleAdsService中提供的 Search 和 SearchStream 方法。目录提供了 供 Google Ads API 客户端用来验证和构建 Google Ads 查询语言语句。

示例 HTTP 请求和响应

该请求包含一个指向以下网址的 Google Ads API 服务器的 HTTP GET：

https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}

以下为一个请求示例，后跟从 GoogleAdsFieldService（针对 ad_group 资源）：

请求

https://googleads.googleapis.com/v17/googleAdsFields/ad_group

响应

{
  "resourceName": "googleAdsFields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device",
    ...
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],

  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks",
    ...
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device",
    ...
  ]
}

在本例中，重要的数组是：

attributeResources

可隐式连接到 FROM 子句中的资源的资源。

metrics

可使用 FROM 子句中的资源进行选择的可用指标。仅限 对于 category 为 RESOURCE 的字段，此字段会填充内容。

segments

可使用 FROM 子句中的资源进行选择的细分键。 这些键用于细分相关查询中指定的指标。仅对于 category 为 RESOURCE 的字段，此指标才会显示内容。

selectableWith

不在 FROM 中时，可与指定字段一起选择的字段 子句。此属性仅适用于下面的情况：正在识别可在查询中选择的资源或细分，但在该查询中，这些资源或细分又没有包含在 FROM 子句中的资源中。例如，如果我们选择 ad_group.id， 和来自 ad_group 的 segments.date，我们希望包含来自 campaign，我们需要检查 segments.date 是否在 selectableWith 中 属性，因为它是与现有的 segments.date 字段。

元数据详情

您可以在以下级别使用 GoogleAdsFieldService 请求目录：

资源

例如 googleAdsFields/campaign。

资源的字段

例如 googleAdsFields/campaign.name。

细分字段

例如 googleAdsFields/segments.ad_network_type。

指标

例如 googleAdsFields/metrics.clicks。