Rendere uno spazio di Google Chat rilevabile per utenti specifici in un'organizzazione Google Workspace

Questa pagina spiega come utilizzare l'API Google Chat per condividere uno spazio di 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, devi creare 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 visibilità e la condivisibilità. I segmenti di pubblico di destinazione ti consentono anche di gestire e personalizzare le appartenenze agli spazi senza dover invitare i singoli utenti a uno spazio. Per saperne di più, consulta Informazioni sui segmenti di pubblico di destinazione.

Puoi rendere rilevabili per i segmenti di pubblico di destinazione solo gli spazi denominati. Non puoi condividere altri tipi di spazi, come i messaggi diretti o le conversazioni di gruppo, con i segmenti di pubblico di destinazione.

Prerequisiti

Recuperare l'ID del segmento di pubblico di destinazione

Per recuperare l'ID di un segmento di pubblico di destinazione:

  1. Nella Console di amministrazione Google, vai a Menu > Directory > Segmenti di pubblico di destinazione.

    Vai a Segmenti di pubblico di destinazione

  2. Nella tabella Segmenti di pubblico di destinazione, fai clic sul campo Nome del segmento di pubblico di destinazione.

  3. Trova l'ID del segmento di pubblico di destinazione nell'URL della pagina. Il formato dell'URL è https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, dove TARGET_AUDIENCE_ID è l'ID alfanumerico per il segmento di pubblico di destinazione.

Nella sezione successiva, utilizzerai l'ID del segmento di pubblico di destinazione per creare uno spazio rilevabile o aggiornare uno spazio esistente in modo che sia rilevabile per il segmento di pubblico di destinazione.

Specificare il segmento di pubblico di destinazione nella richiesta dell'API Chat

Per creare uno spazio per un segmento di pubblico di destinazione specifico, utilizza il create() o setup() metodo sulla risorsa Space. Per rendere rilevabile uno spazio esistente, utilizza il update() metodo sulla risorsa Space. Poiché solo gli spazi denominati possono essere condivisi con i segmenti di pubblico di destinazione, il tipo di spazio (rappresentato nel campo spaceType) deve essere SPACE.

Per rendere rilevabile uno spazio per il tuo segmento di pubblico di destinazione, includi l' AccessSettings oggetto nella risorsa Space come parte della richiesta dell'API Chat. Nell'oggetto, specifica il campo audience:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Sostituisci TARGET_AUDIENCE_ID con l'ID del segmento di pubblico di destinazione che hai ottenuto nella sezione precedente. Per utilizzare le impostazioni di condivisione dello spazio Chat predefinite per la tua organizzazione Google Workspace, sostituisci con default.

Per informazioni dettagliate sulla creazione o sull'aggiornamento degli spazi utilizzando l'API Chat, consulta le seguenti guide: