Auf dieser Seite wird davon ausgegangen, dass Sie mit dem Ressourcenorientierten Design und Ressource Namen in den Entwicklerleitfäden und ergänzt sie durch spezifische Details zur Implementierung der Google Ads API.
Ressourcenorientiertes Design
Im Allgemeinen ist das Google Ads API ressourcenorientierter gestaltet. Sammlungen individueller Ressourcen (die Substantive der API). Ressourcen werden mit ihren Ressourcennamen referenziert und mit einem kleinen Methoden (auch als Verben oder Vorgänge bezeichnet).
Diese kombinierten Ressourcennamen und Methoden mit einem bestimmten API-Versionspräfix, enthalten die URLs der REST-Schnittstelle. Beispielsweise kann die URL unten in diese einzelnen Komponenten aufgeschlüsselt werden. gemäß der folgenden Tabelle:
https://googleads.googleapis.com/v17/customers/1234567890:mutate
| API-Versionspräfix | Ressourcenname (relativ) | Methode |
|---|---|---|
https://googleads.googleapis.com/v17
|
customers/1234567890
|
mutate
|
Alle REST-URLs für eine bestimmte API-Version (z.B. v17)
gemeinsames API-Versionspräfix haben. Ressourcenname und -methode zusammen
identifiziert, welcher API-Dienst aufgerufen wird.
Bei der Google Ads API werden in großem Umfang benutzerdefinierte Methoden eingesetzt.
die Standard-REST-Methoden wie list, get,
create, update und delete. Beispiele für benutzerdefinierte Methoden in der Google Ads API
umfassen search, searchStream und mutate.
Auf den folgenden Seiten erhalten Sie ausführlichere Informationen zur Ressource von Google Ads API Namen, Dienstmethoden und JSON-Namenskonventionen, die ihre Verwendung veranschaulichen um REST-Schnittstellenendpunkte zu definieren.