Per effettuare aggiornamenti in tempo reale, devi inviare richieste all'API Maps Booking. L'API Maps Booking richiede l'autenticazione delle richieste tramite OAuth 2.0 utilizzando un account di servizio Google Cloud che ha accesso all'API e che gli sia stato allocato il QPS necessario. Questa guida illustra i passaggi da seguire per:
- Configura il tuo progetto Google Cloud
- Creare un account di servizio
- Attivare l'API Maps Booking nel tuo progetto Google Cloud
- Eseguire il debug di problemi comuni
Per informazioni su come inviare richieste all'API, consulta la nostra sezione relativa agli aggiornamenti API in tempo reale della guida end-to-end per le prenotazioni.
Configurazione del progetto Google Cloud con il Centro azioni
- Accedi al tuo account Google Cloud Platform.
- Puoi creare un nuovo progetto o utilizzarne uno esistente a questo scopo.
- Prendi nota del numero del progetto cloud perché ti servirà nei passaggi successivi. Il numero del tuo progetto cloud è disponibile anche nella home page di Google Cloud. Il numero del progetto cloud è sempre solo numerico.
- Prendi nota del numero del progetto cloud perché ti servirà nei passaggi successivi. Il numero del tuo progetto cloud è disponibile anche nella home page di Google Cloud. Il numero del progetto cloud è sempre solo numerico.
- Accedi al Portale partner.
- Completa il passaggio 1 nella pagina Attività di onboarding del Portale partner inviando il numero del progetto Cloud e l'indirizzo email del progetto Cloud (l'indirizzo email utilizzato per amministrare il progetto Cloud).
Creazione di un account di servizio e di credenziali OAuth
- Accedi di nuovo al tuo account Google Cloud Platform.
- Vai a
IAM e amministrazione > Account di servizio.
- Cerca l'ID del progetto cloud esistente o appena creato.
- Crea un account di servizio.
- Compila i dettagli dell'account di servizio.
- Assegna al nuovo account di servizio il ruolo più adatto alle esigenze della tua applicazione. La scelta del ruolo per l'account di servizio non influirà sulle chiamate che è possibile effettuare all'API Google Maps Booking, poiché l'allocazione di una quota sufficiente per utilizzarle è determinata invece dall'associazione del numero di progetto nella configurazione del Centro azioni. Se hai dubbi su quale ruolo scegliere, seleziona Progetto > Visualizzatore.
- Dopo aver fatto clic su "Continua" nel passaggio (6), avrai la possibilità di creare chiavi JSON.
- Salva le credenziali json. Assicurati di conservarli in un luogo sicuro, poiché non potrai recuperarli in un secondo momento.
- Accedi nuovamente al Portale partner e completa le attività rimanenti nella pagina Attività di onboarding del Portale partner.
Attivare l'API MapsBooking
- Accedi al tuo account Google Cloud Platform.
- Vai ad API e servizi > Dashboard.
- Fai clic su Abilita API e servizi e cerca
Google Maps Booking API.
- Abilita le seguenti API:
- API Google Maps Booking
- API Google Maps Booking (Dev)
Errori comuni
Esistono vari motivi per cui potresti riscontrare problemi di autorizzazione quando effettui richieste di aggiornamento in tempo reale. Se hai bisogno di indicazioni generali su come effettuare richieste di aggiornamenti in tempo reale, consulta la nostra sezione Aggiornamenti API in tempo reale nella guida end-to-end per le prenotazioni. Puoi anche trovare client di esempio in più lingue nella sezione Esempi di codice.
Se riscontri errori 403, assicurati di soddisfare tutti i seguenti requisiti:
- Utilizza una libreria client di Google.
- Crea credenziali OAuth utilizzando l'autenticazione dell'account di servizio.
- Autorizza in base all'ambito appropriato.
- Effettuare chiamate all'endpoint appropriato (elencato di seguito).
Assicurati di effettuare chiamate all'endpoint corretto:
- Sandbox:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - Produzione:
https://mapsbooking.googleapis.com/v1alpha/...
Assicurati di autorizzare correttamente le richieste di credenziali OAuth:
- Stai eseguendo l'autorizzazione in base all'ambito "https://www.googleapis.com/auth/mapsbooking".
- Stai utilizzando la chiave dell'account di servizio creata in Creare un account di servizio e le credenziali OAuth.
Visualizzi ancora errori?
Se continui a visualizzare errori dopo aver seguito questi passaggi, rivolgiti al tuo contatto del Centro azioni fornendo le seguenti informazioni:
- Numero e ID progetto Cloud con uno screenshot
- ID account di servizio
- Indirizzo email utilizzato per creare l'account di servizio
- I dettagli degli endpoint hanno tentato di effettuare richieste a
- Ora dei tentativi di richiesta
- Richiesta completa e messaggi di errore ricevuti durante l'esecuzione delle richieste.