@google-apps/chat 0.2.0 → 0.4.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

@@ -23,7 +23,9 @@ import "google/chat/v1/membership.proto";
 import "google/chat/v1/message.proto";
 import "google/chat/v1/reaction.proto";
 import "google/chat/v1/space.proto";
+import "google/chat/v1/space_read_state.proto";
 import "google/chat/v1/space_setup.proto";
+import "google/chat/v1/thread_read_state.proto";
 import "google/protobuf/empty.proto";
 
 option csharp_namespace = "Google.Apps.Chat.V1";
@@ -53,14 +55,16 @@ service ChatService {
       "https://www.googleapis.com/auth/chat.messages.readonly,"
       "https://www.googleapis.com/auth/chat.spaces,"
       "https://www.googleapis.com/auth/chat.spaces.create,"
-      "https://www.googleapis.com/auth/chat.spaces.readonly";
+      "https://www.googleapis.com/auth/chat.spaces.readonly,"
+      "https://www.googleapis.com/auth/chat.users.readstate,"
+      "https://www.googleapis.com/auth/chat.users.readstate.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 +82,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 +90,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 +118,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 +136,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 +160,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 +185,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 +205,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 +220,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 +238,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 +258,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 +277,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 +296,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 +321,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 +333,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 +343,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 +363,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 +375,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 +394,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 +415,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 +445,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 +468,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 +483,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,15 +494,54 @@ 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/*}"
     };
     option (google.api.method_signature) = "name";
   }
+
+  // Returns details about a user's read state within a space, used to identify
+  // read and unread messages.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+  rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState) {
+    option (google.api.http) = {
+      get: "/v1/{name=users/*/spaces/*/spaceReadState}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a user's read state within a space, used to identify read and
+  // unread messages.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+  rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest)
+      returns (SpaceReadState) {
+    option (google.api.http) = {
+      patch: "/v1/{space_read_state.name=users/*/spaces/*/spaceReadState}"
+      body: "space_read_state"
+    };
+    option (google.api.method_signature) = "space_read_state,update_mask";
+  }
+
+  // Returns details about a user's read state within a thread, used to identify
+  // read and unread messages.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+  rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState) {
+    option (google.api.http) = {
+      get: "/v1/{name=users/*/spaces/*/threads/*/threadReadState}"
+    };
+    option (google.api.method_signature) = "name";
+  }
 }

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