Saat menggunakan antarmuka REST Search Ads 360 Reporting API, Anda menangani representasi JSON dari resource dan jenis yang sama dengan yang ditentukan dalam file deskripsi.proto di Search Ads 360 Reporting API. Skema encoding JSON mengikuti skema encoding kanonis yang dijelaskan di bagian Pemetaan JSON di Panduan Bahasa buffer protokol.
Secara umum, semua pesan tingkat atas ke dan dari
layanan adalah objek JSON tunggal. Respons search
adalah objek JSON yang berisi array results
dengan kumpulan hasil kueri Anda.
ID ditransformasi dari snake_case (dalam buffering protokol) menjadi
lowerCamelCase di JSON. Satu peringatan penting untuk aturan ini adalah saat menggunakan search
atau searchStream
untuk mengirim kueri Bahasa Kueri Search Ads 360. Bahasa kueri itu sendiri menggunakan {i>snake case<i}, terlepas dari
antarmuka yang sedang Anda gunakan. Namun, hasil kueri di REST ditampilkan sebagai objek JSON normal dan memiliki ID-nya di lowerCamelCase.
Misalnya, kueri untuk mengambil daftar kata kunci aktif dalam akun menggunakan
{i>snake case<i} di dalam kueri itu sendiri (ad_group_criterion
, bukan adGroupCriterion
):
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 FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
Namun, responsnya adalah representasi JSON dari objek tersebut (yang digabungkan dalam array JSON karena permintaan ini menggunakan searchStream
) dan menggunakan ID camelCase sebagai gantinya:adGroupCriterion
[ { "results": [ { "adGroupCriterion": { "resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060", "keyword": { "text": "pay per click" } } }, ... ] } ]