您可以使用 GoogleAdsFieldService
可以針對資源、資源欄位、區隔
GoogleAdsService
提供的鍵和指標
Search 和 SearchStream 方法。目錄提供的中繼資料可以
Google Ads API 用戶端用來驗證和建構 Google Ads 查詢語言陳述式。
HTTP 要求和回應範例
該要求將 HTTP GET
傳送至 Google Ads API 伺服器,如下所示
網址:
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
子句中資源選取的指標。僅限 會填入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
。