Scegli gli ambiti API Google Workspace Events

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:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
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):

  • chat.bot
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):

  • chat.bot
Aggiornare un abbonamento

Richiede un ambito supportato per ogni tipo di evento:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
Riattivare un abbonamento

Richiede un ambito supportato per ogni tipo di evento:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
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):

  • chat.bot

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.
  • google.workspace.chat.message.v1.created
  • google.workspace.chat.message.v1.updated
  • chat.messages
  • chat.messages.readonly
Viene aggiunta o eliminata una reazione oppure vengono modificate più reazioni.
  • google.workspace.chat.reaction.v1.created
  • google.workspace.chat.reaction.v1.deleted
  • google.workspace.chat.reaction.v1.batchChanged
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.messages
  • chat.messages.readonly
Un abbonamento creato, aggiornato o rimosso o più abbonamenti vengono modificate.
  • google.workspace.chat.membership.v1.created
  • google.workspace.chat.membership.v1.updated
  • google.workspace.chat.membership.v1.deleted
  • google.workspace.chat.membership.v1.batchChanged
  • chat.memberships
  • chat.memberships.readonly
Uno spazio viene aggiornato o eliminato.
  • google.workspace.chat.space.v1.updated
  • google.workspace.chat.space.v1.deleted
  • chat.spaces
  • chat.spaces.readonly
Google Meet  
Una conferenza inizia o termina.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended
  • meetings.space.created
  • meetings.space.readonly
Un partecipante partecipa a una conferenza o la abbandona.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left
  • meetings.space.created
  • meetings.space.readonly
È stata generata una registrazione.
  • google.workspace.meet.recording.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly
È stata generata una trascrizione.
  • google.workspace.meet.transcript.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly