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ó 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ể dùng để xác thực và tạo câu lệnh Ngôn ngữ truy vấn 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/v25/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/v25/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 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 (các trường segments.* và tài nguyên phân đoạn) có thể được chọn bằng tài nguyên trong mệnh đề FROM. Các chỉ số này phân đoạn 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 của Google Ads. 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 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 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 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 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ể (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 ví dụ 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ì bạn đã chọn campaign.name nhưng campaign không có trong mệnh đề FROM , nên bạn phải xác minh khả năng tương thích của 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 sẽ 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 cách sử dụng GoogleAdsFieldService (bằng tên tài nguyên với GetGoogleAdsField hoặc bằng cách truy vấn với 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.