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ả của truy vấn GoogleAdsService là danh sách các thực thể
GoogleAdsRow
, trong đó mỗiGoogleAdsRow
đại diện cho một tài nguyên. Nếu có thuộc tính hoặc chỉ số nào được yêu cầu, thì hàng này cũng sẽ bao gồm những trường đó. Nếu có bất kỳ phân đoạn nào được yêu cầu, thì 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 các trường đó.
Kết quả của truy vấn
GoogleAdsFieldService
là danh sách các thực thểGoogleAdsField
, trong đó mỗiGoogleAdsField
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 cho các thuộc tính của tài nguyên chiến dịch, minh hoạ cách 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ả resource_name
của chiến dịch đã cho).
Để tìm hiểu những trường nào khác có thể dùng cho các truy vấn liên quan đế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 các chỉ số 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 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ỗi GoogleAdsRow
thu được sẽ có một trường metrics
được điền sẵn các chỉ số đã chọn.
Để biết danh sách các chỉ số có thể truy vấn, hãy tham khảo tài liệu về Metrics
.
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 các phân đoạn 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 phân đoạn dữ liệu theo ngày. Điều này dẫn đến mỗi GoogleAdsRow
thu được đại diện cho một bộ dữ liệu của một chiến dịch và ngày Segment
. Điều quan trọng bạn cần lưu ý là việc phân đoạn sẽ chia các chỉ số đã chọn, nhóm theo từng phân đoạn trong mệnh đề SELECT.
Để biết danh sách các phân đoạn có thể truy vấn, hãy tham khảo tài liệu về Segments
.
Truy vấn thuộc tính của tài nguyên có liên quan
Trong truy vấn của một tài nguyên nhất định, bạn có thể kết hợp với các tài nguyên liên quan khác (nếu có). Những tài nguyên liên quan này được gọi là "tài nguyên được phân bổ". Bạn có thể ngầm kết hợp dựa trên tài nguyên được phân bổ bằng cách chọn một thuộc tính 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 và thuộc tính chiến lược đặt giá thầu đã chọn bidding_strategy.name
.
Để tìm hiểu 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 nhất định, bạn có thể lấy ngay các kết quả được trả về đó dưới dạng đối tượng, sửa đổi và gửi lại các kết quả đó cho 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ó hơn 1.000 lượt hiển thị. - Lấy đối tượng
Campaign
qua trườngcampaign
của mỗiGoogleAdsRow
trong phản hồi. - Thay đổi trạng thái của từng chiến dịch từ
PAUSED
thànhENABLED
. - Gọi
CampaignService.MutateCampaigns
với các chiến dịch đã sửa đổi để cập nhật các chiến dịch đó.
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 để hiểu cách sử dụng các trường cùng nhau trong một truy vấn. Vì dữ liệu có sẵn từ API và cung cấp siêu dữ liệu cần thiết để xác thực hoặc tạo truy vấn, nên điều này cho phép nhà phát triển thực hiện việc này theo phương thức lập trình. Dưới đâ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 một tài nguyên (chẳng hạn như 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 tài liệu về GoogleAdsField
.
Ví dụ về mã
Thư viện khách hàng có các ví dụ về cách sử dụng
Ngôn ngữ truy vấn Google Ads trong GoogleAdsService
. Thư mục thao tác cơ bản có các ví dụ như GetCampaigns
, GetKeywords
và SearchForGoogleAdsFields
.
Thư mục reporting có ví dụ GetKeywordStats
.