Class CreateMembershipRequest
Request message for creating a membership.
Implements
Namespace: Google.Apps.Chat.V1
Assembly: Google.Apps.Chat.V1.dll
Syntax
public sealed class CreateMembershipRequest : IMessage<CreateMembershipRequest>, IEquatable<CreateMembershipRequest>, IDeepCloneable<CreateMembershipRequest>, IBufferMessage, IMessage
Constructors
CreateMembershipRequest()
Declaration
public CreateMembershipRequest()
CreateMembershipRequest(CreateMembershipRequest)
Declaration
public CreateMembershipRequest(CreateMembershipRequest other)
Parameters
Type | Name | Description |
---|---|---|
Create |
other |
Properties
Membership
Required. The membership relation to create.
The memberType
field must contain a user with the user.name
and
user.type
fields populated. The server will assign a resource name
and overwrite anything specified.
When a Chat app creates a membership relation for a human user, it must use certain authorization scopes and set specific values for certain fields:
When authenticating as a user, the
chat.memberships
authorization scope is required.When authenticating as an app, the
chat.app.memberships
authorization scope is required. Authenticating as an app is available in Developer Preview.Set
user.type
toHUMAN
, and setuser.name
with formatusers/{user}
, where{user}
can be the email address for the user. For users in the same Workspace organization{user}
can also be theid
of the person from the People API, or theid
for the user in the Directory API. For example, if the People API Person profile ID foruser@example.com
is123456789
, you can add the user to the space by setting themembership.member.name
tousers/user@example.com
orusers/123456789
.
Inviting users external to the Workspace organization that owns the space requires user authentication.
When a Chat app creates a membership relation for itself, it must
authenticate as a
user
and use the chat.memberships.app
scope, set user.type
to BOT
, and set
user.name
to users/app
.
Declaration
public Membership Membership { get; set; }
Property Value
Type | Description |
---|---|
Membership |
Parent
Required. The resource name of the space for which to create the membership.
Format: spaces/{space}
Declaration
public string Parent { get; set; }
Property Value
Type | Description |
---|---|
string |
ParentAsSpaceName
Declaration
public SpaceName ParentAsSpaceName { get; set; }
Property Value
Type | Description |
---|---|
Space |
UseAdminAccess
Optional. When true
, the method runs using the user's Google Workspace
administrator privileges.
The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege.
Requires the chat.admin.memberships
OAuth 2.0
scope.
Creating app memberships or creating memberships for users outside the administrator's Google Workspace organization isn't supported using admin access.
Declaration
public bool UseAdminAccess { get; set; }
Property Value
Type | Description |
---|---|
bool |