Questo documento contiene autorizzazioni specifiche per l'API Google Workspace Events e informazioni sull'autenticazione. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace all'indirizzo 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 quali informazioni mostrare a utenti e revisori di app e registrare la tua app per poterla pubblicare in un secondo momento.
Ambiti dell'API Google Workspace Events
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 lavorare con i dati di Google Workspace, che includono utente Dati dell'Account Google.
Quando la tua app viene installata, 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 dalla tua app. Utenti più concedere immediatamente l'accesso ad ambiti limitati e descritti chiaramente.
Se possibile, consigliamo di utilizzare ambiti non sensibili, in quanto garantisce la concessione per file e restringe l'accesso alle funzionalità specifiche richieste da un'app.
L'API Google Workspace Events utilizza gli ambiti di Google Workspace le applicazioni che supportano gli abbonamenti. Se la tua app utilizza già gli ambiti richieste per il tuo abbonamento, non devi aggiungere altre gli ambiti per utilizzare l'API Google Workspace Events.
La seguente tabella mostra gli ambiti supportati per API Google Workspace Events:
| 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. Dà 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 |
Visualizza, aggiungi ed elimina le 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 |
Visualizza 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 delle riunioni creati dalla tua app. | Sensibile |
||
https://www.googleapis.com/auth/meetings.space.readonly |
Consenti alle app di leggere i metadati relativi agli spazi delle riunioni a cui l'utente ha accesso. | Sensibile |
||
La colonna Utilizzo della tabella precedente indica la sensibilità di ciascun ambito, in base alle seguenti definizioni:
Non sensibile: questi ambiti offrono l'ambito più ristretto accesso alle autorizzazioni e richiede solo la verifica app di base. Per informazioni su questo requisito, consulta la sezione Passaggi per la preparazione verifica.
Sensibili: questi ambiti forniscono l'accesso a dati utente specifici di Google. autorizzato dall'utente per la tua app. Occorre completare un'ulteriore verifica delle app. Per informazioni su questo requisito, consulta la sezione Passaggi. per le app che richiedono ambiti
Con restrizioni: questi ambiti forniscono un accesso ampio ai dati utente di Google. e richiedono di eseguire una procedura di verifica dell'ambito con restrizioni. Per per informazioni su questo requisito, consulta la sezione Servizi API di Google: dati utente Norme e Requisiti aggiuntivi per API specifiche Ambiti. Se archivi dati relativi ad ambito con restrizioni sui server (o trasmetti), devi: devono superare una valutazione della sicurezza.
Se la tua app richiede l'accesso a qualsiasi altra API di Google, puoi aggiungere questi ambiti . Per ulteriori informazioni sugli ambiti delle API di Google, consulta Utilizzo di OAuth 2.0 per Accedi alle API di Google.
Per ulteriori informazioni sugli ambiti OAuth 2.0 specifici, vedi Ambiti OAuth 2.0 per API di Google.
Verifica OAuth
L'utilizzo di determinati ambiti OAuth potrebbe richiedere che l'app continui con le Verifica OAuth . Leggi la pagina sulla verifica dell'API OAuth Domande frequenti per determinare quando la tua app deve essere sottoposta a verifica e che tipo di la verifica è obbligatoria. Consulta anche i Termini aggiuntivi di Google Drive servizio.
Tipi di autenticazione richiesta
Questa sezione spiega quali tipi di autenticazione sono richiesti o supportati. e fornisce gli ambiti supportati per ogni metodo API Google Workspace Events.
Per gli abbonamenti agli eventi di Google Chat, l'API Google Workspace Events
supporta l'autenticazione degli utenti e delle app per chiamare alcuni dei suoi metodi. Se un'API
supporta entrambe le credenziali, ovvero 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 sottoscrizioni che
a cui può accedere l'utente autenticato. Se utilizzi l'autenticazione app, l'API
restituisce un elenco di abbonamenti a cui l'app può accedere. Per scoprire di più su
i tipi di autenticazione di Chat, consulta Autenticare e autorizzare
App di chat e API Google Chat
richieste.
La tabella seguente mostra quali ambiti e tipi di l'autenticazione è obbligatoria o supportata per ogni API Google Workspace Events :
| Metodo | Autenticazione utente richiesta o supportata | Autenticazione 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):
|
|||
| Elenco di iscrizioni |
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 Events utilizzando l'autenticazione utente, devi specificare uno o più ambiti che corrispondano ai tipi di eventi del abbonamento.
La tabella seguente mostra quali ambiti di autorizzazione sono supportati per ciascuno tipo di evento:
| Eventi | Tipi di evento | Ambiti di autorizzazione supportati | ||||||
|---|---|---|---|---|---|---|---|---|
| Google Chat | ||||||||
| Un messaggio viene pubblicato o aggiornato. |
|
|
||||||
| Viene aggiunta o eliminata una reazione oppure vengono modificate più reazioni. |
|
|
||||||
| Un abbonamento creato, aggiornato o rimosso o più abbonamenti vengono modificate. |
|
|
||||||
| Uno spazio viene aggiornato o eliminato. |
|
|
||||||
| Google Meet | ||||||||
| Una conferenza inizia o termina. |
|
|
||||||
| Un partecipante partecipa a una conferenza o la abbandona. |
|
|
||||||
| È stata generata una registrazione. |
|
|
||||||
| È stata generata una trascrizione. |
|
|
||||||