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

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/v22/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/v22/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ể đượ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ân khúc 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

Thuộc tính selectableWith trên một trường tài nguyên hoặc phân đoạn chỉ định các tài nguyên, phân đoạn hoặc chỉ số khác có thể được chọn trong cùng một truy vấn GAQL. Thuộc tính này rất quan trọng khi bạn muốn thêm các trường từ một tài nguyên hoặc phân đoạn không được chỉ định trong mệnh đề FROM.

Khi tạo một truy vấn GAQL:

1.  Tài nguyên trong mệnh đề FROM là thực thể chính. Bạn luôn có thể chọn các trường từ tài nguyên này.
2.  Bạn cũng có thể chọn các chỉ số và phân khúc tương thích có sẵn với thực thể chính.
3.  Nếu đưa các trường từ bất kỳ tài nguyên hoặc phân đoạn nào bên ngoài mệnh đề FROM, bạn phải đảm bảo rằng tài nguyên hoặc phân đoạn không phải FROM này tương thích với tất cả các trường, phân đoạn và chỉ số khác được chọn trong truy vấn.

Danh sách selectableWith cho một tài nguyên cụ thể (gọi là Tài nguyên A) chứa tất cả các tài nguyên, phân đoạn và chỉ số khác có thể được chọn cùng với các trường từ Tài nguyên A khi Tài nguyên A không phải là thực thể chính.

Ví dụ:

Hãy xem xét cụm từ tìm kiếm mẫu này: SELECT ad_group.id, segments.date, campaign.name FROM ad_group

•   Mệnh đề FROM chỉ định ad_group.

•   Truy vấn này chọn ad_group.id (từ tài nguyên FROM), segments.date và campaign.name.

•   Vì bạn đã chọn campaign.name nhưng không chọn campaign trong điều khoản FROM, nên bạn phải xác minh khả năng tương thích của campaign.name với các phần tử đã chọn khác.

•   Để đảm bảo truy vấn này hợp lệ, tài nguyên campaign phải tương thích với segments.date (một trường khác đang được chọn). Do đó, bạn phải kiểm tra thuộc tính selectableWith cho tài nguyên campaign. Nếu segments.date có trong danh sách selectableWith của campaign, thì truy vấn đó là hợp lệ.

Nếu bạn chọn các trường từ một tài nguyên không có trong mệnh đề FROM, thì danh sách selectableWith của tài nguyên đó phải bao gồm tất cả các phân đoạn và tài nguyên khác có trong mệnh đề SELECT.

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.