Dienstmethoden

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.