Gestire gli spazi di Google Chat come amministratore di Google Workspace

Questa pagina fornisce una panoramica su 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. Utilizzando l'API Chat, gli amministratori possono creare app Google Chat che gestiscono gli spazi su larga scala e automatizzare le attività comuni o ripetibili.

Cosa possono fare gli amministratori con l'API Chat

Un amministratore può eseguire attività di gestione in base ai loro 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 autenticare e autorizzare 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 di amministratore o configurando la delega a livello di dominio dell'autorità per il service account di un'applicazione.

La tabella seguente descrive i modi in cui gli amministratori possono autenticarsi quando utilizzano l'API Chat.

Autenticazione degli utenti Chi chiama il metodo dell'API 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 Service account per conto di un utente

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

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

L'utente di cui il servizio sta eseguendo l'impersonificazione viene identificato come l'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 l'appartenenza degli utenti agli spazi

I seguenti scenari mostrano come, in qualità di amministratore di Google Workspace, puoi gestire l'appartenenza degli utenti agli spazi 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 si esegue l'onboarding di nuovi dipendenti in un'organizzazione, in quanto consente agli amministratori di automatizzare una procedura di routine.

Trovare gli 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 si esegue l'offboarding dei dipendenti che non fanno più parte dell'organizzazione, in quanto consente agli amministratori di automatizzare una procedura di routine.

Promuovere gli utenti a gestori dello spazio

Utilizzando spaces.members.patch, gli amministratori possono modificare il ruolo di un membro aggiornando il relativo MembershipRole tra le seguenti opzioni:

  • ROLE_MEMBER: un membro dello spazio. Nella UI di Chat, questo ruolo è chiamato Membro.
  • ROLE_ASSISTANT_MANAGER: un gestore dello spazio. Nella UI di Chat, questo ruolo è chiamato Gestore.
  • ROLE_MANAGER: un proprietario dello spazio. Nella UI di Chat, questo ruolo è chiamato Proprietario.

Se utilizzato insieme a spaces.search, gli amministratori possono trovare gli spazi che non hanno un gestore o un proprietario e poi promuovere un membro esistente a gestore o proprietario 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 quelli che sono membri di un dominio o di un'organizzazione esterni. Per ulteriori informazioni, vedi Come Chat identifica gli utenti.

Controllare e gestire gli spazi

I seguenti scenari mostrano come, 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, vedi Trovare ed eliminare gli spazi di Chat inattivi.

Controllare gli spazi dell'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 la data di creazione, la data dell'ultima attività, il numero di membri, lo stato dell'impostazione della cronologia e la 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 nel 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 su MembershipState=ROLE_MANAGER.

Per trovare tutti i gestori degli spazi della tua organizzazione, in tutti gli spazi, puoi utilizzare spaces.search per elencarli tutti. Poi, per ogni spazio dell'elenco, utilizza spaces.members.list per recuperare i gestori.