Das Design der Google Ads API unterscheidet sich von einer herkömmlichen REST-Architektur, da hauptsächlich benutzerdefinierte Methoden wie search
und mutate,
anstelle der traditionelleren Methoden list
, get
, create
, update
und delete
verwendet werden.
Diese Aktionen werden in REST-URLs ausgedrückt. Hierzu werden die benutzerdefinierten Verbs und die HTTP-Zuordnung von :
verwendet, um das benutzerdefinierte Verb vom Rest der URL zu trennen.
Ein Mutations-API-Aufruf für eine Kampagne verwendet beispielsweise die folgende URL:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Die API verwendet benutzerdefinierte Methoden, um die Batchverarbeitung mehrerer Vorgänge in einer einzigen API-Anfrage zu ermöglichen. Bei Verwendung der strikten REST-Semantik kann immer nur eine Kampagne aktualisiert werden. Bei einem herkömmlichen REST-update
an eine Kampagne muss beispielsweise eine HTTP-PATCH-Anfrage pro Kampagnenressource gesendet werden.
Damit viele Vorgänge in einem einzigen Anfragetext zusammengefasst werden können, definiert die Google Ads API stattdessen eine benutzerdefinierte mutate
-Methode für die meisten Ressourcen.
Zum Aktivieren von Batchlesevorgängen (Abrufen vieler Objekte gleichzeitig) aus der API verwendet die API eine benutzerdefinierte search
-Methode mit einer SQL-ähnlichen Google Ads-Abfragesprache.
Auf der Seite Gängige Methoden werden die am häufigsten verwendeten Methoden in der Google Ads API ausführlich beschrieben.