Asignaciones JSON

Cuando usas la interfaz REST de la API de Google Ads, trabajas con representaciones JSON de los mismos recursos y tipos definidos en los archivos descriptor.proto de la API de Google Ads. El esquema de codificación JSON sigue el esquema de codificación canónico que se describe en la sección JSON Mapping de la guía de lenguaje de los búferes de protocolo.

En general, todos los mensajes de nivel superior hacia y desde los servicios son objetos JSON únicos. La mayoría de las solicitudes de mutación contienen un array operations que, a su vez, contiene muchas operaciones create, update o delete. Del mismo modo, las respuestas de search son objetos JSON que contienen un array results con el conjunto de resultados de tu consulta.

Los identificadores se transforman de snake_case (en búferes de protocolo) a lowerCamelCase en JSON. Una salvedad importante de esta regla es cuando se usa search o searchStream para enviar consultas del Lenguaje de consulta de Google Ads. El lenguaje de consulta en sí usa el formato de mayúsculas y minúsculas, independientemente de la interfaz que uses. Sin embargo, los resultados de una consulta en REST se muestran como objetos JSON normales y tienen sus identificadores en mayúsculas y minúsculas.

Por ejemplo, una consulta para recuperar una lista de palabras clave activas en una cuenta usa la escritura en mayúsculas y minúsculas dentro de la consulta (ad_group_criterion, no adGroupCriterion):

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

Sin embargo, la respuesta es una representación JSON de los objetos (unidos en un array JSON, ya que esta solicitud usa searchStream) y usa el identificador adGroupCriterion en mayúsculas y minúsculas:

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