资源元数据

您可以使用 SearchAds360FieldService 动态请求资源目录 SearchAds360Service中提供的细分键和指标 Search 和 SearchStream 方法。目录提供了 供 Search Ads 360 Reporting API 客户端用于验证和构建 Search Ads 360 查询语言语句。

示例 HTTP 请求和响应

注意 ：此示例仅展示底层 HTTP/JSON 请求，但您需要 强烈建议您使用下面其中一个客户端库 gRPC 提交请求。

此请求包含发送到 Search Ads 360 Reporting API 服务器的 HTTP GET，位于 以下网址：

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

请求

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

响应

{
  "resourceName": "searchAds360Fields/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 字段。

元数据详情

您可以在以下位置使用SearchAds360FieldService请求目录： 级别：

资源

例如 searchAds360Fields/campaign。

资源的字段

例如 searchAds360Fields/campaign.name。

细分字段

例如 searchAds360Fields/segments.ad_network_type。

指标

例如 searchAds360Fields/metrics.clicks。

使用查询获取字段详细信息

要获取字段详细信息，可以向

https://searchads360.googleapis.com/v0/searchAds360Fields:search

示例 1：使用正则表达式。

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

示例 2：查询特定字段、指标或细分。

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )