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/v16/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.