Das Design der Google Ads API unterscheidet sich von einer traditionellen 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 gemäß der HTTP-Zuordnung mit einem :
ausgedrückt, um das benutzerdefinierte Verb vom Rest der URL zu trennen.
Für einen API-Aufruf zum Ändern einer Kampagne wird beispielsweise die folgende URL verwendet:
https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate
Ein Grund für die Verwendung benutzerdefinierter Methoden in der API ist die Möglichkeit, mehrere Vorgänge in einer einzigen API-Anfrage zu verarbeiten. Bei strikter REST-Semantik kann jeweils nur eine Kampagne aktualisiert werden. Bei einer herkömmlichen REST-update
-Anfrage an eine Kampagne müsste 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 für die meisten Ressourcen stattdessen eine benutzerdefinierte mutate
-Methode.
Um Batch-Lesungen (das Abrufen vieler Objekte gleichzeitig) aus der API zu ermöglichen, 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.