@google-apps/chat 0.2.0 → 0.3.0

package/build/protos/google/chat/v1/action_status.proto

@@ -27,7 +27,7 @@ option php_namespace = "Google\\Apps\\Chat\\V1";
 option ruby_package = "Google::Apps::Chat::V1";
 
 // Represents the status for a request to either invoke or submit a
-// [dialog](https://developers.google.com/chat/how-tos/dialogs).
+// [dialog](https://developers.google.com/workspace/chat/dialogs).
 message ActionStatus {
   // The status code.
   google.rpc.Code status_code = 1;

package/build/protos/google/chat/v1/annotation.proto

@@ -30,7 +30,7 @@ option ruby_package = "Google::Apps::Chat::V1";
 // Output only. Annotations associated with the plain-text body of the message.
 // To add basic formatting to a text message, see
 // [Format text
-// messages](https://developers.google.com/chat/format-messages).
+// messages](https://developers.google.com/workspace/chat/format-messages).
 //
 // Example plain-text message body:
 // ```
@@ -155,7 +155,7 @@ message RichLinkMetadata {
 // Data for Google Drive links.
 message DriveLinkData {
   // A
-  // [DriveDataRef](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages.attachments#drivedataref)
+  // [DriveDataRef](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#drivedataref)
   // which references a Google Drive file.
   DriveDataRef drive_data_ref = 1;
 

package/build/protos/google/chat/v1/attachment.proto

@@ -34,11 +34,15 @@ message Attachment {
     pattern: "spaces/{space}/messages/{message}/attachments/{attachment}"
   };
 
+  // The source of the attachment.
   enum Source {
+    // Reserved.
     SOURCE_UNSPECIFIED = 0;
 
+    // The file is a Google Drive file.
     DRIVE_FILE = 1;
 
+    // The file is uploaded to Chat.
     UPLOADED_CONTENT = 2;
   }
 
@@ -52,6 +56,7 @@ message Attachment {
   // Output only. The content type (MIME type) of the file.
   string content_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
+  // The data reference to the attachment.
   oneof data_ref {
     // A reference to the attachment data. This field is used with the media API
     // to download the attachment data.
@@ -82,6 +87,7 @@ message DriveDataRef {
   string drive_file_id = 2;
 }
 
+// A reference to the attachment data.
 message AttachmentDataRef {
   // The resource name of the attachment data. This field is used with the media
   // API to download the attachment data.
@@ -93,6 +99,7 @@ message AttachmentDataRef {
   string attachment_upload_token = 2;
 }
 
+// Request to get an attachment.
 message GetAttachmentRequest {
   // Required. Resource name of the attachment, in the form
   // `spaces/*/messages/*/attachments/*`.
@@ -102,6 +109,7 @@ message GetAttachmentRequest {
   ];
 }
 
+// Request to upload an attachment.
 message UploadAttachmentRequest {
   // Required. Resource name of the Chat space in which the attachment is
   // uploaded. Format "spaces/{space}".
@@ -116,6 +124,7 @@ message UploadAttachmentRequest {
   string filename = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Response of uploading an attachment.
 message UploadAttachmentResponse {
   // Reference to the uploaded attachment.
   AttachmentDataRef attachment_data_ref = 1;

package/build/protos/google/chat/v1/chat_service.proto

@@ -55,12 +55,12 @@ service ChatService {
       "https://www.googleapis.com/auth/chat.spaces.create,"
       "https://www.googleapis.com/auth/chat.spaces.readonly";
 
-  // Creates a message in a Google Chat space. For an example, see [Create a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/create).
+  // Creates a message in a Google Chat space. For an example, see [Send a
+  // message](https://developers.google.com/workspace/chat/create-messages).
   //
   // Calling this method requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth) and
-  // supports the following authentication types:
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize)
+  // and supports the following authentication types:
   //
   // - For text messages, user authentication or app authentication are
   // supported.
@@ -78,7 +78,7 @@ service ChatService {
   // messages from blocked members and spaces. For an example, see
   // [List messages](/chat/api/guides/v1/messages/list).
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=spaces/*}/messages"
@@ -86,25 +86,25 @@ service ChatService {
     option (google.api.method_signature) = "parent";
   }
 
-  // Lists memberships in a space. For an example, see [List
-  // memberships](https://developers.google.com/chat/api/guides/v1/members/list).
-  // Listing memberships with
-  // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // Lists memberships in a space. For an example, see [List users and Google
+  // Chat apps in a
+  // space](https://developers.google.com/workspace/chat/list-members). Listing
+  // memberships with [app
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // lists memberships in spaces that the Chat app has
   // access to, but excludes Chat app memberships,
   // including its own. Listing memberships with
   // [User
-  // authentication](https://developers.google.com/chat/api/guides/auth/users)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   // lists memberships in spaces that the authenticated user has access to.
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc ListMemberships(ListMembershipsRequest)
       returns (ListMembershipsResponse) {
     option (google.api.http) = {
@@ -114,16 +114,16 @@ service ChatService {
   }
 
   // Returns details about a membership. For an example, see
-  // [Get a
-  // membership](https://developers.google.com/chat/api/guides/v1/members/get).
+  // [Get details about a user's or Google Chat app's
+  // membership](https://developers.google.com/workspace/chat/get-members).
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc GetMembership(GetMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       get: "/v1/{name=spaces/*/members/*}"
@@ -132,16 +132,16 @@ service ChatService {
   }
 
   // Returns details about a message.
-  // For an example, see [Read a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/get).
+  // For an example, see [Get details about a
+  // message](https://developers.google.com/workspace/chat/get-messages).
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   //
   // Note: Might return a message from a blocked member or space.
   rpc GetMessage(GetMessageRequest) returns (Message) {
@@ -156,15 +156,15 @@ service ChatService {
   // method uses a `patch` request while the `update` method uses a `put`
   // request. We recommend using the `patch` method. For an example, see
   // [Update a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/update).
+  // message](https://developers.google.com/workspace/chat/update-messages).
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   // When using app authentication, requests can only update messages
   // created by the calling Chat app.
   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
@@ -181,15 +181,15 @@ service ChatService {
 
   // Deletes a message.
   // For an example, see [Delete a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/delete).
+  // message](https://developers.google.com/workspace/chat/delete-messages).
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   // When using app authentication, requests can only delete messages
   // created by the calling Chat app.
   rpc DeleteMessage(DeleteMessageRequest) returns (google.protobuf.Empty) {
@@ -201,12 +201,12 @@ service ChatService {
 
   // Gets the metadata of a message attachment. The attachment data is fetched
   // using the [media
-  // API](https://developers.google.com/chat/api/reference/rest/v1/media/download).
+  // API](https://developers.google.com/workspace/chat/api/reference/rest/v1/media/download).
   // For an example, see
-  // [Get a message
-  // attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/get).
+  // [Get metadata about a message
+  // attachment](https://developers.google.com/workspace/chat/get-media-attachments).
   // Requires [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   rpc GetAttachment(GetAttachmentRequest) returns (Attachment) {
     option (google.api.http) = {
       get: "/v1/{name=spaces/*/messages/*/attachments/*}"
@@ -216,9 +216,9 @@ service ChatService {
 
   // Uploads an attachment. For an example, see
   // [Upload media as a file
-  // attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/upload).
+  // attachment](https://developers.google.com/workspace/chat/upload-media-attachments).
   // Requires user
-  // [authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   //
   // You can upload attachments up to 200 MB. Certain file types aren't
   // supported. For details, see [File types blocked by Google
@@ -234,15 +234,15 @@ service ChatService {
   // Lists spaces the caller is a member of. Group chats and DMs aren't listed
   // until the first message is sent. For an example, see
   // [List
-  // spaces](https://developers.google.com/chat/api/guides/v1/spaces/list).
+  // spaces](https://developers.google.com/workspace/chat/list-spaces).
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   //
   // Lists spaces visible to the caller or authenticated user. Group chats
   // and DMs aren't listed until the first message is sent.
@@ -254,15 +254,16 @@ service ChatService {
   }
 
   // Returns details about a space. For an example, see
-  // [Get a space](https://developers.google.com/chat/api/guides/v1/spaces/get).
+  // [Get details about a
+  // space](https://developers.google.com/workspace/chat/get-spaces).
   //
   // Requires
-  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // [authentication](https://developers.google.com/workspace/chat/authenticate-authorize).
   // Supports
   // [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // and [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc GetSpace(GetSpaceRequest) returns (Space) {
     option (google.api.http) = {
       get: "/v1/{name=spaces/*}"
@@ -272,14 +273,14 @@ service ChatService {
 
   // Creates a named space. Spaces grouped by topics aren't supported. For an
   // example, see [Create a
-  // space](https://developers.google.com/chat/api/guides/v1/spaces/create).
+  // space](https://developers.google.com/workspace/chat/create-spaces).
   //
   //  If you receive the error message `ALREADY_EXISTS` when creating
   //  a space, try a different `displayName`. An existing space within
   //  the Google Workspace organization might already use this display name.
   //
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc CreateSpace(CreateSpaceRequest) returns (Space) {
     option (google.api.http) = {
       post: "/v1/spaces"
@@ -291,8 +292,8 @@ service ChatService {
   // Creates a space and adds specified users to it. The calling user is
   // automatically added to the space, and shouldn't be specified as a
   // membership in the request. For an example, see
-  // [Set up a
-  // space](https://developers.google.com/chat/api/guides/v1/spaces/set-up).
+  // [Set up a space with initial
+  // members](https://developers.google.com/workspace/chat/set-up-spaces).
   //
   // To specify the human members to add, add memberships with the appropriate
   // `member.name` in the `SetUpSpaceRequest`. To add a human user, use
@@ -316,8 +317,8 @@ service ChatService {
   // can only use this method to set up a DM with the calling app. To add the
   // calling app as a member of a space or an existing DM between two human
   // users, see
-  // [create a
-  // membership](https://developers.google.com/chat/api/guides/v1/members/create).
+  // [Invite or add a user or app to a
+  // space](https://developers.google.com/workspace/chat/create-members).
   //
   // If a DM already exists between two users, even when one user blocks the
   // other at the time a request is made, then the existing DM is returned.
@@ -328,7 +329,7 @@ service ChatService {
   // might already use this display name.
   //
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc SetUpSpace(SetUpSpaceRequest) returns (Space) {
     option (google.api.http) = {
       post: "/v1/spaces:setup"
@@ -338,14 +339,14 @@ service ChatService {
 
   // Updates a space. For an example, see
   // [Update a
-  // space](https://developers.google.com/chat/api/guides/v1/spaces/update).
+  // space](https://developers.google.com/workspace/chat/update-spaces).
   //
   // If you're updating the `displayName` field and receive the error message
   // `ALREADY_EXISTS`, try a different display name.. An existing space within
   // the Google Workspace organization might already use this display name.
   //
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc UpdateSpace(UpdateSpaceRequest) returns (Space) {
     option (google.api.http) = {
       patch: "/v1/{space.name=spaces/*}"
@@ -358,9 +359,9 @@ service ChatService {
   // that the space's child resources—like messages posted in the space and
   // memberships in the space—are also deleted. For an example, see
   // [Delete a
-  // space](https://developers.google.com/chat/api/guides/v1/spaces/delete).
+  // space](https://developers.google.com/workspace/chat/delete-spaces).
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   // from a user who has permission to delete the space.
   rpc DeleteSpace(DeleteSpaceRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
@@ -370,11 +371,11 @@ service ChatService {
   }
 
   // Completes the
-  // [import process](https://developers.google.com/chat/api/guides/import-data)
+  // [import process](https://developers.google.com/workspace/chat/import-data)
   // for the specified space and makes it visible to users.
   // Requires app authentication and domain-wide delegation. For more
   // information, see [Authorize Google Chat apps to import
-  // data](https://developers.google.com/chat/api/guides/authorize-import).
+  // data](https://developers.google.com/workspace/chat/authorize-import).
   rpc CompleteImportSpace(CompleteImportSpaceRequest)
       returns (CompleteImportSpaceResponse) {
     option (google.api.http) = {
@@ -389,19 +390,19 @@ service ChatService {
   // [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message).
   //
   // With [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users),
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
   // returns the direct message space between the specified user and the
   // authenticated user.
   //
   // With [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts),
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
   // returns the direct message space between the specified user and the calling
   // Chat app.
   //
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users)
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
   // or [app
-  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   rpc FindDirectMessage(FindDirectMessageRequest) returns (Space) {
     option (google.api.http) = {
       get: "/v1/spaces:findDirectMessage"
@@ -410,13 +411,13 @@ service ChatService {
 
   // Creates a human membership or app membership for the calling app. Creating
   // memberships for other apps isn't supported. For an example, see
-  // [ Create a
-  // membership](https://developers.google.com/chat/api/guides/v1/members/create).
+  // [Invite or add a user or a Google Chat app to a
+  // space](https://developers.google.com/workspace/chat/create-members).
   // 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](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   //
   // To specify the member to add, set the `membership.member.name` in the
   // `CreateMembershipRequest`:
@@ -440,12 +441,22 @@ service ChatService {
     option (google.api.method_signature) = "parent,membership";
   }
 
+  // Updates a membership. Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc UpdateMembership(UpdateMembershipRequest) returns (Membership) {
+    option (google.api.http) = {
+      patch: "/v1/{membership.name=spaces/*/members/*}"
+      body: "membership"
+    };
+    option (google.api.method_signature) = "membership,update_mask";
+  }
+
   // Deletes a membership. For an example, see
-  // [Delete a
-  // membership](https://developers.google.com/chat/api/guides/v1/members/delete).
+  // [Remove a user or a Google Chat app from a
+  // space](https://developers.google.com/workspace/chat/delete-members).
   //
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc DeleteMembership(DeleteMembershipRequest) returns (Membership) {
     option (google.api.http) = {
       delete: "/v1/{name=spaces/*/members/*}"
@@ -453,12 +464,12 @@ service ChatService {
     option (google.api.method_signature) = "name";
   }
 
-  // Creates a reaction and adds it to a message. For an example, see
-  // [Create a
-  // reaction](https://developers.google.com/chat/api/guides/v1/reactions/create).
+  // Creates a reaction and adds it to a message. Only unicode emojis are
+  // supported. For an example, see
+  // [Add a reaction to a
+  // message](https://developers.google.com/workspace/chat/create-reactions).
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
-  // Only unicode emoji are supported.
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc CreateReaction(CreateReactionRequest) returns (Reaction) {
     option (google.api.http) = {
       post: "/v1/{parent=spaces/*/messages/*}/reactions"
@@ -468,10 +479,10 @@ service ChatService {
   }
 
   // Lists reactions to a message. For an example, see
-  // [List
-  // reactions](https://developers.google.com/chat/api/guides/v1/reactions/list).
+  // [List reactions for a
+  // message](https://developers.google.com/workspace/chat/list-reactions).
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=spaces/*/messages/*}/reactions"
@@ -479,11 +490,12 @@ service ChatService {
     option (google.api.method_signature) = "parent";
   }
 
-  // Deletes a reaction to a message. For an example, see
+  // Deletes a reaction to a message. Only unicode emojis are supported.
+  // For an example, see
   // [Delete a
-  // reaction](https://developers.google.com/chat/api/guides/v1/reactions/delete).
+  // reaction](https://developers.google.com/workspace/chat/delete-reactions).
   // Requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   rpc DeleteReaction(DeleteReactionRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=spaces/*/messages/*/reactions/*}"

package/build/protos/google/chat/v1/contextual_addon.proto

@@ -66,7 +66,7 @@ message ContextualAddOnMarkup {
       // supported. For more information
       // about formatting text, see
       // [Formatting text in Google Chat
-      // apps](https://developers.google.com/chat/format-messages#card-formatting)
+      // apps](https://developers.google.com/workspace/chat/format-messages#card-formatting)
       // and
       // [Formatting
       // text in Google Workspace

package/build/protos/google/chat/v1/membership.proto

@@ -20,6 +20,7 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/chat/v1/group.proto";
 import "google/chat/v1/user.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Apps.Chat.V1";
@@ -89,7 +90,6 @@ message Membership {
   // Optional. User's role within a Chat space, which determines their permitted
   // actions in the space.
   //
-  // [Developer Preview](https://developers.google.com/workspace/preview):
   // This field can only be used as input in `UpdateMembership`.
   MembershipRole role = 7 [(google.api.field_behavior) = OPTIONAL];
 
@@ -98,9 +98,9 @@ message Membership {
   oneof memberType {
     // The Google Chat user or app the membership corresponds to.
     // If your Chat app [authenticates as a
-    // user](https://developers.google.com/chat/api/guides/auth/users), the
-    // output populates the
-    // [user](https://developers.google.com/chat/api/reference/rest/v1/User)
+    // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+    // the output populates the
+    // [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User)
     // `name` and `type`.
     User member = 3;
 
@@ -127,6 +127,7 @@ message Membership {
   ];
 }
 
+// Request message for creating a membership.
 message CreateMembershipRequest {
   // Required. The resource name of the space for which to create the
   // membership.
@@ -158,6 +159,23 @@ message CreateMembershipRequest {
   Membership membership = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Request message for updating a membership.
+message UpdateMembershipRequest {
+  // Required. The membership to update. Only fields specified by `update_mask`
+  // are updated.
+  Membership membership = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The field paths to update. Separate multiple values with commas
+  // or use `*` to update all field paths.
+  //
+  // Currently supported field paths:
+  //
+  // - `role`
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for listing memberships.
 message ListMembershipsRequest {
   // Required. The resource name of the space for which to fetch a membership
   // list.
@@ -175,8 +193,8 @@ message ListMembershipsRequest {
   //
   // If unspecified, at most 100 memberships are returned.
   //
-  // The maximum value is 1,000. If you use a value more than 1,000, it's
-  // automatically changed to 1,000.
+  // The maximum value is 1000. If you use a value more than 1000, it's
+  // automatically changed to 1000.
   //
   // Negative values return an `INVALID_ARGUMENT` error.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
@@ -192,9 +210,9 @@ message ListMembershipsRequest {
   // Optional. A query filter.
   //
   // You can filter memberships by a member's role
-  // ([`role`](https://developers.google.com/chat/api/reference/rest/v1/spaces.members#membershiprole))
+  // ([`role`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members#membershiprole))
   // and type
-  // ([`member.type`](https://developers.google.com/chat/api/reference/rest/v1/User#type)).
+  // ([`member.type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/User#type)).
   //
   // To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`.
   //
@@ -217,6 +235,7 @@ message ListMembershipsRequest {
   // role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"
   // ```
   //
+  //
   // Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
   // error.
   string filter = 5 [(google.api.field_behavior) = OPTIONAL];
@@ -237,10 +256,11 @@ message ListMembershipsRequest {
   // that don't match the filter criteria aren't returned.
   //
   // Currently requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   bool show_invited = 7 [(google.api.field_behavior) = OPTIONAL];
 }
 
+// Response to list memberships of the space.
 message ListMembershipsResponse {
   // Unordered list. List of memberships in the requested (or first) page.
   repeated Membership memberships = 1
@@ -251,6 +271,7 @@ message ListMembershipsResponse {
   string next_page_token = 2;
 }
 
+// Request to get a membership of a space.
 message GetMembershipRequest {
   // Required. Resource name of the membership to retrieve.
   //
@@ -260,8 +281,8 @@ message GetMembershipRequest {
   // Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
   //
   // When [authenticated as a
-  // user](https://developers.google.com/chat/api/guides/auth/users), you can
-  // use the user's email as an alias for `{member}`. For example,
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // you can use the user's email as an alias for `{member}`. For example,
   // `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
   // email of the Google Chat user.
   string name = 1 [
@@ -270,6 +291,7 @@ message GetMembershipRequest {
   ];
 }
 
+// Request to delete a membership in a space.
 message DeleteMembershipRequest {
   // Required. Resource name of the membership to delete. Chat apps can delete
   // human users' or their own memberships. Chat apps can't delete other apps'