Questa pagina presuppone la conoscenza delle guide per sviluppatori Design orientato alle risorse e Nomi risorse e le completa con dettagli di implementazione specifici dell'API Search Ads 360 Reporting.
Progettazione orientata alle risorse
In genere, l'API Search Ads 360 Reporting segue un design orientato alle risorse, modellato come raccolte di risorse indirizzabili singolarmente (i nomi dell'API). Le risorse vengono richiamate con i relativi nomi e manipolate utilizzando un piccolo insieme di metodi (noti anche come verbi o operazioni).
Questi nomi delle risorse e metodi, combinati con un prefisso della versione dell'API specifico, costituiscono gli URL dell'interfaccia REST. Ad esempio, l'URL riportato di seguito può essere suddiviso nei seguenti singoli componenti in base alla seguente tabella:
https://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search
| Prefisso della versione dell'API | Nome della risorsa (relativo) | Metodo |
|---|---|---|
https://searchads360.googleapis.com/v0
|
customers/1234567890
|
search
|
Tutti gli URL REST per una determinata versione dell'API (ad es. v0)
condividono un prefisso della versione dell'API comune. Il nome e il metodo della risorsa insieme
identificano il servizio API chiamato.
L'API Search Ads 360 Reporting fa un uso intensivo di metodi personalizzati, a differenza della maggior parte delle API REST tradizionali che utilizzano metodi REST standard come list e get. L'API Search Ads 360 Reporting include due metodi personalizzati: search e searchStream.
Le pagine seguenti forniscono ulteriori dettagli sui nomi delle risorse, sui metodi di servizio e sulle convenzioni di denominazione JSON dell'API Search Ads 360 Reporting per illustrare come vengono utilizzati insieme per definire gli endpoint dell'interfaccia REST.