Pemetaan JSON

Saat menggunakan antarmuka REST Search Ads 360 Reporting API, Anda menangani representasi JSON dari resource dan jenis yang sama yang ditentukan dalam file deskripsi.proto Search Ads 360 Reporting API. Skema encoding JSON mengikuti skema encoding kanonis yang dijelaskan di bagian Pemetaan JSON dari Panduan Bahasa buffering 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 diubah dari snake_case (dalam buffer protokol) menjadi lowerCamelCase di JSON. Salah satu peringatan penting pada aturan ini adalah saat menggunakan search atau searchStream untuk mengirim kueri Bahasa Kueri Search Ads 360. Bahasa kueri itu sendiri menggunakan snake case, apa pun antarmuka yang Anda gunakan. Namun, hasil kueri di REST ditampilkan sebagai objek JSON normal dan memiliki ID-nya dalam underCamelCase.

Misalnya, kueri untuk mengambil daftar kata kunci aktif dalam akun menggunakan snake case 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 (digabungkan dalam array JSON karena permintaan ini menggunakan searchStream) dan menggunakan ID camelCase adGroupCriterion:

[
  {
    "results": [
      {
        "adGroupCriterion": {
          "resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
          "keyword": {
            "text": "pay per click"
          }
        }
      },
      ...
    ]
  }
]