googleapis
diff --git a/‎google/chat/v1/message.proto‎
Lines changed: 35 additions & 8 deletions b/‎google/chat/v1/message.proto‎
Lines changed: 35 additions & 8 deletions
diff --git a/‎google/chat/v1/space.proto‎
Lines changed: 2 additions & 2 deletions b/‎google/chat/v1/space.proto‎
Lines changed: 2 additions & 2 deletions
@@ -238,10 +238,19 @@ message Message {
   DeletionMetadata deletion_metadata = 38
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. Information about a message that's quoted by a Google Chat
-  // user in a space. Google Chat users can quote a message to reply to it.
+  // Optional. Information about a message that another message quotes.
+  //
+  // When you create a message, you can quote messages within the same
+  // thread, or quote a root message to create a new root message.
+  // However, you can't quote a message reply from a different thread.
+  //
+  // When you update a message, you can't add or replace the
+  // `quotedMessageMetadata` field, but you can remove it.
+  //
+  // For example usage, see [Quote another
+  // message](https://developers.google.com/workspace/chat/create-messages#quote-a-message).
   QuotedMessageMetadata quoted_message_metadata = 39
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+      [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. GIF images that are attached to the message.
   repeated AttachedGif attached_gifs = 42
@@ -266,25 +275,41 @@ message AttachedGif {
   string uri = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
-// Information about a quoted message.
+// Information about a message that another message quotes.
+//
+// When you create a message, you can quote messages within the same
+// thread, or quote a root message to create a new root message.
+// However, you can't quote a message reply from a different thread.
+//
+// When you update a message, you can't add or replace the
+// `quotedMessageMetadata` field, but you can remove it.
+//
+// For example usage, see [Quote another
+// message](https://developers.google.com/workspace/chat/create-messages#quote-a-message).
 message QuotedMessageMetadata {
   option (google.api.resource) = {
     type: "chat.googleapis.com/QuotedMessageMetadata"
     pattern: "spaces/{space}/messages/{message}/quotedMessageMetadata/{quoted_message_metadata}"
   };
 
-  // Output only. Resource name of the quoted message.
+  // Required. Resource name of the message that is quoted.
   //
   // Format: `spaces/{space}/messages/{message}`
   string name = 1 [
-    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "chat.googleapis.com/Message" }
   ];
 
-  // Output only. The timestamp when the quoted message was created or when the
+  // Required. The timestamp when the quoted message was created or when the
   // quoted message was last updated.
+  //
+  // If the message was edited, use this field, `last_update_time`.
+  // If the message was never edited, use `create_time`.
+  //
+  // If `last_update_time` doesn't match the latest version of the quoted
+  // message, the request fails.
   google.protobuf.Timestamp last_update_time = 2
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // A thread in a Google Chat space. For example usage, see
@@ -456,6 +481,8 @@ message UpdateMessageRequest {
   //
   // - `accessory_widgets`  (Requires [app
   // authentication](/chat/api/guides/auth/service-accounts).)
+  //
+  // - `quoted_message_metadata` (Only allows removal of the quoted message.)
   google.protobuf.FieldMask update_mask = 2
       [(google.api.field_behavior) = REQUIRED];
 
 
@@ -355,8 +355,8 @@ message Space {
   // and `SpaceType` is `SPACE`, otherwise should not be set.
   //
   // In the format `customers/{customer}`, where `customer` is the `id` from the
-  // [Admin SDK customer resource](
-  // https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers).
+  // [Admin SDK customer
+  // resource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers).
   // Private apps can also use the `customers/my_customer` alias to create
   // the space in the same Google Workspace organization as the app.
   //