Pemetaan JSON

Saat menggunakan antarmuka REST Google Ads API, Anda menggunakan JSON dari resource dan jenis yang sama seperti yang ditentukan dalam atribut deskriptor.proto. Skema encoding JSON mengikuti skema encoding kanonis yang dijelaskan dalam Bagian Pemetaan JSON pada protokol menyangga Panduan Bahasa.

Secara umum, semua pesan tingkat atas ke dan dari layanan adalah objek JSON tunggal. Sebagian besar permintaan mutasi berisi array operations yang berisi banyak Operasi create, update, atau delete. Demikian pula, respons search Objek JSON yang berisi array results dengan set hasil kueri Anda.

Identifier diubah dari snake_case (dalam buffering protokol) menjadi lowerCamelCase di JSON. Satu peringatan penting untuk aturan ini adalah ketika menggunakan search atau searchStream untuk mengirim Bahasa Kueri Google Ads terhadap kueri. Bahasa kueri itu sendiri menggunakan {i>snake case<i}, antarmuka yang Anda gunakan. Namun, hasil kueri di REST ditampilkan sebagai objek JSON normal dan memiliki pengenal-nya di lowerCamelCase.

Misalnya, kueri untuk mengambil daftar kata kunci aktif di akun menggunakan {i>snake case<i} di dalam kueri itu sendiri (ad_group_criterion, bukan adGroupCriterion):

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
            FROM ad_group_criterion
            WHERE ad_group_criterion.type = 'KEYWORD'
            AND ad_group_criterion.status = 'ENABLED'"
}

Namun, responsnya adalah representasi JSON dari objek (yang digabungkan dalam 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"
          }
        }
      },
      ...
    ]
  }
]