Method: spaces.create

Создает пространство. Может использоваться для создания именованного пространства или группового чата в Import mode . Пример см. в разделе «Создание пространства» .

Поддерживаются следующие типы аутентификации :

При аутентификации в качестве приложения поле 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

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