La progettazione dell'API Google Ads è diversa da una tradizionale architettura REST
perché utilizza principalmente metodi personalizzati, come search e mutate,, anziché i metodi più tradizionali list, get, create, update e delete.
Queste azioni sono espresse negli URL REST utilizzando la convenzione di mapping HTTP di un : 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/v21/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 una sola campagna alla volta. Una update REST tradizionale a una campagna, ad esempio, richiederebbe l'invio di una richiesta HTTP PATCH per ogni 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 batch (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 descrive in dettaglio i metodi più utilizzati nell'API Google Ads.