Questa pagina fornisce una panoramica di come gli amministratori di Google Workspace possono utilizzare l'API Google Chat per gestire gli spazi di Google Chat nella loro organizzazione.
Per gestire gli spazi di Chat, gli amministratori di Google Workspace possono utilizzare lo strumento di gestione degli spazi nella Console di amministrazione Google o chiamare l'API Google Chat. Con l'API Chat, gli amministratori possono creare app Google Chat che gestiscono gli spazi su larga scala e automatizzano le attività comuni o ripetibili.
Cosa possono fare gli amministratori con l'API Chat
Un amministratore può eseguire attività di gestione in base ai suoi ruoli di amministratore assegnati.
In qualità di amministratore di Google Workspace, puoi eseguire una serie di attività di gestione con l'API Chat, ad esempio:
- Cercare gli spazi in base a criteri specificati
- Elenco dei membri di uno spazio
- Aggiungere e rimuovere membri da uno spazio
- Visualizzare i dettagli di un membro e di uno spazio
- Aggiornare o eliminare uno spazio
- Aggiornare l'abbonamento di un utente
Come autenticarsi e autorizzarsi come amministratore di Google Workspace
Quando utilizzi l'API Chat per le attività di gestione, gli amministratori possono autenticare e autorizzare le richieste richiamando i privilegi di amministratore o configurando la delega a livello di dominio dell'autorità per l'account di servizio di un'applicazione.
La seguente tabella descrive i modi in cui gli amministratori possono autenticarsi quando utilizzano l'API Chat.
| Autenticazione degli utenti | Chi chiama il metodo dell'API | Che cosa vedono gli utenti in Chat |
|---|---|---|
| Privilegi amministrativi | Amministratore con useAdminAccess=true
|
"L'amministratore dell'organizzazione ha eseguito [un'azione]." Ad esempio, "L'amministratore dell'organizzazione ha modificato il ruolo di Kiran B in gestore dello spazio". Non identifica il nome o l'ID utente dell'amministratore o il nome dell'app Chat. |
| Delega a livello di dominio | Account di servizio per conto di un utente |
"[Utente] ha eseguito [un'azione] tramite [nome dell'app]." Ad esempio, "Sasha T ha rinominato lo spazio in Discussione sul progetto di rilascio". L'utente di cui viene usurpata l'identità dal servizio viene identificato come colui che ha eseguito l'azione. |
Utilizzare l'API Chat per la tua organizzazione
Gli esempi in questa sezione mostrano come gli amministratori utilizzano l'API Chat per gestire gli spazi e i membri della loro organizzazione con privilegi di amministratore.
I seguenti metodi dell'API Chat abilitano i privilegi amministrativi con
useAdminAccess=true.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
Gestire le iscrizioni allo spazio degli utenti
I seguenti scenari sono modi in cui, in qualità di amministratore di Google Workspace, puoi gestire l'appartenenza allo spazio degli utenti della tua organizzazione con l'API Chat.
Aggiungere utenti agli spazi
Utilizzando spaces.members.create(),
gli amministratori possono aggiungere un utente a qualsiasi spazio di un'organizzazione.
Se utilizzato in combinazione con spaces.search(),
gli amministratori possono aggiungere un utente a un insieme di spazi determinato dalla query di ricerca. Questa funzionalità può essere utile per l'onboarding dei nuovi dipendenti in un'organizzazione, in quanto consente agli amministratori di automatizzare una procedura di routine.
Trovare gli utenti e rimuoverli dagli spazi
Con spaces.members.get(),
gli amministratori possono determinare se un utente (interno o esterno all'organizzazione) è
membro di uno spazio dell'organizzazione.
Se utilizzato in combinazione con spaces.search(),
gli amministratori possono trovare tutti gli spazi di cui l'utente è membro e poi rimuoverli
dagli spazi con
spaces.members.delete().
Questa operazione può essere utile quando i dipendenti si spostano da un team all'altro all'interno di un'organizzazione o quando si esegue il ritiro dei dipendenti che non fanno più parte dell'organizzazione. Consente agli amministratori di automatizzare un processo di routine.
Promuovere gli utenti a gestori dello spazio
Utilizzando spaces.members.patch(),
gli amministratori possono promuovere i membri di uno spazio da ROLE_MEMBER a ROLE_MANAGER.
Gli amministratori possono anche utilizzare spaces.members.patch() per spostare i membri da ROLE_MANAGER
a ROLE_MEMBER.
Se utilizzato in combinazione con spaces.search(),
gli amministratori possono trovare gli spazi che non hanno un gestore e promuovere un
membro esistente a ROLE_MANAGER con spaces.members.patch().
Trovare i membri esterni di uno spazio
Con spaces.members.list(),
gli amministratori possono recuperare un elenco di membri di uno spazio, recuperare i profili degli utenti
dall'API People o dall'API Directory dell'organizzazione e poi filtrare
i risultati in base a chi fa parte di un dominio o di un'organizzazione esterna.
Per ulteriori informazioni, vedi
In che modo Chat identifica gli utenti.
Controllare e gestire gli spazi
I seguenti scenari sono modi in cui, in qualità di amministratore di Google Workspace, puoi controllare e gestire gli spazi della tua organizzazione con l'API Chat.
Trovare ed eliminare gli spazi inattivi
Gli spazi di Chat inutilizzati possono occupare spazio di archiviazione prezioso e creare confusione nell'interfaccia utente. Gli amministratori possono utilizzare
spaces.search()
per trovare gli spazi inattivi e poi
spaces.delete()
per eliminarli. Per ulteriori indicazioni e un esempio di codice, consulta
Trovare ed eliminare gli spazi di Chat inattivi.
Controllare gli spazi nell'organizzazione
Utilizzando spaces.search(),
gli amministratori possono recuperare un elenco di tutti gli spazi di un'organizzazione con informazioni dettagliate
sulle impostazioni e sui metadati di ogni spazio, ad esempio data di creazione, data dell'ultima attività, numero di membri, stato dell'impostazione della cronologia e possibilità di invitare ospiti esterni.
Esportare un elenco di spazi in base ai criteri di ricerca
Utilizzando spaces.search(),
gli amministratori possono recuperare un elenco di spazi che soddisfano i criteri specificati in
query
ed esportare i risultati in un file CSV per l'analisi.
Trovare i membri di uno spazio in base a criteri di ricerca
Con spaces.members.list(),
gli amministratori possono recuperare un elenco di membri per qualsiasi spazio dell'organizzazione e
analizzarne i risultati in base a criteri specifici.
Trovare i gestori di uno spazio
Utilizzando spaces.members.list(),
gli amministratori possono recuperare un elenco di membri di uno spazio filtrato per
MembershipState=ROLE_MANAGER.
Per trovare tutti i gestori dello spazio nella tua organizzazione, in tutti gli spazi, puoi utilizzare spaces.search() per elencarli tutti. Quindi, per ogni spazio nell'elenco, utilizza spaces.members.list per recuperare i gestori.
Argomenti correlati
- Autentica e autorizza utilizzando i privilegi di amministratore
- Cercare e gestire gli spazi di Google Chat con l'API Google Chat in qualità di amministratore di Google Workspace
spaces.search()method