Gestire gli spazi di Google Chat come amministratore di Google Workspace

Questa pagina fornisce una panoramica di come gli amministratori di Google Workspace possono utilizzare l'API Google Chat per gestire gli spazi 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. Utilizzando 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 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:

Come autenticarsi e autorizzarsi come amministratore di Google Workspace

Quando utilizzano l'API Chat per le attività di gestione, gli amministratori possono autenticare e autorizzare le richieste richiamando i privilegi amministrativi 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 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 né il nome dell'app Chat.
Delega a livello di dominio Service account per conto di un utente

"[User] ha eseguito [un'azione] tramite [nome dell'app]."

Ad esempio: "Sasha T ha rinominato lo spazio in Discussione sul progetto di rilascio".

L'utente impersonato dal servizio viene identificato come autore dell'azione.

Utilizzare l'API Chat per la tua organizzazione

Gli esempi in questa sezione mostrano come gli amministratori utilizzano l'API Chat quando gestiscono gli spazi e i membri della loro organizzazione con privilegi di amministratore.

I seguenti metodi dell'API Chat abilitano i privilegi di amministratore con useAdminAccess=true.

Gestire le iscrizioni degli utenti agli spazi

I seguenti scenari sono modi in cui, in qualità di amministratore di Google Workspace, puoi gestire l'appartenenza agli spazi 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 insieme a spaces.search(), gli amministratori possono aggiungere un utente a un insieme di spazi determinati dalla query di ricerca. Questa funzionalità può essere utile quando vengono inseriti nuovi dipendenti in un'organizzazione, in quanto consente agli amministratori di automatizzare una procedura di routine.

Trovare utenti e rimuoverli dagli spazi

Utilizzando spaces.members.get(), gli amministratori possono determinare se un utente (interno o esterno all'organizzazione) è membro di uno spazio dell'organizzazione.

Se utilizzato insieme a spaces.search(), gli amministratori possono trovare tutti gli spazi di cui l'utente è membro e poi rimuoverlo dagli spazi con spaces.members.delete(). Questa funzionalità può essere utile quando i dipendenti cambiano team all'interno di un'organizzazione o quando vengono rimossi i dipendenti che non fanno più parte dell'organizzazione. Consente agli amministratori di automatizzare una procedura 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 insieme a spaces.search(), gli amministratori possono trovare gli spazi che non hanno un gestore e promuovere un membro esistente al ruolo di ROLE_MANAGER con spaces.members.patch().

Trovare i membri esterni di uno spazio

Utilizzando spaces.members.list(), gli amministratori possono recuperare un elenco di membri di uno spazio, recuperare i profili utente dall'API People o dall'API Directory dell'organizzazione e poi filtrare i risultati per gli utenti che sono membri di un dominio o di un'organizzazione esterni. Per saperne di più, vedi Come 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 non utilizzati possono occupare spazio di archiviazione prezioso e creare disordine 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, vedi 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, come 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 ai criteri di ricerca

Utilizzando spaces.members.list(), gli amministratori possono recuperare un elenco di membri per qualsiasi spazio dell'organizzazione e analizzare 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 in base a 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.