Method: spaces.members.create

Создает человеческое членство или членство в приложении для вызывающего приложения. Создание членства для других приложений не поддерживается. Пример см. в разделе «Пригласить или добавить пользователя или приложение Google Chat в пространство» . Если при создании членства у указанного участника отключена политика автоматического принятия, он будет приглашен и должен принять приглашение в пространство, прежде чем присоединиться. В противном случае при создании членства участник добавляется непосредственно в указанное пространство. Требует аутентификации пользователя .

Чтобы указать добавляемого участника, задайте membership.member.name для человека или участника приложения или задайте membership.group_member.name для члена группы.

  • Чтобы добавить вызывающее приложение в пространство или прямое сообщение между двумя пользователями-людьми, используйтеusers users/app . Невозможно добавить в пространство другие приложения.

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

  • Чтобы добавить или пригласить группу Google в именованное пространство, используйте groups/{group} , где {group} — это id группы из Cloud Identity Groups API. Например, вы можете использовать API поиска групп Cloud Identity для получения идентификатора 123456789 для адреса электронной почты группы group@example.com , а затем добавить или пригласить группу в именованное пространство, установив membership.group_member.name значение groups/123456789 . Групповая электронная почта не поддерживается, а группы Google можно добавлять только в качестве участников в именованных пространствах.

HTTP-запрос

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

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

Параметры пути

Параметры
parent

string

Необходимый. Имя ресурса пространства, для которого необходимо создать членство.

Формат: пробелы/{пробел}

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

Параметры
useAdminAccess

boolean

Если true , метод запускается с использованием прав администратора Google Workspace пользователя.

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

Требуется область действия OAuth 2.0 chat.admin.memberships .

Создание членства в приложении или создание членства для пользователей за пределами организации Google Workspace, принадлежащей администратору, не поддерживается с использованием доступа администратора.

Тело запроса

Тело запроса содержит экземпляр Membership .

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр Membership .

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

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

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

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