Mapeamentos JSON

Ao usar a interface REST da API Google Ads, você trabalha com dados representações dos mesmos recursos e tipos definidos no .proto Descriptor. O esquema de codificação JSON segue de codificação canônica descrito na Seção Mapeamento JSON do protocolo armazena o Guia da linguagem.

Em geral, todas as mensagens de nível superior de e para services são objetos JSON únicos. A maioria das solicitações de mutação contém uma matriz operations que, por si só, contém muitos create, update ou delete. Da mesma forma, as respostas search são Objetos JSON contendo uma matriz results com o conjunto de resultados da consulta.

Os identificadores são transformados de snake_case (em buffers de protocolo) para lowerCamelCase no JSON. Uma ressalva a essa regra é que, search ou searchStream para enviar a linguagem de consulta do Google Ads consultas. A própria linguagem de consulta usa snake-case, independentemente de qual que você está usando. No entanto, os resultados de uma consulta em REST são retornados como objetos JSON normais e têm seus identificadores em bottomCamelCase.

Por exemplo, uma consulta para buscar uma lista de palavras-chave ativas em uma conta usa snake case dentro da própria consulta (ad_group_criterion, não 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'"
}

No entanto, a resposta é uma representação JSON dos objetos (encapsuladas em um matriz, já que essa solicitação usa searchStream) e usa o identificador camelCase Em vez disso, adGroupCriterion:

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