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 senza 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 del 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 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 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 per il pubblico di destinazione.

Specificare segmenti di pubblico di destinazione e autorizzazioni granulari

Per creare uno spazio con autorizzazioni di accesso specifiche, utilizza il metodo create o setup sulla risorsa Space. Per aggiornare le autorizzazioni per uno spazio esistente, utilizza il metodo update. 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 specificare chi può scoprire o partecipare a uno spazio, includi l'oggetto AccessSettings nella risorsa Space. Nell'oggetto, utilizza il campo accessPermissionSettings per specificare una o più delle seguenti autorizzazioni:

  • Rilevabile: utilizza discoverSpaceSetting per definire chi può trovare il nome e la descrizione di uno spazio e cercarlo in Google Chat. Puoi specificare più segmenti di pubblico di destinazione per la scoperta.
  • Aperto: utilizza joinSpaceSetting per definire chi può partecipare a uno spazio senza un invito esplicito e visualizzare l'anteprima del messaggio dello spazio. Gli utenti che possono partecipare a uno spazio devono anche essere in grado di scoprirlo. Google Chat supporta un unico pubblico di destinazione per questa autorizzazione.

L'esempio seguente mostra come rendere uno spazio individuabile da due segmenti di pubblico di destinazione e consentire l'accesso solo a uno di questi:

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

Sostituisci TARGET_AUDIENCE_ID_1 e TARGET_AUDIENCE_ID_2 con l'ID del pubblico di destinazione che hai ottenuto in Recuperare l'ID del pubblico di destinazione. Per utilizzare le impostazioni di condivisione dello spazio Chat predefinite per la tua organizzazione Google Workspace, sostituisci con default.

Per la compatibilità con le versioni precedenti, utilizza il campo audience.

Per la compatibilità con le versioni precedenti, puoi continuare a utilizzare il campo audience per specificare un singolo pubblico di destinazione che può partecipare a uno spazio, ma ti consigliamo di specificare i segmenti di pubblico di destinazione e le autorizzazioni granulari.

Impostare il campo audience equivale a specificare il pubblico di destinazione sia in joinSpaceSetting che in discoverSpaceSetting:

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

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

Informazioni sulle impostazioni di accesso nelle risposte API

Quando ricevi spazi, l'oggetto AccessSettings nella risposta riflette le autorizzazioni granulari impostate per lo spazio.

I seguenti campi in AccessSettings indicano la possibilità di ricerca e le autorizzazioni di accesso di uno spazio:

  • accessState: derivato dalle autorizzazioni di rilevamento (discoverSpaceSetting). Se il rilevamento viene concesso a uno o più segmenti di pubblico di destinazione, questo campo è DISCOVERABLE. In caso contrario, è PRIVATE.
  • audience: mappato in modo specifico per unire le autorizzazioni (joinSpaceSetting). Se a un singolo pubblico di destinazione viene concessa l'autorizzazione di unione, questo campo contiene il nome della risorsa di quel pubblico di destinazione.

Spazio rilevabile senza pubblico di partecipazione

Uno spazio potrebbe essere rilevabile da un pubblico di destinazione, ma non è possibile partecipare direttamente (ad esempio, se gli utenti devono essere invitati esplicitamente a partecipare).

In questo caso, l'oggetto AccessSettings ha i seguenti valori:

  • accessState: DISCOVERABLE
  • audience: omesso o null

Se vedi accessState impostato su DISCOVERABLE, ma audience non è presente, significa che lo spazio può essere scoperto dai segmenti di pubblico di destinazione specificati in discoverSpaceSetting, ma è possibile accedervi solo tramite invito. Per vedere quali pubblici di destinazione possono scoprire lo spazio, controlla il campo accessPermissionSettings.discoverSpaceSetting.

Per informazioni dettagliate sui segmenti di pubblico di destinazione, consulta le seguenti guide:

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