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

Bạn có thể sử dụng SearchAds360FieldService để yêu cầu danh mục tài nguyên một cách linh động, các trường của tài nguyên, các chỉ số và khoá phân đoạn có sẵn trong SearchAds360Service Phương thức Search và SearchStream. Danh mục này cung cấp siêu dữ liệu có thể được khách hàng sử dụng API Báo cáo Search Ads 360 sử dụng để xác thực và xây dựng Search Ads 360 Câu lệnh của Ngôn ngữ truy vấn.

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 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 liên kết ngầm với tài nguyên trong FROM mệnh đề.

metrics

Các chỉ số có thể chọn cùng tài nguyên trong FROM mệnh đề. Chỉ được điền sẵ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 trong đó 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 FROM mệnh đề. Thuộc tính này chỉ liên quan khi xác định các tài nguyên hoặc phân khúc có thể được chọn trong một truy vấn mà chúng không được đưa vào trong mệnh đề FROM. Ví dụ: nếu bạn chọn ad_group.id và segments.date từ ad_group, đồng thời bạn muốn thêm các thuộc tính từ campaign, bạn cần kiểm tra để đảm bảo rằng segments.date nằm trong selectableWith cho chiến dịch, vì thuộc tính này được chọn cùng với thuộc tính 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 SearchAds360FieldService tại cấp độ:

Tài nguyên

Ví dụ: searchAds360Fields/campaign.

Trường 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 những 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"
  )