Wenn Sie die REST-Oberfläche der Search Ads 360 Reporting API verwenden, arbeiten Sie mit JSON-Darstellungen derselben Ressourcen und Typen, die in den .proto-deskriptor-Dateien der Search Ads 360 Reporting API definiert sind. Das JSON-Codierungsschema folgt dem kanonischen Codierungsschema, das im Sprachleitfaden für Protokollpuffer im Abschnitt JSON-Zuordnung beschrieben wird.
Allgemein 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 in JSON von snake_case (in Protokollpuffern) in lowerCamelCase transformiert. Ein wichtiger Nachteil dieser Regel ist, wenn Search Ads 360 Query Language-Abfragen über search oder searchStream gesendet werden. 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 ihre IDs werden in CamelCase-Schreibweise (kleingeschrieben) angezeigt.
Beispiel: Eine Abfrage zum Abrufen einer Liste aktiver Keywords in einem Konto verwendet Snake Case in der Abfrage selbst (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 (umschlossen in ein JSON-Array, da diese Anfrage searchStream verwendet) und verwendet stattdessen die CamelCase-ID adGroupCriterion:
[
{
"results": [
{
"adGroupCriterion": {
"resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
"keyword": {
"text": "pay per click"
}
}
},
...
]
}
]