Search Ads 360 Reporting API memiliki pengambilan atribut dan mekanisme 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 salah satu metode Search
atau SearchStream
.
Kedua metode ini mendukung kueri yang sama dan menampilkan hasil yang setara. Metode
Search
menampilkan data dalam ukuran halaman yang dapat disesuaikan, yang memungkinkan Anda melakukan iterasi
pada kumpulan hasil menggunakan penomoran halaman. Hal ini dapat berguna dalam kondisi bandwidth rendah atau jaringan yang tidak dapat diandalkan, misalnya, untuk menyegmentasikan hasil besar yang ditetapkan menjadi respons yang lebih kecil yang dapat diambil ulang jika koneksi terputus. Di sisi lain,
metode SearchStream
mengalirkan kembali seluruh hasil yang ditetapkan dalam
satu respons, yang dapat lebih efisien untuk pengambilan data secara 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 respons yang di-streaming tunggal, 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'" }