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 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 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 migliorare la visibilità e la condivisibilità dello spazio. I segmenti di pubblico ti consentono anche di gestire e personalizzare le iscrizioni agli spazi anziché dover invitare singoli utenti a uno spazio. Per ulteriori informazioni, consulta la sezione Informazioni sui segmenti di pubblico di destinazione.

Puoi rendere rilevabili gli spazi denominati 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 segmento di pubblico di destinazione.

  3. Trova l'ID del 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, utilizzi l'ID del pubblico di destinazione per creare uno spazio rilevabile o aggiornare uno spazio esistente per renderlo rilevabile dal 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() sulla risorsa Space. Per rendere rilevabile uno spazio esistente, utilizza il metodo update() sulla 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 nell'ambito 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 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: