fix!: Changed field behavior for an existing field name in message .google.chat.v1.QuotedMessageMetadata

Google APIs · copybara-github · commit 26dadebec424 · 2025-08-26T06:41:42.000-07:00
fix!: Changed field behavior for an existing field `last_update_time` in message `.google.chat.v1.QuotedMessageMetadata`
docs: A comment for field `quoted_message_metadata` in message `.google.chat.v1.Message` is changed
docs: A comment for message `QuotedMessageMetadata` is changed
docs: A comment for field `name` in message `.google.chat.v1.QuotedMessageMetadata` is changed
docs: A comment for field `last_update_time` in message `.google.chat.v1.QuotedMessageMetadata` is changed
docs: A comment for field `update_mask` in message `.google.chat.v1.UpdateMessageRequest` is changed
docs: A comment for field `customer` in message `.google.chat.v1.Space` is changed

PiperOrigin-RevId: 799541738
diff --git a/google/chat/v1/message.proto b/google/chat/v1/message.proto
@@ -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];
 
diff --git a/google/chat/v1/space.proto b/google/chat/v1/space.proto
@@ -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.
   //
