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

Bạn có thể sử dụng GoogleAdsFieldService (thông qua GetGoogleAdsField hoặc SearchGoogleAdsFields) để yêu cầu danh mục tài nguyên, trường tài nguyên, khoá phân đoạn và chỉ số có sẵn trong các phương thức GoogleAdsService Search và SearchStream một cách linh động. Danh mục này cung cấp siêu dữ liệu mà các ứng dụng Google Ads API có thể sử dụng để xác thực và tạo các 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ủ Google Ads API tại URL sau:

https://googleads.googleapis.com/v26/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/v26/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 mà không cần phân đoạn chỉ số. Chỉ được điền sẵn cho các trường có category là RESOURCE.
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 (trường segments.* và tài nguyên phân đoạn) có thể được chọn cùng với tài nguyên trong mệnh đề FROM. Các chỉ số 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 có category là RESOURCE.
selectableWith
Tài nguyên, phân đoạn hoặc chỉ số có thể được chọn trong cùng một truy vấn Ngôn ngữ truy vấn Google Ads khi tài nguyên hoặc phân đoạn này không phải là tài nguyên chính trong mệnh đề FROM.

Truy vấn khả năng tương thích với 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 Ngôn ngữ truy vấn Google Ads. Thuộc tính này rất quan trọng khi bạn muốn đưa 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 vào.

Khi tạo một truy vấn bằng Ngôn ngữ truy vấn của Google Ads:

  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 trong 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 thêm 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 thuộc 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ể (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 sau:

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ì campaign.name được chọn nhưng campaign không nằm trong mệnh đề FROM, nên bạn phải xác minh khả năng tương thích của mệnh đề này 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 đó 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 của bạn.

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 cách sử dụng GoogleAdsFieldService (theo tên tài nguyên bằng GetGoogleAdsField hoặc bằng cách truy vấn bằng SearchGoogleAdsFields) ở các cấp GoogleAdsFieldCategory sau:

Tài nguyên (RESOURCE)
Ví dụ: googleAdsFields/campaign.
Thuộc tính tài nguyên (ATTRIBUTE)
Ví dụ: googleAdsFields/campaign.name.
Trường phân đoạn (SEGMENT)
Ví dụ: googleAdsFields/segments.ad_network_type.
Chỉ số (METRIC)
Ví dụ: googleAdsFields/metrics.clicks.
Trước
Truy xuất đối tượng
Tiếp
Cấu trúc cuộc gọi