Questo documento contiene informazioni di autorizzazione e autenticazione specifiche per l'API Google Workspace Eventi. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace nella pagina Scopri di più su autenticazione e autorizzazione.
Configurare OAuth 2.0 per l'autorizzazione
Configura la schermata per il consenso OAuth e scegli gli ambiti per definire le informazioni da mostrare a utenti e revisori di app e registra la tua app in modo da poterla pubblicare in un secondo momento.
Ambiti API Google Workspace Eventi
Per definire il livello di accesso concesso alla tua app, devi identificare e dichiarare gli ambiti di autorizzazione. Un ambito di autorizzazione è una stringa URI OAuth 2.0 che contiene il nome dell'app Google Workspace, il tipo di dati a cui accede e il livello di accesso. Gli ambiti sono le richieste della tua app di utilizzo dei dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.
Una volta installata l'app, all'utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, dovresti scegliere l'ambito più specifico possibile ed evitare di richiedere ambiti non richiesti dall'app. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e chiaramente descritti.
Se possibile, consigliamo di utilizzare ambiti non sensibili, in quanto consentono di concedere l'ambito di accesso per file e limita l'accesso a funzionalità specifiche richieste da un'app.
L'API Google Workspace Eventi utilizza gli ambiti delle applicazioni Google Workspace che supportano gli abbonamenti. Se la tua app utilizza già gli ambiti richiesti per l'abbonamento, non è necessario aggiungere ulteriori ambiti per utilizzare l'API Eventi di Google Workspace.
La seguente tabella mostra gli ambiti supportati per l'API Google Workspace Eventi:
Codice ambito | Descrizione | Utilizzo | ||
---|---|---|---|---|
Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
Consente alle app Google Chat di visualizzare le chat e inviare messaggi. Concede l'accesso a tutte le funzionalità disponibili per le app di chat. | Non sensibile | ||
https://www.googleapis.com/auth/chat.memberships |
Visualizzare, aggiungere e rimuovere membri dalle conversazioni in Google Chat. | Sensibile |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
Visualizzare i membri delle conversazioni di Google Chat. | Sensibile |
||
https://www.googleapis.com/auth/chat.spaces |
Creare conversazioni e spazi e visualizzare o aggiornare i metadati (incluse le impostazioni della cronologia) in Google Chat. | Sensibile | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
Visualizzare la chat e gli spazi in Google Chat. | Sensibile |
||
https://www.googleapis.com/auth/chat.messages.reaction s |
Visualizzare, aggiungere ed eliminare reazioni ai messaggi in Chat. | Sensibile |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
Visualizzare le reazioni a un messaggio in Chat. | Sensibile |
||
https://www.googleapis.com/auth/chat.messages |
Visualizzare, scrivere, inviare, aggiornare ed eliminare messaggi, oltre a aggiungere, visualizzare ed eliminare reazioni ai messaggi. | Con restrizioni | ||
https://www.googleapis.com/auth/chat.messages.readonly |
Visualizzare messaggi e reazioni in Google Chat. | Limitato |
||
Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
Consenti alle app di creare, modificare e leggere i metadati relativi agli spazi per le riunioni creati dalla tua app. | Sensibile |
||
https://www.googleapis.com/auth/meetings.space.readonly |
Consenti alle app di leggere i metadati relativi a qualsiasi spazio per le riunioni a cui l'utente ha accesso. | Sensibile |
La colonna Utilizzo nella tabella precedente indica la sensibilità di ogni ambito, in base alle seguenti definizioni:
Non sensibile: questi ambiti forniscono l'ambito minimo di accesso all'autorizzazione e richiedono solo la verifica dell'app di base. Per informazioni su questo requisito, consulta i passaggi per la preparazione alla verifica.
Sensibili: questi ambiti consentono di accedere a dati utente Google specifici autorizzati dall'utente per la tua app. Devi eseguire un'ulteriore verifica dell'app. Per informazioni su questo requisito, consulta i passaggi per le app che richiedono ambiti sensibili.
Limitato: questi ambiti offrono accesso ampio ai dati utente Google e richiedono il completamento di una procedura di verifica dell'ambito con restrizioni. Per informazioni su questo requisito, consulta le Norme sui dati utente: servizi API di Google e Requisiti aggiuntivi per ambiti API specifici. Se archivi dati relativi all'ambito con restrizioni sui server (o li trasmetti), devi eseguire una valutazione della sicurezza.
Se la tua app richiede l'accesso a qualsiasi altra API di Google, puoi aggiungere anche questi ambiti. Per ulteriori informazioni sugli ambiti delle API di Google, consulta la pagina relativa all'utilizzo di OAuth 2.0 per accedere alle API di Google.
Per ulteriori informazioni su specifici ambiti OAuth 2.0, consulta Ambiti OAuth 2.0 per le API di Google.
Verifica OAuth
L'utilizzo di determinati ambiti OAuth potrebbe richiedere che l'app esegua il processo di verifica OAuth di Google. Leggi le domande frequenti sulla verifica dell'API OAuth per determinare quando la tua app deve essere sottoposta a verifica e quale tipo di verifica è richiesto. Vedi anche i Termini di servizio aggiuntivi di Google Drive.
Tipi di autenticazione richiesta
Questa sezione spiega quali tipi di autenticazione sono richiesti o supportati e fornisce gli ambiti supportati per ciascun metodo dell'API Google Workspace Eventi.
Per gli abbonamenti agli eventi Google Chat, l'API Google Workspace Eventi supporta l'autenticazione sia degli utenti sia delle app per richiamare alcuni dei suoi metodi. Se un metodo API supporta entrambe le credenziali, il tipo di credenziale utilizzato nella chiamata influisce sul risultato restituito. Ad esempio, se chiami il metodo subscriptions.list()
con l'autenticazione utente, l'API restituisce un elenco di abbonamenti a cui l'utente autenticato può accedere. Se utilizzi l'autenticazione delle app, l'API restituisce un elenco di abbonamenti a cui l'app può accedere. Per scoprire di più sui tipi di autenticazione di Chat, consulta Autenticare e autorizzare le app di Chat e le richieste dell'API Google Chat.
La seguente tabella mostra gli ambiti e i tipi di autenticazione richiesti o supportati per ciascun metodo dell'API Google Workspace Eventi:
Metodo | Autenticazione utente obbligatoria o supportata | Autenticazione delle app supportata (solo app Google Chat) | Ambiti di autorizzazione supportati | |
---|---|---|---|---|
Creare un abbonamento | — |
Richiede un ambito supportato per ogni tipo di evento:
|
||
Acquistare un abbonamento |
Con l'autenticazione utente, questo metodo richiede un ambito che supporti almeno un tipo di evento per l'abbonamento.
Con l'autenticazione delle app (solo app Google Chat):
|
|||
Iscrizioni a elenchi |
Con l'autenticazione utente, questo metodo richiede un ambito che supporti almeno un tipo di evento per l'abbonamento.
Con l'autenticazione delle app (solo app Google Chat):
|
|||
Aggiornare un abbonamento | — |
Richiede un ambito supportato per ogni tipo di evento:
|
||
Riattivare un abbonamento | — |
Richiede un ambito supportato per ogni tipo di evento:
|
||
Eliminare un abbonamento |
Con l'autenticazione utente, questo metodo richiede un ambito che supporti almeno un tipo di evento per l'abbonamento.
Con l'autenticazione delle app (solo app Google Chat):
|
Ambiti per tipo di evento
Quando chiami l'API Google Workspace Eventi utilizzando l'autenticazione utente, devi specificare uno o più ambiti corrispondenti ai tipi di eventi dell'abbonamento.
La seguente tabella mostra gli ambiti di autorizzazione supportati per ciascun tipo di evento:
Eventi | Tipi di eventi | Ambiti di autorizzazione supportati | ||||||
---|---|---|---|---|---|---|---|---|
Google Chat | ||||||||
Viene pubblicato o aggiornato un messaggio. |
|
|
||||||
Viene aggiunta o eliminata una reazione oppure vengono modificate più reazioni. |
|
|
||||||
Viene creato, aggiornato o rimosso un abbonamento oppure vengono modificate più membri. |
|
|
||||||
Uno spazio viene aggiornato o eliminato. |
|
|
||||||
Google Meet | ||||||||
Una conferenza inizia o finisce. |
|
|
||||||
Un partecipante partecipa a una conferenza o la abbandona. |
|
|
||||||
È stata generata una registrazione. |
|
|
||||||
È stata generata una trascrizione. |
|
|