資源中繼資料

您可以使用 GoogleAdsFieldService 可以針對資源、資源欄位、區隔 GoogleAdsService 提供的鍵和指標 SearchSearchStream 方法。目錄提供的中繼資料可以 Google Ads API 用戶端用來驗證和建構 Google Ads 查詢語言陳述式。

HTTP 要求和回應範例

這項要求包含以下網址中 Google Ads API 伺服器的 HTTP GET

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

以下範例顯示要求,後面接著來自 ad_group 資源的 GoogleAdsFieldService

要求

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 子句中資源選取的指標。僅限 會填入 categoryRESOURCE 的欄位。
segments
區隔可以使用 FROM 子句中資源選取的鍵。 這些區隔會將查詢中指定的指標劃分。僅針對欄位填入資料 其中 categoryRESOURCE
selectableWith
如果不在 FROM 子句中,可與特定欄位一併選取的欄位。只有在識別資源或區隔時,才需要使用這項屬性 可在查詢中選取,但這些函式並未由 FROM 子句中的資源。舉例來說,如果選取 ad_group.id 以及來自「ad_group」的「segments.datecampaign,我們需要檢查 segments.date 是否位於 selectableWith 屬性,因為這是與現有廣告活動一併選取 「segments.date」欄位中的值。

中繼資料詳細資料

您可以在下列層級使用 GoogleAdsFieldService 要求目錄:

資源
例如:googleAdsFields/campaign
資源的欄位
例如:googleAdsFields/campaign.name
區隔欄位
例如:googleAdsFields/segments.ad_network_type
指標
例如:googleAdsFields/metrics.clicks