Создает пространство. Может использоваться для создания именованного пространства или группового чата в Import mode . Пример см. в разделе Создание пространства .
Поддерживает следующие типы аутентификации :
Аутентификация приложения с одобрением администратора в Developer Preview и одной из следующих областей авторизации:
-
https://www.googleapis.com/auth/chat.app.spaces.create -
https://www.googleapis.com/auth/chat.app.spaces
-
Аутентификация пользователя с одной из следующих областей авторизации:
-
https://www.googleapis.com/auth/chat.spaces.create -
https://www.googleapis.com/auth/chat.spaces -
https://www.googleapis.com/auth/chat.import(только пространства в режиме импорта)
-
При аутентификации в качестве приложения в запросе необходимо указать поле space.customer .
При аутентификации в качестве приложения приложение Chat добавляется как участник пространства. Однако, в отличие от аутентификации человека, приложение Chat не добавляется как менеджер пространства. По умолчанию приложение Chat может быть удалено из пространства всеми участниками пространства. Чтобы разрешить только менеджерам пространства удалять приложение из пространства, установите space.permission_settings.manage_apps на managersAllowed .
Членство в пространстве при создании зависит от того, создано ли пространство в Import mode :
- Режим импорта: участники не создаются.
- Все остальные режимы: Вызывающий пользователь добавляется как участник. Это:
- Само приложение при использовании аутентификации приложения.
- Пользователь-человек при использовании аутентификации пользователя.
Если при создании пространства вы получаете сообщение об ошибке ALREADY_EXISTS , попробуйте другое displayName . Существующее пространство в организации Google Workspace может уже использовать это отображаемое имя.
HTTP-запрос
POST https://chat.googleapis.com/v1/spaces
URL-адрес использует синтаксис gRPC Transcoding .
Параметры запроса
| Параметры | |
|---|---|
requestId | Необязательно. Уникальный идентификатор для этого запроса. Рекомендуется случайный UUID. Указание существующего идентификатора запроса возвращает пространство, созданное с этим идентификатором, вместо создания нового пространства. Указание существующего идентификатора запроса из того же приложения Chat с другим аутентифицированным пользователем возвращает ошибку. |
Текст запроса
Тело запроса содержит экземпляр Space .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Space .
Области действия авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/chat.app.spaces.create -
https://www.googleapis.com/auth/chat.app.spaces -
https://www.googleapis.com/auth/chat.import -
https://www.googleapis.com/auth/chat.spaces -
https://www.googleapis.com/auth/chat.spaces.create
Более подробную информацию см. в Руководстве по авторизации .