Il design dell'API Google Ads è diverso da un'architettura REST tradizionale
perché utilizza principalmente metodi personalizzati, come search e mutate,, invece
dei metodi list, get, create, update e delete più tradizionali.
Queste azioni vengono espresse negli URL REST utilizzando la convenzione di mappatura HTTP
: per separare il verbo personalizzato dal resto dell'URL.
Ad esempio, una chiamata API di mutazione della campagna utilizza il seguente URL:
https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate
Uno dei motivi per cui l'API utilizza metodi personalizzati è per consentire il raggruppamento di più operazioni in un'unica richiesta API. La semantica REST rigorosa consentirebbe di aggiornare solo una campagna alla volta. Ad esempio, un messaggio REST tradizionale
update a una
campagna richiederebbe l'invio di una richiesta HTTP PATCH per risorsa
campagna.
Per consentire il raggruppamento di molte operazioni in un unico corpo della richiesta,
l'API Google Ads definisce invece un metodo mutate personalizzato per la maggior parte delle risorse.
Analogamente, per abilitare le letture collettive (recupero di molti 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 illustra nel dettaglio i metodi più utilizzati nell'API Google Ads.