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, partecipare e visualizzare i membri dello spazio.

Per specificare gli utenti della tua organizzazione che possono scoprire, partecipare e visualizzare i membri di 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 avere un controllo più granulare su chi può accedere allo spazio e alle relative informazioni. I segmenti di pubblico di destinazione ti consentono anche di gestire e personalizzare le iscrizioni agli spazi anziché dover invitare singoli utenti a uno spazio. Per saperne di più, 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 per il pubblico di destinazione.

Specificare i segmenti di pubblico di destinazione e le 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, partecipare o visualizzare i membri di 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.
  • A cui è possibile partecipare: 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 singolo pubblico di destinazione per questa autorizzazione.
  • Visualizza appartenenza: utilizza viewSpaceMembershipSetting per definire chi può vedere l'elenco dei membri di uno spazio. Quando aggiorni chi può visualizzare l'appartenenza allo spazio, accessSettings.accessPermissionSettings.viewSpaceMembershipSetting deve essere specificato insieme a permissionSettings.viewSpaceMembership sia in updateMask che nel corpo della richiesta. Quando un pubblico di destinazione viene configurato in viewSpaceMembershipSetting, l'accesso viewSpaceMembership deve essere concesso a tutti i membri (managersAllowed, assistantManagersAllowed e membersAllowed impostati su true).

L'esempio seguente mostra come rendere uno spazio individuabile da due segmenti di pubblico di destinazione, consentire l'accesso solo a uno di questi e garantire che tutti i membri e i segmenti di pubblico di destinazione specificati possano visualizzare l'elenco dei partecipanti:

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

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 segmenti di pubblico di destinazione e autorizzazioni granulari.

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

  "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 o elenchi 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 partecipare solo su invito. Per vedere quali segmenti di pubblico 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: