Asignaciones JSON

Cuando utiliza la interfaz de REST de la API de Google Ads, está trabajando con JSON de los mismos recursos y tipos definidos en las APIs de Google Ads Archivos descriptores.proto. El esquema de codificación JSON sigue de codificación canónico descrito en el Sección Asignación JSON del protocolo búferes de Language Guide.

En general, los mensajes de nivel superior servicios son objetos JSON individuales. La mayoría de las solicitudes de mutación contienen un array operations que, a su vez, incluye muchos Operaciones create, update o delete. De manera similar, las respuestas 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 para esta regla es que cuando se usan search o searchStream para enviar el lenguaje de consulta de Google Ads para tus consultas. El lenguaje de consulta en sí usa Snake case, independientemente de cuál. interfaz de usuario que estás usando. Sin embargo, los resultados de una consulta en REST se devuelven como Objetos JSON normales y tienen sus identificadores en lowerCamelCase.

Por ejemplo, una consulta para recuperar una lista de palabras clave activas en una cuenta usa Snake case dentro de la consulta en sí (ad_group_criterion, no 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'"
}

Sin embargo, la respuesta es una representación JSON de los objetos (unidas en un archivo array, ya que esta solicitud usa searchStream) y usa el identificador camelCase adGroupCriterion en su lugar:

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