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

Bạn có thể sử dụng GoogleAdsFieldService để yêu cầu một danh mục cho các tài nguyên, các trường của tài nguyên, phân đoạn một cách linh động khoá và chỉ số có sẵn trong GoogleAdsService Phương thức Tìm kiếm và SearchStream. Danh mục này cung cấp siêu dữ liệu có thể mà khách hàng sử dụng API Google Ads sử dụng để xác thực và xây dựng 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 chỉ đưa ra yêu cầu HTTP/JSON cơ bản làm hướng dẫn, nhưng bạn bạn nên dùng một trong các thư viện ứng dụng dựa trên gRPC để gửi yêu cầu của bạn.

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

https://googleads.googleapis.com/v17/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/v17/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 liên kết 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

Các 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. Chẳng hạn như nếu chúng ta chọn ad_group.id và segments.date từ ad_group, và chúng ta muốn bao gồm các thuộc tính từ campaign, chúng ta cần kiểm tra để đảm bảo rằng segments.date có 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 hiện có Trường segments.date.

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 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.