На этой странице объясняется, как использовать 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— буквенно-цифровой идентификатор вашей целевой аудитории.
В следующем разделе вы используете идентификатор целевой аудитории, чтобы либо создать обнаруживаемое пространство, либо обновить существующее пространство, чтобы сделать его обнаруживаемым для целевой аудитории.
Укажите целевую аудиторию в вашем запросе Chat 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 чата см. в следующих руководствах: