Bahasa Kueri Google Ads dapat mengkueri Google Ads API untuk
- Resource dan atribut, segmen, dan metrik yang terkait menggunakan
GoogleAdsService
Penelusuran atau SearchStream- Hasil dari kueri GoogleAdsService adalah daftar
instance
GoogleAdsRow
, dengan setiapGoogleAdsRow
mewakili resource. Jika ada atribut atau metrik yang diminta, baris juga akan menyertakan kolom tersebut. Jika ada segmen yang diminta, respons juga akan menampilkan baris tambahan untuk setiap tuple resource segmen. - Metadata tentang kolom dan resource yang tersedia di
GoogleAdsFieldService
Layanan ini menyediakan katalog kolom yang dapat dikueri dengan spesifikasi kompatibilitas dan jenisnya.
Hasil dari kueri
GoogleAdsFieldService
adalah daftar instanceGoogleAdsField
, dengan setiapGoogleAdsField
berisi detail tentang kolom yang diminta.
Membuat kueri atribut resource
Berikut adalah kueri dasar untuk atribut resource kampanye, yang menggambarkan cara menampilkan ID, nama, dan status kampanye:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
Kueri ini mengurutkan berdasarkan ID kampanye. Setiap GoogleAdsRow
yang dihasilkan akan mewakili
objek campaign
yang diisi dengan kolom yang dipilih (termasuk resource_name
kampanye tertentu).
Untuk mengetahui kolom lain yang tersedia untuk kueri kampanye, lihat dokumentasi referensi Campaign
.
Membuat kueri untuk metrik
Di samping atribut yang dipilih untuk resource tertentu, Anda juga dapat membuat kueri untuk metrik terkait:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
Kueri ini memfilter hanya untuk kampanye yang memiliki status PAUSED
dan telah memiliki lebih dari 1.000 tayangan iklan, sambil mengurutkan berdasarkan ID kampanye. Setiap
GoogleAdsRow
yang dihasilkan akan memiliki kolom metrics
yang diisi dengan
metrik yang dipilih.
Untuk daftar metrik yang dapat dikueri, lihat dokumentasi
Metrics
.
Membuat kueri untuk segmen
Di samping atribut yang dipilih untuk resource tertentu, Anda juga dapat membuat kueri untuk segmen terkait:
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
Serupa dengan kueri untuk metrik, kueri ini hanya memfilter kampanye yang
memiliki status PAUSED
dan telah memiliki lebih dari 1.000 tayangan. Namun,
kueri ini mengelompokkan data menurut tanggal. Ini mengarah ke setiap GoogleAdsRow
yang dihasilkan yang mewakili tuple kampanye dan tanggal Segment
. Perlu diperhatikan bahwa segmentasi akan memisahkan metrik yang dipilih, yang dikelompokkan menurut setiap segmen di klausa SELECT.
Untuk daftar segmen yang dapat dikueri, lihat dokumentasi
Segments
.
Membuat kueri atribut resource terkait
Dalam kueri untuk resource tertentu, Anda mungkin dapat bergabung dengan resource terkait lainnya jika tersedia. Resource terkait ini dikenal sebagai "resource beratribusi". Anda dapat bergabung dengan resource yang diatribusikan secara implisit dengan memilih atribut dalam kueri Anda.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
Kueri ini tidak hanya memilih atribut kampanye, tetapi juga mengambil atribut terkait dari setiap kampanye yang dipilih. Setiap GoogleAdsRow
yang dihasilkan mewakili
objek campaign
yang diisi dengan atribut kampanye yang dipilih serta
atribut strategi bidding yang dipilih bidding_strategy.name
.
Untuk mengetahui resource atribusi mana yang tersedia untuk kueri kampanye,
lihat dokumentasi referensi Campaign
.
Mutasi berdasarkan hasil kueri
Saat membuat kueri untuk resource tertentu, Anda dapat segera mengambil hasil yang ditampilkan tersebut sebagai objek, memodifikasinya, dan mengirimkannya kembali ke metode mutate dalam layanan resource tersebut. Berikut adalah contoh alur kerja:
- Jalankan kueri untuk semua kampanye yang saat ini bernilai
PAUSED
dan memiliki tayangan lebih besar dari 1.000. - Dapatkan objek
Campaign
dari kolomcampaign
di setiapGoogleAdsRow
dalam respons. - Ubah status setiap kampanye dari
PAUSED
menjadiENABLED
. - Panggil
CampaignService.MutateCampaigns
dengan kampanye yang diubah untuk memperbaruinya.
Metadata kolom
Kueri yang dikirim ke GoogleAdsFieldService
dimaksudkan untuk mengambil metadata kolom.
Informasi ini dapat digunakan untuk memahami cara penggunaan kolom bersama dalam sebuah kueri. Karena data tersedia dari API dan menyediakan metadata yang diperlukan untuk memvalidasi atau membangun kueri, hal ini memungkinkan developer melakukannya secara terprogram. Berikut ini adalah kueri umum untuk {i>metadata<i}:
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
Anda dapat mengganti <INSERT_RESOURCE_OR_FIELD>
dalam kueri ini dengan
resource (seperti customer
atau campaign
) atau kolom (seperti campaign.id
,
metrics.impressions
, atau ad_group.id
).
Untuk daftar kolom yang dapat dikueri, lihat dokumentasi
GoogleAdsField
.
Contoh kode
Library klien memiliki contoh penggunaan
Bahasa Kueri Google Ads di GoogleAdsService
. Folder operasi dasar memiliki contoh seperti GetCampaigns
, GetKeywords
, dan SearchForGoogleAdsFields
.
Folder pelaporan memiliki contoh GetKeywordStats
.