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 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

Recuperare l'ID pubblico di destinazione

Per ottenere l'ID di un 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. Individua 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 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: