На этой странице объясняется, как использовать API Google Chat для предоставления доступа к пространству Google Chat определенным пользователям в организации Google Workspace, чтобы они могли находить это пространство и присоединяться к нему.
Чтобы указать пользователей в вашей организации, которые могут находить и присоединяться к пространству, вы создаете целевые аудитории. Целевая аудитория — это группа людей, например, определенные отделы или вся организация, с которыми вы можете поделиться пространством чата, чтобы повысить осведомленность о пространстве и возможность совместного использования. Целевые аудитории также позволяют управлять и настраивать членство в пространстве, вместо того чтобы приглашать отдельных пользователей. Для получения дополнительной информации см. раздел «О целевых аудиториях» .
Вы можете сделать именованные пространства доступными только для целевой аудитории. Вы не можете делиться с целевой аудиторией другими типами пространств, такими как личные сообщения или групповые беседы.
Предварительные требования
- Для работы вам потребуется учетная запись Google Workspace Business или Enterprise с доступом к Google Chat . Ваша учетная запись должна иметь роль суперадминистратора для вашей организации Google Workspace.
- Целевая аудитория, доступная для использования в чате. Чтобы создать целевую аудиторию, см. раздел «Создание целевой аудитории» . Чтобы сделать существующую целевую аудиторию доступной для чат-пространств, см. раздел «Настройка доступа к пространству для чата» .
- Необходимо вызвать API Google Chat с аутентификацией пользователя .
Получите идентификатор целевой аудитории.
Чтобы получить идентификатор целевой аудитории, выполните следующие действия:
В консоли администратора Google перейдите в > Каталог > Целевые аудитории .
В таблице «Целевые аудитории» щелкните поле «Название» для нужной целевой аудитории.
Найдите идентификатор целевой аудитории в URL-адресе страницы. Формат URL-адреса:
https://admin.google.com/ac/targetaudiences/ TARGET_AUDIENCE_ID, гдеTARGET_AUDIENCE_ID— это буквенно-цифровой идентификатор вашей целевой аудитории.
В следующем разделе вы используете идентификатор целевой аудитории, чтобы либо создать доступное для поиска пространство, либо обновить существующее пространство, чтобы сделать его доступным для целевой аудитории.
Укажите целевую аудиторию в запросе к API чата.
Для создания пространства для конкретной целевой аудитории используйте методы create() или setup() ресурса Space . Чтобы сделать существующее пространство доступным для поиска, используйте метод update() ресурса Space . Поскольку целевым аудиториям можно предоставлять доступ только к именованным пространствам, тип пространства (представленный в поле spaceType ) должен быть SPACE .
Чтобы сделать пространство доступным для вашей целевой аудитории, включите объект AccessSettings в ресурс Space в качестве части запроса к Chat API. В объекте укажите поле audience :
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Замените TARGET_AUDIENCE_ID на идентификатор целевой аудитории, полученный в предыдущем разделе. Чтобы использовать настройки общего доступа к пространству чата по умолчанию для вашей организации Google Workspace, замените на default .
Подробную информацию о создании или обновлении пространств с помощью API чата см. в следующих руководствах:
Связанные темы
- Создайте целевую аудиторию
- Настройка общего доступа в чате
- Создавайте пространства с различными уровнями доступа.