Telusuri & SearchStream

Search Ads 360 Reporting API memiliki pengambilan atribut dan pelaporan metrik terpadu mekanisme yang memungkinkan Anda membuat kueri menggunakan kueri Search Ads 360 Bahasa. Cara ini memungkinkan kueri kompleks yang dapat mengembalikan data dalam jumlah besar tentang akun Search Ads 360 perorangan.

Anda dapat membuat kueri menggunakan salah satu dari metode Search atau SearchStream. Kedua metode mendukung kueri yang sama dan menampilkan hasil yang setara. Tujuan Metode Search menampilkan data dalam ukuran halaman yang dapat disesuaikan, sehingga Anda dapat melakukan iterasi pada hasil yang ditetapkan menggunakan penomoran halaman. Ini bisa menguntungkan pada {i>bandwidth<i} yang rendah atau kondisi jaringan yang tidak dapat diandalkan, misalnya, untuk menyegmentasi kumpulan hasil yang besar menjadi respons yang lebih kecil yang dapat diambil kembali jika koneksi terputus. Tujuan Di sisi lain, metode SearchStream mengalirkan seluruh hasil yang diatur kembali respons tunggal, 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 mengambil parameter pageSize opsional yang membatasi berapa banyak 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 adalah yang ditampilkan dalam respons:

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

Mengulang kueri yang sama dengan pageToken yang ditambahkan dengan nilai di atas pengambilan 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 streaming Anda, 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'"
}