Il design dell'API Google Ads è diverso da un'architettura REST tradizionale
perché utilizza principalmente metodi personalizzati, come search e mutate,
dei metodi più tradizionali list, get, create, update e delete.
Queste azioni sono espresse negli URL REST mediante la mappatura HTTP
convenzione di : per separare il verbo personalizzato dal resto dell'URL.
Ad esempio, una chiamata API mutate di una campagna utilizza il seguente URL:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Uno dei motivi per cui l'API utilizza metodi personalizzati è consentire il raggruppamento in batch di
operazioni in una singola richiesta API. Una semantica REST rigorosa consente solo
aggiornare una campagna alla volta. Un REST tradizionale
update a un
una campagna, ad esempio, richiede l'invio di una richiesta PATCH HTTP per campagna
risorsa.
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 una query di Google Ads di tipo SQL
Lingua.
La pagina Metodi comuni descrive in dettaglio i i metodi più utilizzati nell'API Google Ads.