Das Design der Google Ads API unterscheidet sich von einer herkömmlichen REST-Architektur.
da stattdessen hauptsächlich benutzerdefinierte Methoden wie search
und mutate,
verwendet werden.
der traditionelleren Methoden list
, get
, create
, update
und delete
.
Diese Aktionen werden mithilfe der HTTP-Zuordnung in REST-URLs ausgedrückt.
:
-Konvention, um das benutzerdefinierte Verb vom Rest der URL zu trennen.
In einem mutate-API-Aufruf einer Kampagne wird beispielsweise die folgende URL verwendet:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Die API verwendet benutzerdefinierte Methoden,
um die Batchverarbeitung mehrerer
in einer API-Anfrage zusammenfassen. Die strikte REST-Semantik würde nur
nicht auf einmal aktualisieren. Traditionelle REST
update
in ein
wäre zum Beispiel das Senden einer HTTP-PATCH-Anforderung pro Kampagne erforderlich.
.
Damit viele Vorgänge in einem einzigen Anfragetext gebündelt werden können,
Für die meisten Ressourcen definiert die Google Ads API stattdessen eine benutzerdefinierte mutate
-Methode.
Um Batch-Lesevorgänge (das gleichzeitige Abrufen vieler Objekte aus der API) zu ermöglichen,
Die API verwendet eine benutzerdefinierte search
-Methode mit einer SQL-ähnlichen Google Ads-Abfrage.
Sprache:
Auf der Seite Gängige Methoden werden die am häufigsten verwendeten Methoden in der Google Ads API.