La struttura dell'API Google Ads è diversa rispetto a un'architettura REST tradizionale, perché utilizza principalmente metodi personalizzati, come search e mutate,, anziché i più tradizionali metodi list, get, create, update e delete.
Queste azioni sono espresse negli URL REST utilizzando la convenzione di mappatura HTTP di un elemento : per separare il verbo personalizzato dal resto dell'URL.
Ad esempio, una chiamata API mutate della campagna utilizza il seguente URL:
https://googleads.googleapis.com/v16/customers/1234567890/campaigns:mutate
Un motivo per cui l'API utilizza metodi personalizzati è abilitare il raggruppamento di più operazioni in un'unica richiesta API. La semantica REST rigorosa consente di aggiornare una sola campagna alla volta. Un REST tradizionale update a una campagna, ad esempio, richiederebbe l'invio di una richiesta PATCH HTTP per risorsa della campagna.
Per consentire di raggruppare molte operazioni in un unico corpo della richiesta, l'API Google Ads definisce un metodo mutate personalizzato per la maggior parte delle risorse.
Analogamente, per abilitare le letture in batch (recupero di più oggetti contemporaneamente) dall'API,
l'API utilizza un metodo search personalizzato con un linguaggio di query
Google Ads simile a SQL.
La pagina Metodi comuni descrive in dettaglio i metodi più utilizzati nell'API Google Ads.