Google Ads API memiliki pengambilan atribut dan pelaporan metrik terpadu mekanisme yang memungkinkan Anda membuat kueri menggunakan kueri Google Ads Bahasa. Cara ini memungkinkan kueri kompleks yang dapat mengembalikan data dalam jumlah besar tentang akun Google Ads 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 halaman berukuran tetap yang terdiri dari 10.000 baris, sehingga Anda dapat
untuk mengiterasi hasil yang ditetapkan menggunakan penomoran halaman. Ini bisa menguntungkan karena
bandwidth atau kondisi jaringan yang tidak dapat diandalkan, misalnya, untuk menyegmentasi segmen
ditetapkan menjadi respons yang lebih kecil yang dapat diambil ulang jika koneksi
turun. Di sisi lain, metode SearchStream men-streaming seluruh hasil
setel kembali dalam satu respons, yang dapat lebih efisien untuk data massal
atau pengambilan.
Search dan SearchStream menggunakan URL dasar yang sama:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/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
yang ditampilkan dalam respons:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Mengulang kueri yang sama dengan pageToken yang ditambahkan dengan nilai dari
permintaan sebelumnya akan mengambil halaman hasil berikutnya:
POST /v17/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 streaming
ubah metode layanan dalam URL menjadi searchStream
(pageSize dan pageToken tidak diperlukan oleh SearchStream):
POST /v17/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'"
}