Mapeamentos JSON

Ao usar a interface REST da API Search Ads 360 Reporting, você trabalha com representações JSON dos mesmos recursos e tipos definidos nos arquivos de descritor .proto da API Search Ads 360 Reporting. O esquema de codificação JSON segue o esquema canônico descrito na seção Mapeamento JSON dos buffers de protocolo Guia de linguagem.

Em geral, todas as mensagens de nível superior para e de serviços são objetos JSON únicos. As respostas search são objetos JSON que contêm uma matriz results com o conjunto de resultados da consulta.

Os identificadores são transformados de snake_case (em buffers de protocolo) para lowerCamelCase em JSON. Uma ressalva importante para essa regra é ao usar search ou searchStream para enviar consultas da linguagem de consulta do Search Ads 360. A linguagem de consulta em si usa snake case, independentemente da interface que você está usando. No entanto, os resultados de uma consulta em REST são retornados como objetos JSON normais e têm identificadores em lowerCamelCase.

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 /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'"
}

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

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