Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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:
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 all'interno di 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.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-26 UTC."],[],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]
