Создаёт пространство. Может использоваться для создания именованного пространства или группового чата в Import mode . Пример см. в разделе Создание пространства .
Поддерживает следующие типы аутентификации :
Аутентификация приложения с одобрением администратора и одной из следующих областей авторизации:
-
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 .
Параметры запроса
| Параметры | |
|---|---|
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
Более подробную информацию смотрите в Руководстве по авторизации .