JSON-Zuordnungen

Wenn Sie die REST-Schnittstelle der Google Ads API verwenden, arbeiten Sie mit JSON Darstellungen derselben Ressourcen und Typen, die in den .proto-DeskriptorDateien der Google Ads API definiert sind. Das JSON-Codierungsschema folgt dem kanonischen Codierungsschema, das im Abschnitt JSON-Zuordnung des Protocol Buffers Sprachleitfadens beschrieben ist.

Im Allgemeinen sind alle Nachrichten der obersten Ebene an und von Diensten einzelne JSON-Objekte. Die meisten Mutationsanfragen enthalten ein operations-Array, das viele create-, update- oder delete-Vorgänge enthält. Ebenso sind search-Antworten JSON-Objekte, die ein results-Array mit dem Ergebnissatz Ihrer Abfrage enthalten.

IDs werden von snake_case (in Protokollzwischenspeichern) in lowerCamelCase in JSON umgewandelt. Eine bemerkenswerte Ausnahme von dieser Regel ist die Verwendung von search oder searchStream zum Senden von Abfragen in der Google Ads Query Language. Die Abfragesprache selbst verwendet Snake Case, unabhängig davon, welche Schnittstelle Sie verwenden. Die Ergebnisse einer Abfrage in REST werden jedoch als normale JSON-Objekte zurückgegeben und haben ihre IDs in Lower Camel Case.

Bei einer Abfrage zum Abrufen einer Liste aktiver Keywords in einem Konto wird beispielsweise Snake Case in der Abfrage selbst verwendet (ad_group_criterion, nicht adGroupCriterion):

POST /v26/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.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'"
}

Die Antwort ist jedoch eine JSON-Darstellung der Objekte (in ein JSON-Array eingeschlossen, da diese Anfrage searchStream verwendet) und verwendet stattdessen die Camel Case-ID adGroupCriterion:

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