Auf dieser Seite wird davon ausgegangen, dass Sie mit den Entwicklerhandbüchern Ressourcenorientiertes Design und Ressourcennamen vertraut sind. Sie werden um spezifische Implementierungsdetails der Google Ads API ergänzt.
Ressourcenorientiertes Design
Die Google Ads API folgt in der Regel einem ressourcenorientierten Design. Sie wird als Sammlung von einzeln adressierbaren Ressourcen (den Substantiven der API) modelliert. Ressourcen werden anhand ihrer Ressourcennamen referenziert und mit nur wenigen Methoden (auch als Verben oder Vorgänge bezeichnet) bearbeitet.
Diese Ressourcennamen und Methoden in Kombination mit einem bestimmten API-Versionspräfix bilden die URLs der REST-Schnittstelle. Die folgende URL kann beispielsweise gemäß der folgenden Tabelle in die einzelnen Komponenten unterteilt werden:
https://googleads.googleapis.com/v18/customers/1234567890:mutate
| Präfix der API-Version | Ressourcenname (relativ) | Methode |
|---|---|---|
https://googleads.googleapis.com/v18
|
customers/1234567890
|
mutate
|
Alle REST-URLs für eine bestimmte Version der API (z.B. v18)
ein gemeinsames API-Versionpräfix haben. Der Ressourcenname und die Methode geben zusammen an, welcher API-Dienst aufgerufen wird.
Die Google Ads API nutzt benutzerdefinierte Methoden, im Gegensatz zu den meisten traditionellen REST APIs, die Standard-REST-Methoden wie list, get, create, update und delete verwenden. Beispiele für benutzerdefinierte Methoden in der Google Ads API sind search, searchStream und mutate.
Auf den folgenden Seiten finden Sie weitere Informationen zu den Ressourcennamen, Dienstmethoden und JSON-Namenskonventionen der Google Ads API. Außerdem wird erläutert, wie diese zusammen verwendet werden, um REST-Interface-Endpunkte zu definieren.