Method: spaces.create

• HTTP-запрос
• Параметры запроса
• Текст запроса
• Ответный текст
• Области полномочий
• Попробуйте!

Создает пространство. Может использоваться для создания именованного пространства или группового чата в 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 должно быть указано в запросе.

При аутентификации в качестве приложения приложение «Чат» добавляется в качестве участника пространства. Однако, в отличие от аутентификации человека, приложение «Чат» не добавляется в качестве менеджера пространства. По умолчанию приложение «Чат» может быть удалено из пространства всеми участниками пространства. Чтобы разрешить удаление приложения из пространства только менеджерам пространства, установите параметр space.permission_settings.manage_apps в значение managersAllowed .

Состав участников пространства при его создании зависит от того, создано ли пространство в Import mode :

• Режим импорта: Участники не создаются.
• Во всех остальных режимах: вызывающий пользователь добавляется в качестве участника. Это:
  • Само приложение при использовании аутентификации приложения.
  • Пользователь-человек при использовании аутентификации пользователя.

Если при создании пространства вы получаете сообщение об ошибке ALREADY_EXISTS , попробуйте использовать другое displayName . Возможно, это отображаемое имя уже используется в существующем пространстве в организации Google Workspace.

HTTP-запрос

POST https://chat.googleapis.com/v1/spaces

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры запроса

Параметры

requestId

string Необязательно. Уникальный идентификатор для этого запроса. Рекомендуется использовать случайный UUID. Указание идентификатора запроса делает запрос идемпотентным, что гарантирует, что несколько идентичных запросов с одним и тем же идентификатором приведут к созданию только одного пространства. Последующие запросы с тем же идентификатором возвращают существующее пространство и не обновляют его, даже если запрошенные данные отличаются от текущего состояния. Для эффективного использования этого поля: Убедитесь, что последующие запросы идентичны и используют те же учетные данные для аутентификации, что и в исходном запросе. Если пространство уже было создано с указанным идентификатором запроса, запрос возвращает это пространство. Обратите внимание, что возвращаемое пространство может быть не полностью заполнено; API выводит пространство из вашего запроса с заполненным системным именем ресурса. Чтобы получить последние метаданные для пространства, вызовите spaces.get . Повторное использование существующего идентификатора запроса с другим аутентифицированным пользователем приводит к ошибке.

Текст запроса

Тело запроса содержит экземпляр объекта 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

Для получения более подробной информации см. руководство по авторизации .