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

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á và chỉ số phân đoạn có trong phương thức GoogleAdsService Search và SearchStream. Danh mục này cung cấp 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 trong Ngôn ngữ truy vấn của Google Ads.

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

Lưu ý: Ví dụ này đưa ra yêu cầu HTTP/JSON cơ bản dưới dạng hướng dẫn, nhưng bạn nên sử dụng một trong các thư viện ứng dụng dựa trên gRPC để gửi yêu cầu.

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

https://googleads.googleapis.com/v16/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/v16/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 kết hợp ngầm với tài nguyên trong mệnh đề FROM.

metrics

Các chỉ số có thể chọn cùng với tài nguyên trong mệnh đề FROM. Chỉ đ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 chúng ta đang chọn ad_group.id và segments.date từ ad_group và muốn đưa các thuộc tính từ campaign vào, chúng ta 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ó.

Chi tiết 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 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.