Google Ads API memiliki mekanisme pengambilan atribut dan pelaporan metrik terpadu yang memungkinkan Anda membuat kueri menggunakan Bahasa Kueri Google Ads. Hal ini memungkinkan kueri kompleks yang dapat menampilkan data dalam jumlah besar tentang akun Google Ads individual.
Anda dapat membuat kueri menggunakan salah satu metode Search atau SearchStream.
Kedua metode tersebut mendukung kueri yang sama dan menampilkan hasil yang setara. Metode
Search menampilkan data dalam halaman berukuran tetap sebanyak 10.000 baris, sehingga Anda
dapat melakukan iterasi pada set hasil menggunakan penomoran halaman. Hal ini dapat menguntungkan dalam kondisi jaringan yang tidak dapat diandalkan atau dengan bandwidth rendah, misalnya, untuk menyegmentasikan set hasil yang besar menjadi respons yang lebih kecil yang dapat diambil kembali jika koneksi hilang. Di sisi lain, metode SearchStream akan melakukan streaming seluruh kumpulan hasil kembali dalam satu respons, yang dapat lebih efisien untuk pengambilan data massal.
Search dan SearchStream menggunakan URL dasar yang sama:
https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds
POST /v18/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}
Jika ada lebih dari 10.000 baris dalam hasil,nextPageToken akan ditampilkan dalam respons:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Mengulangi kueri yang sama dengan pageToken yang ditambahkan dengan nilai dari
permintaan sebelumnya akan mengambil halaman hasil berikutnya:
POST /v18/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}
Untuk menggunakan metode SearchStream, yang menampilkan semua hasil dalam satu respons streaming, ubah metode layanan di URL menjadi searchStream
(pageToken tidak diperlukan oleh SearchStream):
POST /v18/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}