JSON-Zuordnungen

Wenn Sie die REST-Schnittstelle der Search Ads 360 Reporting API verwenden, arbeiten Sie mit JSON-Darstellungen derselben Ressourcen und Typen, die in den .proto-Beschreibungsdateien der Search Ads 360 Reporting API definiert sind. Das JSON-Codierungsschema folgt dem kanonischen Codierungsschema, das im Abschnitt JSON-Zuordnung des Sprachleitfadens für Protokoll-Buffers beschrieben ist.

Im Allgemeinen sind alle Nachrichten der obersten Ebene an und von Diensten einzelne JSON-Objekte. search-Antworten sind JSON-Objekte, die ein results-Array mit dem Ergebnissatz Ihrer Abfrage enthalten.

Kennungen werden im JSON-Format von snake_case (in Protokollzwischenspeichern) in lowerCamelCase (in JSON) umgewandelt. Eine wichtige Ausnahme von dieser Regel ist die Verwendung von search oder searchStream zum Senden von Abfragen in der Search Ads 360-Abfragesprache. Bei der Abfragesprache selbst wird Snake Case verwendet, unabhängig davon, welche Schnittstelle Sie verwenden. Die Ergebnisse einer Abfrage in REST werden jedoch als normale JSON-Objekte zurückgegeben und ihre IDs sind in Kleinbuchstaben mit CamelCase geschrieben.

In einer Abfrage zum Abrufen einer Liste der aktiven Keywords in einem Konto wird beispielsweise die Schreibweise im Schlangenpfad in der Abfrage selbst verwendet (ad_group_criterion, nicht 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'"
}

Die Antwort ist jedoch eine JSON-Darstellung der Objekte, die in ein JSON-Array eingeschlossen sind, da diese Anfrage searchStream verwendet, und stattdessen die CamelCase-Kennung adGroupCriterion verwendet:

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