На этой странице объясняется, как использовать API Google Chat для предоставления доступа к пространству Google Chat определенным пользователям в организации Google Workspace, чтобы они могли находить это пространство и присоединяться к нему.
Чтобы указать пользователей в вашей организации, которые могут находить пространство и присоединяться к нему, вы создаете целевые аудитории. Целевая аудитория — это группа людей (например, определенные отделы или вся организация), с которыми вы можете поделиться пространством чата, чтобы повысить осведомленность о нем и сделать его доступным для совместного использования. Целевые аудитории также позволяют вам управлять и настраивать членство в пространстве вместо необходимости приглашать отдельных пользователей в пространство. Дополнительную информацию см. в разделе О целевых аудиториях .
Вы можете сделать только именованные пространства доступными для целевой аудитории. Вы не можете делиться другими типами пространств, такими как прямые сообщения или групповые беседы, с целевыми аудиториями.
Предварительные условия
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat . Вашему аккаунту должна быть назначена роль суперадминистратора вашей организации Google Workspace.
- Целевая аудитория, доступная для доступа в чате. Чтобы создать целевую аудиторию, см. раздел Создание целевой аудитории . Чтобы сделать существующую целевую аудиторию доступной для пространств чата, см. раздел Настройка доступа к пространству для чата .
- Вам необходимо вызвать Google Chat API с аутентификацией пользователя .
Получите идентификатор целевой аудитории
Чтобы получить идентификатор целевой аудитории, сделайте следующее:
В консоли администратора 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 на идентификатор целевой аудитории, который вы получили в предыдущем разделе. Чтобы использовать настройки общего доступа к пространству Chat по умолчанию для вашей организации Google Workspace, замените на default .
Подробные сведения о создании или обновлении пространств с помощью Chat API см. в следующих руководствах:
Связанные темы
- Создайте целевую аудиторию
- Настройте общий доступ в чате
- Создавайте пространства с разными уровнями доступа