Bạn có thể sử dụng SearchAds360FieldService
để linh động yêu cầu danh mục tài nguyên, trường của tài nguyên, khoá phân đoạn và chỉ số có trong phương thức SearchAds360Service
Search
và SearchStream
. Danh mục này cung cấp siêu dữ liệu mà các ứng dụng API Báo cáo Search Ads 360 có thể sử dụng để xác thực và tạo các câu lệnh cho Ngôn ngữ truy vấn của Search Ads 360.
Yêu cầu HTTP và phản hồi mẫu
Yêu cầu bao gồm một HTTP GET
gửi tới máy chủ API Báo cáo Search Ads 360 tại URL sau:
https://searchads360.googleapis.com/v0/searchAds360Fields/{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ừ SearchAds360FieldService
cho tài nguyên ad_group:
Yêu cầu
https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group
Phản hồi
{
"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",
...
]
}
Trong ví dụ này, các mảng quan trọng là:
attributeResources
- Các tài nguyên có thể được kết hợp ngầm với tài nguyên trong mệnh đề
FROM
. metrics
- Các chỉ số có sẵn để chọn cùng với tài nguyên trong mệnh đề
FROM
. Chỉ được điền sẵn cho các trường cócategory
làRESOURCE
. segments
- Phân đoạn các khoá có thể được chọn bằng tài nguyên trong mệnh đề
FROM
. Các phân đoạn này 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
- Những 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ỉ phù hợp khi xác định các tài nguyên hoặc phân đoạn có thể chọn được trong truy vấn mà tài nguyên hoặc phân đoạn đó không được tài nguyên đưa vào trong mệnh đềFROM
. Ví dụ: nếu bạn đang chọnad_group.id
vàsegments.date
từad_group
và muốn đưa các thuộc tính từcampaign
vào, bạn cần 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ó.
Chi tiết siêu dữ liệu
Bạn có thể yêu cầu danh mục bằng cách sử dụng SearchAds360FieldService
ở các cấp sau:
- Tài nguyên
- Ví dụ:
searchAds360Fields/campaign
. - Trường của tài nguyên
- Ví dụ:
searchAds360Fields/campaign.name
. - Trường phân đoạn
- Ví dụ:
searchAds360Fields/segments.ad_network_type
. - Chỉ số
- Ví dụ:
searchAds360Fields/metrics.clicks
.
Sử dụng một truy vấn để lấy thông tin chi tiết về trường
Có thể lấy thông tin chi tiết về trường bằng cách gửi truy vấn tới
https://searchads360.googleapis.com/v0/searchAds360Fields:search
Ví dụ 1: Sử dụng biểu thức chính quy.
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name LIKE 'ad_group.%'"
Ví dụ 2: Truy vấn các trường, chỉ số hoặc phân đoạn cụ thể.
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"
)