Trang này được dịch bởi Cloud Translation API.

Ngôn ngữ truy vấn Google Ads

Ngôn ngữ truy vấn Google Ads có thể truy vấn API Google Ads cho

Các tài nguyên và thuộc tính có liên quan, phân đoạn cũng như chỉ số của chúng sử dụng

GoogleAdsService Tìm kiếm hoặc SearchStream

Kết quả từ truy vấn GoogleAdsService là danh sách GoogleAdsRow thực thể, với mỗi GoogleAdsRow biểu thị một tài nguyên. Nếu có bất kỳ thuộc tính hoặc chỉ số nào được yêu cầu, thì cũng bao gồm các trường đó. Nếu có bất kỳ phân khúc nào được yêu cầu, thì hàm phản hồi cũng hiển thị một hàng bổ sung cho mỗi bộ dữ liệu tài nguyên phân đoạn.

Siêu dữ liệu về các trường và tài nguyên có sẵn trong

GoogleAdsFieldService

Dịch vụ này cung cấp một danh mục các trường có thể truy vấn kèm theo thông tin cụ thể về khả năng tương thích và loại của chúng.

Kết quả từ truy vấn GoogleAdsFieldService là danh sách GoogleAdsField thực thể, trong đó mỗi thực thể GoogleAdsField chứa thông tin chi tiết về trường được yêu cầu.

Truy vấn các thuộc tính của một tài nguyên

Dưới đây là truy vấn cơ bản về các thuộc tính của tài nguyên chiến dịch, minh hoạ cách thức để trả về mã, tên và trạng thái chiến dịch:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

Truy vấn này sắp xếp theo mã chiến dịch. Mỗi GoogleAdsRow thu được sẽ đại diện cho một đối tượng campaign được điền sẵn các trường đã chọn (bao gồm cả những trường đã cho) resource_name của chiến dịch).

Để tìm hiểu xem những trường nào khác có sẵn cho các truy vấn chiến dịch, hãy tham khảo Tài liệu tham khảo về Campaign.

Truy vấn chỉ số

Bên cạnh các thuộc tính đã chọn cho một tài nguyên nhất định, bạn cũng có thể truy vấn chỉ số có liên quan:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

Truy vấn này chỉ lọc những chiến dịch có trạng thái là PAUSED và có hơn 1.000 lượt hiển thị trong khi sắp xếp theo mã chiến dịch. Một kết quả là GoogleAdsRow sẽ có trường metrics được điền sẵn chỉ số đã chọn.

Để biết danh sách các chỉ số có thể truy vấn, hãy tham khảo Metrics tài liệu.

Truy vấn phân khúc

Bên cạnh các thuộc tính đã chọn cho một tài nguyên nhất định, bạn cũng có thể truy vấn phân khúc có liên quan:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

Tương tự như truy vấn chỉ số, truy vấn này chỉ lọc những chiến dịch có trạng thái PAUSED và đã có hơn 1.000 lượt hiển thị; tuy nhiên, truy vấn này sẽ phân đoạn dữ liệu theo ngày. Điều này dẫn đến mỗi kết quả GoogleAdsRow đại diện cho một bộ dữ liệu của một chiến dịch và ngày Segment. Bây giờ xin lưu ý rằng phân đoạn sẽ tách các chỉ số được chọn, nhóm theo từng chỉ số trong mệnh đề SELECT.

Để xem danh sách các phân khúc có thể truy vấn, hãy tham khảo Segments tài liệu.

Truy vấn thuộc tính của tài nguyên có liên quan

Trong truy vấn cho một tài nguyên nhất định, bạn có thể kết hợp với tài nguyên khác nếu có. Những tài nguyên liên quan này được gọi là "được phân bổ nguồn lực". Bạn có thể ngầm kết hợp dựa trên các tài nguyên được phân bổ bằng cách chọn một trong truy vấn của mình.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

Truy vấn này không chỉ chọn các thuộc tính chiến dịch mà còn lấy các thuộc tính có liên quan từ mỗi chiến dịch đã chọn. Mỗi GoogleAdsRow thu được đại diện cho một đối tượng campaign được điền bằng các thuộc tính chiến dịch đã chọn cũng như thuộc tính chiến lược đặt giá thầu đã chọn bidding_strategy.name.

Để tìm hiểu xem những tài nguyên được phân bổ nào có sẵn cho các truy vấn chiến dịch, hãy tham khảo tài liệu tham khảo về Campaign.

Thay đổi dựa trên kết quả truy vấn

Khi truy vấn một tài nguyên cụ thể, bạn có thể lấy ngay những tài nguyên đó được trả về kết quả dưới dạng đối tượng, sửa đổi và gửi chúng trở lại phương thức thay đổi trong đó dịch vụ của tài nguyên. Dưới đây là quy trình làm việc mẫu:

Thực thi truy vấn cho tất cả chiến dịch hiện đang PAUSED và có lớn hơn 1.000.
Lấy đối tượng Campaign qua trường campaign của mỗi GoogleAdsRow trong nội dung phản hồi.
Thay đổi trạng thái của từng chiến dịch từ PAUSED thành ENABLED.
Gọi CampaignService.MutateCampaigns với các chiến dịch được sửa đổi để cập nhật chúng.

Siêu dữ liệu về trường

Các truy vấn được gửi đến GoogleAdsFieldService là để truy xuất siêu dữ liệu của trường. Bạn có thể dùng thông tin này để nắm được cách sử dụng các trường cùng nhau trong truy vấn. Bởi vì dữ liệu có sẵn từ API và API này cung cấp siêu dữ liệu cần thiết để xác thực hoặc tạo truy vấn. Điều này cho phép nhà phát triển có thể một cách có lập trình. Sau đây là một truy vấn thông thường cho siêu dữ liệu:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Bạn có thể thay thế <INSERT_RESOURCE_OR_FIELD> trong truy vấn này bằng tài nguyên (ví dụ: customer hoặc campaign) hoặc trường (chẳng hạn như campaign.id, metrics.impressions hoặc ad_group.id).

Để biết danh sách các trường có thể truy vấn, hãy tham khảo GoogleAdsField tài liệu.

Ví dụ về mã

Thư viện ứng dụng có các ví dụ về việc sử dụng Ngôn ngữ truy vấn của Google Ads bằng GoogleAdsService. Thư mục hoạt động cơ bản có ví dụ như GetCampaigns, GetKeywords và SearchForGoogleAdsFields. Thư mục reporting có ví dụ GetKeywordStats.

Tiếp

Ngữ pháp truy vấn