Search Ads 360 Reporting API memiliki mekanisme pengambilan atribut dan pelaporan metrik terpadu yang memungkinkan Anda membuat kueri menggunakan Bahasa Kueri Search Ads 360. Hal ini memungkinkan kueri kompleks yang dapat menampilkan data dalam jumlah besar tentang setiap akun Search Ads 360.
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 ukuran halaman yang dapat disesuaikan, sehingga Anda dapat melakukan iterasi
pada set 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. Sebaliknya, metode SearchStream mengalirkan seluruh kumpulan hasil kembali dalam satu respons, yang bisa lebih efisien untuk pengambilan data massal.
Search dan SearchStream menggunakan URL dasar yang sama:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
Metode penelusuran berbasis halaman menggunakan parameter pageSize opsional yang membatasi jumlah hasil yang ditampilkan dalam satu respons API.
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "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 banyak baris dalam hasil daripada pageSize, 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 di atas akan mengambil
halaman hasil berikutnya:
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "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, cukup ubah metode layanan di URL menjadi searchStream
(pageSize dan pageToken tidak diperlukan oleh SearchStream):
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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'" }