Siêu dữ liệu tài nguyên

Bạn có thể sử dụng SearchAds360FieldService để linh động yêu cầu danh mục cho 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à ứng dụng API Báo cáo Search Ads 360 có thể sử dụng để xác thực và tạo câu lệnh Ngôn ngữ truy vấn Search Ads 360.

Yêu cầu và phản hồi HTTP mẫu

Yêu cầu này bao gồm một HTTP GET đến 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",
    ...
  ]
}

Đối với ví dụ này, các mảng quan trọng là:

attributeResources
Các tài nguyên có thể được tham gia ngầm ẩn vào tài nguyên trong mệnh đề FROM.
metrics
Các chỉ số có thể được 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
Các khoá phân đoạn có thể được chọn bằng tài nguyên trong mệnh đề FROM. Các chỉ số 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ỉ có 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 đưa các phân đoạn đó vào mệnh đề FROM. Ví dụ: nếu bạn chọn ad_group.id và segments.date từ ad_group và muốn thêm các thuộc tính từ campaign, thì bạn cần kiểm tra để đảm bảo rằng segments.date nằm trong thuộc tính selectableWith cho chiến dịch, vì thuộc tính này được chọn cùng với trường segments.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 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 truy vấn để lấy thông tin chi tiết về trường

Có thể lấy thông tin chi tiết của 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 khúc 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"
  )