Google Ads API memiliki mekanisme pelaporan metrik dan pengambilan atribut terpadu yang memungkinkan Anda membuat kueri menggunakan Bahasa Kueri Google Ads. Hal ini memungkinkan kueri kompleks yang dapat menampilkan data dalam jumlah besar tentang setiap akun Google Ads.
Anda dapat membuat kueri menggunakan metode Search atau SearchStream.
Kedua metode mendukung kueri yang sama dan menampilkan hasil yang setara. Metode
Search menampilkan data dalam halaman berukuran tetap 10.000 baris, sehingga Anda
dapat melakukan iterasi pada kumpulan hasil menggunakan penomoran halaman. Hal ini dapat menguntungkan dalam kondisi jaringan yang tidak andal atau bandwidth rendah, misalnya, untuk menyegmentasikan kumpulan hasil yang besar menjadi respons yang lebih kecil yang dapat diambil ulang jika koneksi terputus. Di sisi lain, metode SearchStream mengalirkan kembali seluruh set hasil dalam satu respons, yang bisa lebih efisien untuk pengambilan data massal.
Search dan SearchStream menggunakan URL dasar yang sama:
https://googleads.googleapis.com/v20/customers/CUSTOMER_ID/googleAds
POST /v20/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 /v20/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
yang di-streaming, ubah metode layanan di URL menjadi searchStream
(pageToken tidak diperlukan oleh SearchStream):
POST /v20/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'" }