In questa pagina viene spiegato come utilizzare l'API Google Chat per condividere uno spazio di Google Chat con utenti specifici di un'organizzazione Google Workspace, in modo che possano scoprire e partecipare allo spazio.
Per specificare gli utenti della tua organizzazione che possono scoprire e partecipare a uno spazio, crea segmenti di pubblico di destinazione. Un pubblico di destinazione è un gruppo di persone, ad esempio reparti specifici o l'intera organizzazione, con cui puoi condividere uno spazio di Chat per migliorarne la consapevolezza e la condivisibilità. I segmenti di pubblico di destinazione ti consentono anche di gestire e personalizzare i membri dello spazio, invece di dover invitare i singoli utenti in uno spazio. Per saperne di più, consulta Informazioni sui segmenti di pubblico di destinazione.
Puoi rendere rilevabili solo gli spazi denominati per i segmenti di pubblico di destinazione. Non puoi condividere altri tipi di spazi, ad esempio messaggi diretti o conversazioni di gruppo, con i segmenti di pubblico di destinazione.
Prerequisiti
- Un account Google Workspace con accesso a Google Chat. Il tuo account deve disporre del ruolo di super amministratore per la tua organizzazione Google Workspace.
- Un pubblico di destinazione disponibile per l'accesso in Chat. Per creare un pubblico di destinazione, consulta Creare un pubblico di destinazione. Per rendere disponibile un pubblico di destinazione esistente per gli spazi di Chat, vedi Configurare l'accesso allo spazio per Chat.
Recuperare l'ID pubblico di destinazione
Per ottenere l'ID di un pubblico di destinazione:
Nella Console di amministrazione Google, vai a Menu > Directory > Segmenti di pubblico di destinazione.
Nella tabella Segmenti di pubblico di destinazione, fai clic sul campo Nome del pubblico di destinazione.
Individua l'ID pubblico di destinazione nell'URL della pagina. Il formato dell'URL è
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID
, doveTARGET_AUDIENCE_ID
è l'ID alfanumerico del pubblico di destinazione.
Nella sezione successiva, utilizzerai l'ID pubblico di destinazione per creare uno spazio rilevabile o aggiornarne uno esistente per renderlo rilevabile per il pubblico di destinazione.
Specifica il pubblico di destinazione nella richiesta API Chat
Per creare uno spazio per un pubblico di destinazione specifico, utilizza il metodo create()
o
setup()
nella risorsa Space
. Per rendere rilevabile uno spazio esistente, utilizza il metodo update()
nella risorsa Space
. Poiché solo
gli spazi con nome possono essere condivisi con i segmenti di pubblico di destinazione, il tipo di spazio
(rappresentato nel campo spaceType
) deve essere SPACE
.
Per rendere uno spazio rilevabile per il tuo pubblico di destinazione, includi l'oggetto
AccessSettings
nella risorsa Space
come parte della richiesta API Chat. Nell'oggetto, specifica il campo audience
:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Sostituisci TARGET_AUDIENCE_ID
con l'ID del pubblico di destinazione
ottenuto nella sezione precedente. Per utilizzare le impostazioni di condivisione dello spazio di Chat predefinite per la tua organizzazione Google Workspace, sostituisci con default
.
Per maggiori dettagli sulla creazione o sull'aggiornamento degli spazi utilizzando l'API Chat, consulta le seguenti guide:
Argomenti correlati
- Creare un pubblico di destinazione
- Configurare la condivisione in Chat
- Creare spazi con livelli di accesso diversi