- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Попробуй это!
Создает человеческое членство или членство в приложении для вызывающего приложения. Создание членства для других приложений не поддерживается. Пример см. в разделе «Пригласить или добавить пользователя или приложение 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
илиusersusers/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 | Необходимый. Имя ресурса пространства, для которого необходимо создать членство. Формат: пробелы/{пробел} |
Параметры запроса
Параметры | |
---|---|
useAdminAccess | Если Вызывающий пользователь должен быть администратором Google Workspace с правом управления чатом и беседами в чат-группах . Требуется область действия OAuth 2.0 Создание членства в приложении или создание членства для пользователей за пределами организации 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
Дополнительную информацию см. в руководстве по авторизации .