Method: spaces.setup

Создает пространство и добавляет в него указанных пользователей. Вызывающий пользователь автоматически добавляется в пространство и не должен указываться в качестве членства в запросе. Пример см. в разделе Настройка пространства .

Чтобы указать добавляемых членов-людей, добавьте членство с соответствующим member.name в SetUpSpaceRequest . Чтобы добавить пользователя-человека, используйте users/{user} , где {user} может быть адресом электронной почты пользователя. Для пользователей в одной и той же организации Workspace {user} также может быть {person_id} для человека из API People или id пользователя в API каталога. Например, если resourceName Person API People для user@example.compeople/123456789 , вы можете добавить пользователя в пространство, задав для membership.member.name значение users/user@example.com или users/123456789 .

Для пространства или группового чата, если вызывающий блокируется или заблокирован некоторыми участниками, эти участники не добавляются в созданное пространство.

Чтобы создать прямое сообщение (DM) между вызывающим пользователем и другим пользователем-человеком, укажите ровно одно членство, представляющее пользователя-человека. Если один пользователь блокирует другого, запрос завершается ошибкой и DM не создается.

Чтобы создать DM между вызывающим пользователем и вызывающим приложением, задайте для параметра Space.singleUserBotDm значение true и не указывайте никакого членства. Вы можете использовать этот метод только для настройки DM с вызывающим приложением. Чтобы добавить вызывающее приложение в качестве члена пространства или существующего DM между двумя пользователями-людьми, см. раздел Создание членства .

Если между двумя пользователями уже существует DM, даже если один пользователь блокирует другого во время запроса, то возвращается существующий DM.

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

Требует аутентификации пользователя .

HTTP-запрос

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

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

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
Поля
space

object ( Space )

Необходимый. Поле Space.spaceType является обязательным.

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

Чтобы создать групповой чат, задайте для Space.spaceType значение GROUP_CHAT . Не устанавливайте Space.displayName .

Чтобы создать диалог 1:1 между людьми, задайте для Space.spaceType значение DIRECT_MESSAGE , а для Space.singleUserBotDm — значение false . Не устанавливайте Space.displayName или Space.spaceDetails .

Чтобы создать разговор 1:1 между человеком и вызывающим приложением Chat, задайте для Space.spaceType значение DIRECT_MESSAGE , а Space.singleUserBotDm — значение true . Не устанавливайте Space.displayName или Space.spaceDetails .

Если пространство DIRECT_MESSAGE уже существует, вместо создания нового пространства возвращается это пространство.

requestId

string

Необязательный. Уникальный идентификатор для этого запроса. Рекомендуется случайный UUID. Указание существующего идентификатора запроса возвращает пространство, созданное с этим идентификатором, вместо создания нового пространства. Указание существующего идентификатора запроса из того же приложения Chat с другим пользователем, прошедшим проверку подлинности, возвращает ошибку.

memberships[]

object ( Membership )

Необязательный. Пользователи Google Chat, которым нужно пригласить присоединиться к пространству. Опустите вызывающего пользователя, так как он добавляется автоматически.

Набор в настоящее время позволяет до 20 членств (в дополнение к звонящему).

Поле Membership.member должно содержать user с заполненным name (формат: users/{user} ) и type установленным на User.Type.HUMAN . Вы можете добавлять пользователей-людей только при настройке пространства (добавление приложений чата поддерживается только для настройки прямого сообщения с вызывающим приложением). Вы также можете добавить участников, используя адрес электронной почты пользователя в качестве псевдонима для {user}. Например, user.name может быть users/example@gmail.com ». Чтобы пригласить пользователей Gmail или пользователей из внешних доменов Google Workspace, для {user} необходимо использовать адрес электронной почты пользователя.

Необязательно при установке Space.spaceType в SPACE .

Требуется при установке для Space.spaceType значения GROUP_CHAT вместе с минимум двумя членствами.

Требуется при установке для Space.spaceType значения DIRECT_MESSAGE с пользователем-человеком вместе с ровно одним членством.

Должно быть пустым при создании разговора 1:1 между человеком и вызывающим приложением чата (при установке для Space.spaceType значения DIRECT_MESSAGE и Space.singleUserBotDm значения true ).

Тело ответа

В случае успеха тело ответа содержит экземпляр Space .

Области авторизации

Требуется одна из следующих областей действия OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Дополнительные сведения см. в руководстве по авторизации .