Сделайте пространство Google Chat доступным для просмотра определенным пользователям в организации Google Workspace.

На этой странице объясняется, как использовать API Google Chat для предоставления доступа к пространству Google Chat определенным пользователям в организации Google Workspace, чтобы они могли находить это пространство и присоединяться к нему.

Чтобы указать пользователей в вашей организации, которые могут находить и присоединяться к пространству, вы создаете целевые аудитории. Целевая аудитория — это группа людей, например, определенные отделы или вся организация, с которыми вы можете поделиться пространством чата, чтобы повысить осведомленность о пространстве и возможность совместного использования. Целевые аудитории также позволяют управлять и настраивать членство в пространстве, вместо того чтобы приглашать отдельных пользователей. Для получения дополнительной информации см. раздел «О целевых аудиториях» .

Вы можете сделать именованные пространства доступными только для целевой аудитории. Вы не можете делиться с целевой аудиторией другими типами пространств, такими как личные сообщения или групповые беседы.

Предварительные требования

• Для работы вам потребуется учетная запись Google Workspace Business или Enterprise с доступом к Google Chat . Ваша учетная запись должна иметь роль суперадминистратора для вашей организации Google Workspace.
• Целевая аудитория, доступная для использования в чате. Чтобы создать целевую аудиторию, см. раздел «Создание целевой аудитории» . Чтобы сделать существующую целевую аудиторию доступной для чат-пространств, см. раздел «Настройка доступа к пространству для чата» .
• Необходимо вызвать API Google Chat с аутентификацией пользователя .

Получите идентификатор целевой аудитории.

Чтобы получить идентификатор целевой аудитории, выполните следующие действия:

1. В консоли администратора Google перейдите в menu > Каталог > Целевые аудитории .

   Перейти к целевой аудитории

2. В таблице «Целевые аудитории» щелкните поле «Название» для нужной целевой аудитории.

3. Найдите идентификатор целевой аудитории в URL-адресе страницы. Формат URL-адреса: https://admin.google.com/ac/targetaudiences/ TARGET_AUDIENCE_ID , где TARGET_AUDIENCE_ID — это буквенно-цифровой идентификатор вашей целевой аудитории.

В следующем разделе вы используете идентификатор целевой аудитории, чтобы либо создать доступное для поиска пространство, либо обновить существующее пространство, чтобы сделать его доступным для целевой аудитории.

Укажите целевую аудиторию и детализированные права доступа.

Для создания пространства с определенными правами доступа используйте метод create или setup ресурса Space . Для обновления прав доступа для существующего пространства используйте метод update . Поскольку целевым аудиториям можно предоставлять доступ только к именованным пространствам, тип пространства (представленный в поле spaceType ) должен быть SPACE .

Чтобы указать, кто может обнаруживать пространство или присоединяться к нему, добавьте объект AccessSettings в ресурс Space . В этом объекте используйте поле accessPermissionSettings , чтобы указать одно или несколько из следующих разрешений:

• Доступность для поиска : Используйте discoverSpaceSetting , чтобы определить, кто может найти название и описание пространства и просмотреть его в Google Chat. Вы можете указать несколько целевых аудиторий для поиска.
• Возможность присоединения : Используйте joinSpaceSetting , чтобы определить, кто может присоединиться к пространству без явного приглашения и просмотреть сообщение пространства. Пользователи, которые могут присоединиться к пространству, также должны иметь возможность его обнаружить. Google Chat поддерживает одну целевую аудиторию для этого разрешения.

В следующем примере показано, как сделать пространство доступным для двух целевых аудиторий и доступным для присоединения одной из них:

  "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" } }
        ]
      }
    }
  }

Замените TARGET_AUDIENCE_ID_1 и TARGET_AUDIENCE_ID_2 на идентификатор целевой аудитории, полученный в разделе «Получение идентификатора целевой аудитории» . Чтобы использовать настройки общего доступа к пространству чата по умолчанию для вашей организации Google Workspace, замените на default .

Для обеспечения обратной совместимости используйте поле audience .

Для обеспечения обратной совместимости вы можете продолжать использовать поле audience для указания одной целевой аудитории, которая может присоединиться к пространству, но мы рекомендуем вместо этого указывать целевые аудитории и детализированные разрешения .

Настройка поля audience эквивалентна указанию целевой аудитории как в joinSpaceSetting , так и discoverSpaceSetting :

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

Замените TARGET_AUDIENCE_ID на идентификатор целевой аудитории, полученный в разделе «Получение идентификатора целевой аудитории» . Чтобы использовать настройки общего доступа к пространству чата по умолчанию для вашей организации Google Workspace, замените на default .

Разберитесь в настройках доступа в ответах API.

При получении пробелов объект AccessSettings в ответе отражает детальные настройки прав доступа, установленные для этого пространства.

В AccessSettings следующие поля указывают на возможность поиска и права на присоединение к пространству:

• accessState : Определяется на основе разрешений обнаружения ( discoverSpaceSetting ). Если обнаружение разрешено одной или нескольким целевым аудиториям, это поле имеет DISCOVERABLE . В противном случае оно имеет PRIVATE .
• audience : Специально привязано к правам присоединения ( joinSpaceSetting ). Если одной целевой аудитории предоставлено право присоединения, это поле содержит имя ресурса этой целевой аудитории.

Открытое пространство без необходимости присоединяться к общей аудитории.

Пространство может быть доступно целевой аудитории, но к нему нельзя присоединиться напрямую (например, если для присоединения требуется явное приглашение).

В данном случае объект AccessSettings имеет следующие значения:

• accessState : DISCOVERABLE
• audience : отсутствует или null

Если вы видите, accessState установлено в значение DISCOVERABLE , но audience отсутствует, это означает, что пространство может быть обнаружено целевыми аудиториями, указанными в discoverSpaceSetting , но присоединиться к нему можно только по приглашению. Чтобы узнать, какие целевые аудитории могут обнаружить пространство, проверьте поле accessPermissionSettings.discoverSpaceSetting .

Связанные темы

Подробную информацию о целевых аудиториях см. в следующих руководствах:

• Создайте целевую аудиторию
• Настройка общего доступа в чате
• Создавайте пространства с различными уровнями доступа.

Подробную информацию о создании или обновлении пространств с помощью API чата см. в следующих руководствах:

• Создайте пространство
• Обустройте пространство
• Обновить пространство