Eseguire l'autenticazione con l'API Maps Booking

Per eseguire aggiornamenti in tempo reale, devi inviare richieste all'API Maps Booking. L'API Maps Booking richiede di autenticare le richieste tramite OAuth 2.0 utilizzando un service account GCP che abbia accesso all'API e a cui sia stato assegnato il QPS necessario. Questa guida ti illustrerà i passaggi per:

1. Configurare il progetto Google Cloud.
2. Crea un account di servizio
3. Abilita l'API Maps Booking nel tuo progetto GCP
4. Eseguire il debug dei problemi comuni

Per informazioni su come effettuare richieste all'API, consulta la sezione Aggiornamenti API in tempo reale della guida alle offerte di prenotazione.

Configurazione del progetto Google Cloud con Actions Center

Nota:se hai già configurato il tuo account Partner Portal, devi utilizzare il progetto Google Cloud inserito durante la configurazione. Se non hai più accesso a quel progetto Google Cloud o hai bisogno di aiuto per identificarlo, contatta il tuo contatto del Centro azioni.

1. Accedi al tuo account Google Cloud Platform.
2. Puoi creare un nuovo progetto o utilizzarne uno esistente.
   • Prendi nota del numero del progetto cloud perché ti servirà nei passaggi successivi. Il numero del progetto cloud è disponibile anche nella home page di Google Cloud. Il numero del progetto cloud è sempre numerico.
3. Accedi al Partner Portal.
4. Completa il passaggio 1 nella pagina Attività di onboarding del Partner Portal inviando il numero di progetto cloud e l'indirizzo email del progetto cloud (l'indirizzo email utilizzato per amministrare il progetto cloud).

Creazione di un service account e delle credenziali OAuth

Nota:questi passaggi devono essere eseguiti dall'account con l'indirizzo email dello sviluppatore inserito nei passaggi delle attività di onboarding.

1. Accedi di nuovo al tuo account Google Cloud Platform.
2. Vai a IAM e amministrazione > Service account.
3. Cerca l'ID del progetto cloud esistente o appena creato.
4. Crea un service account.
5. Compila i dettagli del service account.
6. Assegna al nuovo service account il ruolo più adatto alle esigenze della tua applicazione. La scelta del ruolo per il service account non influirà sulle chiamate che possono essere effettuate all'API Google Maps Booking, in quanto l'allocazione di una quota sufficiente per utilizzarle è determinata invece dall'associazione del numero di progetto nella configurazione di Actions Center. Se non sai quale ruolo scegliere, seleziona Progetto > Visualizzatore.
7. Dopo aver fatto clic su "Continua" nel passaggio (6), ti verrà data la possibilità di creare chiavi JSON.
8. Salva le credenziali JSON. Assicurati di archiviarli in un luogo sicuro, in quanto non potrai recuperarli in un secondo momento.
9. Accedi di nuovo al Partner Portal e completa le attività rimanenti nella pagina Attività di onboarding del Partner Portal.

Abilita l'API MapsBooking

1. Accedi al tuo account Google Cloud Platform.
2. Vai ad API e servizi > Dashboard.
3. Fai clic su Abilita API e servizi e cerca Google Maps Booking API.
4. Abilita le seguenti API:
   • API Google Maps Booking
   • API Google Maps Booking (Dev)

Nota:se hai già completato i passaggi di onboarding e vuoi aggiornare il progetto cloud esistente a uno nuovo, contatta il tuo referente di Actions Center.

Errori comuni

Esistono diversi 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 sezione Aggiornamenti API in tempo reale della guida alle offerte di prenotazione. Puoi anche trovare client di esempio in più lingue nella sezione Esempi di codice.

Se riscontri errori 403, verifica di soddisfare tutti i seguenti requisiti:

1. Utilizza una libreria client di Google.
2. Crea credenziali OAuth utilizzando l'autenticazione dell'account di servizio.
3. Autorizza in base all'ambito appropriato.
4. Effettua chiamate all'endpoint appropriato (elencato di seguito).

Assicurati di effettuare chiamate all'endpoint corretto:

1. Sandbox: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
2. Produzione: https://mapsbooking.googleapis.com/v1alpha/...

Assicurati di autorizzare correttamente le richieste di credenziali OAuth:

1. L'autorizzazione viene eseguita in base all'ambito "https://www.googleapis.com/auth/mapsbooking".
2. Stai utilizzando la chiave dell'account di servizio creata in Creazione di un service account e delle credenziali OAuth.

Vedi ancora errori?

Se continui a visualizzare errori dopo aver seguito questi passaggi, contatta il tuo contatto dell'Actions Center fornendo le seguenti informazioni:

• Numero di progetto Cloud e ID progetto con uno screenshot
• ID service account
• Email utilizzata per creare il service account
• Dettagli dell'endpoint che ha tentato di effettuare richieste
• Ora dei tentativi di richiesta
• Messaggi di richiesta ed errore completi ricevuti durante l'invio delle richieste.