資源中繼資料

您可以使用 SearchAds360FieldService 可針對資源、資源欄位、 SearchAds360Service中可用的區隔鍵和指標 Search 和 SearchStream 方法。目錄提供的中繼資料可以 供 Search Ads 360 Reporting API 用戶端用於驗證及建構 Search Ads 360 查詢語言陳述式。

HTTP 要求和回應範例

注意： 本範例會將基礎 HTTP/JSON 要求顯示為指南，但 強烈建議使用其中一個用戶端程式庫 使用 gRPC 以提交要求。

該要求是由 HTTP GET 傳送至 Search Ads 360 Reporting API 伺服器， 下列網址：

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

以下範例顯示要求，後面接著來自 ad_group 資源的 SearchAds360FieldService：

要求

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"
  )