Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication.
To specify the member to add, set the membership.member.name in the CreateMembershipRequest:
To add the calling app to a space or a direct message between two human users, use
users/app. Unable to add other apps to the space.To add a human user, use
users/{user}, where{user}can be the email address for the user. For users in the same Workspace organization{user}can also be theidfor the person from the People API, or theidfor the user in the Directory API. For example, if the People API Person profile ID foruser@example.comis123456789, you can add the user to the space by setting themembership.member.nametousers/user@example.comorusers/123456789.
HTTP request
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent |
Required. The resource name of the space for which to create the membership. Format: spaces/{space} |
Request body
The request body contains an instance of Membership.
Response body
If successful, the response body contains a newly created instance of Membership.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.membershipshttps://www.googleapis.com/auth/chat.memberships.app
For more information, see the Authorization guide.