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

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 trovare e partecipare a uno spazio, crea segmenti di pubblico di destinazione. Un segmento di 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 i membri dello spazio, invece di dover invitare i singoli utenti in uno spazio. Per ulteriori informazioni, consulta Informazioni sui segmenti di pubblico di destinazione.

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

Prerequisiti

Recuperare l'ID pubblico di destinazione

Per ottenere 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 pubblico di destinazione.

  3. Trova l'ID 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 del tuo 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.

Specificare il pubblico di destinazione nella richiesta dell'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 dal tuo pubblico di destinazione, includi l'oggetto AccessSettings nella risorsa Space nell'ambito della richiesta all'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 ottenuto nella sezione precedente. Per utilizzare le impostazioni predefinite di condivisione dello spazio di Chat 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: