Bạn có thể sử dụng GoogleAdsFieldService
để yêu cầu danh mục một cách linh động cho các tài nguyên, trường của tài nguyên, khoá phân đoạn và chỉ số có sẵn trong phương thức GoogleAdsService
Tìm kiếm và SearchStream. Danh mục này cung cấp siêu dữ liệu mà các ứng dụng API Google Ads có thể sử dụng để xác thực và xây dựng câu lệnh Ngôn ngữ truy vấn của Google Ads.
Yêu cầu và phản hồi HTTP mẫu
Yêu cầu bao gồm một HTTP GET
gửi đến máy chủ API Google Ads tại URL sau:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
Sau đây là ví dụ về một yêu cầu, theo sau là phản hồi được trả về từ GoogleAdsFieldService
cho tài nguyên ad_group:
Yêu cầu
https://googleads.googleapis.com/v17/googleAdsFields/ad_group
Phản hồi
{
"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",
...
]
}
Trong ví dụ này, các mảng quan trọng là:
attributeResources
- Các tài nguyên có thể được liên kết ngầm với tài nguyên trong mệnh đề
FROM
. metrics
- Các chỉ số có thể chọn cùng tài nguyên trong mệnh đề
FROM
. Chỉ được điền cho các trường cócategory
làRESOURCE
. segments
- Khoá phân đoạn có thể được chọn bằng tài nguyên trong mệnh đề
FROM
. Các phân đoạn này phân đoạn các chỉ số được chỉ định trong truy vấn. Chỉ được điền sẵn cho các trường cócategory
làRESOURCE
. selectableWith
-
- Các trường có thể được chọn cùng với một trường nhất định, khi không nằm trong mệnh đề
FROM
. Thuộc tính này chỉ liên quan khi xác định các tài nguyên hoặc phân đoạn có thể được chọn trong một truy vấn mà tài nguyên không có trong mệnh đềFROM
. Ví dụ: nếu chọnad_group.id
vàsegments.date
từad_group
và muốn thêm các thuộc tính từcampaign
, chúng ta sẽ phải kiểm tra để đảm bảo rằngsegments.date
nằm trong thuộc tínhselectableWith
cho chiến dịch, vì thuộc tính này được chọn cùng với trườngsegments.date
hiện có.
Thông tin chi tiết về siêu dữ liệu
Bạn có thể yêu cầu danh mục bằng GoogleAdsFieldService
ở các cấp sau:
- Tài nguyên
- Ví dụ:
googleAdsFields/campaign
. - Trường tài nguyên
- Ví dụ:
googleAdsFields/campaign.name
. - Trường phân đoạn
- Ví dụ:
googleAdsFields/segments.ad_network_type
. - Chỉ số
- Ví dụ:
googleAdsFields/metrics.clicks
.