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

Bạn có thể sử dụng GoogleAdsFieldService để yêu cầu động danh mục đối với các tài nguyên, trường tài nguyên, khóa phân đoạn và các chỉ số có trong phương thức GoogleAdsService Tìm kiếmSearchStream. Danh mục cung cấp những siêu dữ liệu mà ứng dụng API Google Ads có thể sử dụng để xác thực và tạo câu lệnh Ngôn ngữ truy vấn Google Ads.

Ví dụ về yêu cầu HTTP và phản hồi

Yêu cầu bao gồm HTTP GET đến máy chủ API Google Ads tại URL sau:

https://googleads.googleapis.com/v11/googleAdsFields/{resource_or_field}

Sau đây là ví dụ về một yêu cầu, theo sau là phản hồi trả về từ GoogleAdsFieldService cho tài nguyên ad_group:

Yêu cầu

https://googleads.googleapis.com/v11/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 ngầm liên kết với tài nguyên trong mệnh đề FROM.
metrics
Những chỉ số có thể chọn được chọn bằng tài nguyên trong mệnh đề FROM. Chỉ được điền cho các trường có categoryRESOURCE.
segments
Bạn có thể chọn tài nguyên phân đoạn có thể 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 cho các trường trong đó categoryRESOURCE.
selectableWith
Bạn có thể chọn các trường có thể sử dụng cùng với một trường nhất định, khi các trường đó không có trong điều khoản 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 trong một truy vấn không có các tài nguyên hoặc điều kiện đó trong mệnh đề FROM. Ví dụ: nếu chúng tôi chọn ad_group.idsegments.date từ ad_group, đồng thời, chúng tôi muốn bao gồm các thuộc tính từ campaign, chúng tôi sẽ 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ì nó được chọn cùng với trường segments.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 GoogleAdsFieldService ở các cấp sau:

Tài nguyên
Ví dụ: googleAdsFields/campaign.
Trường của 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.