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 herkömmlichen Methoden list, get, create, update und delete verwendet werden.
Diese Aktionen werden in REST-URLs mit der HTTP-Zuordnung-Konvention eines : 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/v21/customers/1234567890/campaigns:mutate
Ein Grund dafür, dass in der API benutzerdefinierte Methoden verwendet werden, ist, dass mehrere Vorgänge in einer einzigen API-Anfrage zusammengefasst werden können. Gemäß der REST-Semantik wäre es nur möglich, jeweils eine Kampagne zu aktualisieren. Für eine herkömmliche REST-update für eine Kampagne wäre beispielsweise eine HTTP-PATCH-Anfrage pro Kampagnenressource erforderlich.
Damit viele Vorgänge in einem einzelnen Anfragebody zusammengefasst werden können, wird in der Google Ads API für die meisten Ressourcen stattdessen eine benutzerdefinierte mutate-Methode definiert.
Um Batchlesevorgänge (Abrufen vieler Objekte gleichzeitig) über die API zu ermöglichen, wird in der API eine benutzerdefinierte search-Methode mit einer SQL-ähnlichen Google Ads-Abfragesprache verwendet.
Auf der Seite Gängige Methoden werden die am häufigsten verwendeten Methoden in der Google Ads API ausführlich beschrieben.