feat: Launch AccessoryAction for GA

Google APIs · copybara-github · commit e7b48a71aac7 · 2024-03-26T23:04:06.000-07:00
docs: updated comments

PiperOrigin-RevId: 619423474
diff --git a/google/chat/v1/message.proto b/google/chat/v1/message.proto
@@ -237,6 +237,71 @@ message Message {
   // Output only. GIF images that are attached to the message.
   repeated AttachedGif attached_gifs = 42
       [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // One or more interactive widgets that appear at the bottom of a message.
+  // You can add accessory widgets to messages that contain text, cards, or both
+  // text and cards. Not supported for messages that contain dialogs.
+  //
+  // Creating a message with accessory widgets requires [app
+  // authentication]
+  // (https://developers.google.com/chat/api/guides/auth/service-accounts).
+  //
+  // The following example shows a Chat app that uses accessory widgets (thumbs
+  // up and thumbs down buttons) in a text message:
+  //
+  // ![Example accessory widgets
+  // message](https://developers.google.com/chat/images/message-accessory-widgets-reference.png)
+  //
+  // The JSON for this example message is the following:
+  //
+  // ```
+  // {
+  //   "text": "Rate your experience with this Chat app.",
+  //   "accessoryWidgets": [
+  //     {
+  //       "buttonList": {
+  //         "buttons": [
+  //           {
+  //             "icon": {
+  //               "material_icon": {
+  //                 "name": "thumb_up"
+  //               }
+  //             },
+  //             "color": {
+  //               "red": 0,
+  //               "blue": 255,
+  //               "green": 0
+  //             },
+  //             "onClick": {
+  //               "action": {
+  //                 "function": "doUpvote",
+  //               }
+  //             }
+  //           },
+  //           {
+  //             "icon": {
+  //               "material_icon": {
+  //                 "name": "thumb_down"
+  //               }
+  //             },
+  //             "color": {
+  //               "red": 0,
+  //               "blue": 255,
+  //               "green": 0
+  //             },
+  //             "onClick": {
+  //               "action": {
+  //                 "function": "doDownvote",
+  //               }
+  //             }
+  //           }
+  //         ]
+  //       }
+  //     }
+  //   ]
+  // }
+  // ```
+  repeated AccessoryWidget accessory_widgets = 44;
 }
 
 // A GIF image that's specified by a URL.
@@ -360,6 +425,14 @@ message ActionResponse {
   UpdatedWidget updated_widget = 4 [(google.api.field_behavior) = INPUT_ONLY];
 }
 
+// A borderless widget attached to the bottom of an app's message.
+message AccessoryWidget {
+  oneof action {
+    // A list of buttons that are displayed under the message.
+    google.apps.card.v1.ButtonList button_list = 1;
+  }
+}
+
 message GetMessageRequest {
   // Required. Resource name of the message.
   //
@@ -418,7 +491,7 @@ message UpdateMessageRequest {
   // - `cards_v2`  (Requires [app
   // authentication](/chat/api/guides/auth/service-accounts).)
   //
-  // - Developer Preview: `accessory_widgets`  (Requires [app
+  // - `accessory_widgets`  (Requires [app
   // authentication](/chat/api/guides/auth/service-accounts).)
   google.protobuf.FieldMask update_mask = 2;
 
