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 hoạt cho các tài nguyên, trường của tài nguyên, khoá phân đoạn và chỉ số có trong các phương thức GoogleAdsService Tìm kiếm và SearchStream. Danh mục này cung cấp siêu dữ liệu mà các ứng dụng API Google Ads có thể dùng để xác thực và tạo câu lệnh Ngôn ngữ truy vấn của Google Ads.

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

Lưu ý: Ví dụ này minh hoạ yêu cầu HTTP/JSON cơ bản làm 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 này bao gồm một HTTP GET đến máy chủ API Google Ads tại URL sau:

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

Ví dụ sau đây cho thấy 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/v20/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

Những 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ể đượ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

Khoá phân đoạn có thể được chọn bằng tài nguyên trong mệnh đề FROM. Các phương diện này phân đoạn những 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 có trong mệnh đề FROM. Thuộc tính này chỉ liên quan khi xác định những 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 được đưa vào trong mệnh đề FROM. Ví dụ: nếu chúng ta chọn ad_group.id và segments.date trong ad_group, đồng thời muốn thêm các thuộc tính từ campaign, thì chúng ta cần kiểm tra để đảm bảo segments.date nằm trong thuộc tính selectableWith của chiến dịch, vì thuộc tính này đang đượ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 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.