google-apis-chat_v1 0.58.0 → 0.60.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -23,9 +23,9 @@ module Google
23
23
  module ChatV1
24
24
 
25
25
  # List of string parameters to supply when the action method is invoked. For
26
- # example, consider three snooze buttons: snooze now, snooze 1 day, snooze next
27
- # week. You might use action method = snooze(), passing the snooze type and
28
- # snooze time in the list of string parameters.
26
+ # example, consider three snooze buttons: snooze now, snooze one day, snooze
27
+ # next week. You might use `action method = snooze()`, passing the snooze type
28
+ # and snooze time in the list of string parameters.
29
29
  class ActionParameter
30
30
  include Google::Apis::Core::Hashable
31
31
 
@@ -65,8 +65,8 @@ module Google
65
65
  # @return [String]
66
66
  attr_accessor :type
67
67
 
68
- # Input only. URL for users to auth or config. (Only for REQUEST_CONFIG response
69
- # types.)
68
+ # Input only. URL for users to authenticate or configure. (Only for `
69
+ # REQUEST_CONFIG` response types.)
70
70
  # Corresponds to the JSON property `url`
71
71
  # @return [String]
72
72
  attr_accessor :url
@@ -164,7 +164,7 @@ module Google
164
164
  class Attachment
165
165
  include Google::Apis::Core::Hashable
166
166
 
167
- # A reference to the attachment data. This is used with the media API to
167
+ # A reference to the attachment data. This field is used with the media API to
168
168
  # download the attachment data.
169
169
  # Corresponds to the JSON property `attachmentDataRef`
170
170
  # @return [Google::Apis::ChatV1::AttachmentDataRef]
@@ -181,7 +181,7 @@ module Google
181
181
  attr_accessor :content_type
182
182
 
183
183
  # Output only. The download URL which should be used to allow a human user to
184
- # download the attachment. Chat apps should not use this URL to download
184
+ # download the attachment. Chat apps shouldn't use this URL to download
185
185
  # attachment content.
186
186
  # Corresponds to the JSON property `downloadUri`
187
187
  # @return [String]
@@ -192,8 +192,8 @@ module Google
192
192
  # @return [Google::Apis::ChatV1::DriveDataRef]
193
193
  attr_accessor :drive_data_ref
194
194
 
195
- # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*
196
- # ".
195
+ # Resource name of the attachment, in the form `spaces/*/messages/*/attachments/*
196
+ # `.
197
197
  # Corresponds to the JSON property `name`
198
198
  # @return [String]
199
199
  attr_accessor :name
@@ -204,7 +204,7 @@ module Google
204
204
  attr_accessor :source
205
205
 
206
206
  # Output only. The thumbnail URL which should be used to preview the attachment
207
- # to a human user. Chat apps should not use this URL to download attachment
207
+ # to a human user. Chat apps shouldn't use this URL to download attachment
208
208
  # content.
209
209
  # Corresponds to the JSON property `thumbnailUri`
210
210
  # @return [String]
@@ -231,8 +231,15 @@ module Google
231
231
  class AttachmentDataRef
232
232
  include Google::Apis::Core::Hashable
233
233
 
234
- # The resource name of the attachment data. This is used with the media API to
235
- # download the attachment data.
234
+ # Opaque token containing a reference to an uploaded attachment. Treated by
235
+ # clients as an opaque string and used to create or update Chat messages with
236
+ # attachments.
237
+ # Corresponds to the JSON property `attachmentUploadToken`
238
+ # @return [String]
239
+ attr_accessor :attachment_upload_token
240
+
241
+ # The resource name of the attachment data. This field is used with the media
242
+ # API to download the attachment data.
236
243
  # Corresponds to the JSON property `resourceName`
237
244
  # @return [String]
238
245
  attr_accessor :resource_name
@@ -243,6 +250,7 @@ module Google
243
250
 
244
251
  # Update properties of this object
245
252
  def update!(**args)
253
+ @attachment_upload_token = args[:attachment_upload_token] if args.key?(:attachment_upload_token)
246
254
  @resource_name = args[:resource_name] if args.key?(:resource_name)
247
255
  end
248
256
  end
@@ -251,12 +259,12 @@ module Google
251
259
  class Button
252
260
  include Google::Apis::Core::Hashable
253
261
 
254
- # An image button with an onclick action.
262
+ # An image button with an `onclick` action.
255
263
  # Corresponds to the JSON property `imageButton`
256
264
  # @return [Google::Apis::ChatV1::ImageButton]
257
265
  attr_accessor :image_button
258
266
 
259
- # A button with text and onclick action.
267
+ # A button with text and `onclick` action.
260
268
  # Corresponds to the JSON property `textButton`
261
269
  # @return [Google::Apis::ChatV1::TextButton]
262
270
  attr_accessor :text_button
@@ -272,7 +280,7 @@ module Google
272
280
  end
273
281
  end
274
282
 
275
- # A card is a UI element that can contain UI widgets such as texts, images.
283
+ # A card is a UI element that can contain UI widgets such as text and images.
276
284
  class Card
277
285
  include Google::Apis::Core::Hashable
278
286
 
@@ -320,7 +328,7 @@ module Google
320
328
  # @return [String]
321
329
  attr_accessor :action_label
322
330
 
323
- # An onclick action (e.g. open a link).
331
+ # An `onclick` action (for example, open a link).
324
332
  # Corresponds to the JSON property `onClick`
325
333
  # @return [Google::Apis::ChatV1::OnClick]
326
334
  attr_accessor :on_click
@@ -340,7 +348,7 @@ module Google
340
348
  class CardHeader
341
349
  include Google::Apis::Core::Hashable
342
350
 
343
- # The image's type (e.g. square border or circular border).
351
+ # The image's type (for example, square border or circular border).
344
352
  # Corresponds to the JSON property `imageStyle`
345
353
  # @return [String]
346
354
  attr_accessor :image_style
@@ -356,8 +364,8 @@ module Google
356
364
  attr_accessor :subtitle
357
365
 
358
366
  # The title must be specified. The header has a fixed height: if both a title
359
- # and subtitle is specified, each will take up 1 line. If only the title is
360
- # specified, it will take up both lines.
367
+ # and subtitle is specified, each takes up one line. If only the title is
368
+ # specified, it takes up both lines.
361
369
  # Corresponds to the JSON property `title`
362
370
  # @return [String]
363
371
  attr_accessor :title
@@ -386,22 +394,22 @@ module Google
386
394
  # text message, just beneath the text message. - As a [dialog](https://
387
395
  # developers.google.com/chat/how-tos/dialogs). The following example JSON
388
396
  # creates a "contact card" that features: - A header with the contact's name,
389
- # job title, avatar picture. - A section with the contact information, including
390
- # formatted text. - Buttons that users can click to share the contact or see
391
- # more or less info. ![Example contact card](https://developers.google.com/chat/
392
- # images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "unique-card-id",
393
- # "card": ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "
394
- # imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.
395
- # png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `, "sections":
396
- # [ ` "header": "Contact Info", "collapsible": true, "uncollapsibleWidgetsCount"
397
- # : 1, "widgets": [ ` "decoratedText": ` "startIcon": ` "knownIcon": "EMAIL", `,
398
- # "text": "sasha@example.com", ` `, ` "decoratedText": ` "startIcon": ` "
399
- # knownIcon": "PERSON", `, "text": "Online", `, `, ` "decoratedText": ` "
400
- # startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555) 555-1234", ` `, ` "
401
- # buttonList": ` "buttons": [ ` "text": "Share", "onClick": ` "openLink": ` "url"
402
- # : "https://example.com/share", ` ` `, ` "text": "Edit", "onClick": ` "action":
403
- # ` "function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT",
404
- # ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
397
+ # job title, and avatar picture. - A section with the contact information,
398
+ # including formatted text. - Buttons that users can click to share the contact,
399
+ # or see more or less information. ![Example contact card](https://developers.
400
+ # google.com/chat/images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "
401
+ # unique-card-id", "card": ` "header": ` "title": "Sasha", "subtitle": "Software
402
+ # Engineer", "imageUrl": "https://developers.google.com/chat/images/quickstart-
403
+ # app-avatar.png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `,
404
+ # "sections": [ ` "header": "Contact Info", "collapsible": true, "
405
+ # uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "startIcon": `
406
+ # "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "decoratedText":
407
+ # ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `, `, ` "
408
+ # decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555)
409
+ # 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "onClick": `
410
+ # "openLink": ` "url": "https://example.com/share", ` ` `, ` "text": "Edit", "
411
+ # onClick": ` "action": ` "function": "goToView", "parameters": [ ` "key": "
412
+ # viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
405
413
  # Corresponds to the JSON property `card`
406
414
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Card]
407
415
  attr_accessor :card
@@ -464,18 +472,18 @@ module Google
464
472
  end
465
473
 
466
474
  # Represents a color in the RGBA color space. This representation is designed
467
- # for simplicity of conversion to/from color representations in various
475
+ # for simplicity of conversion to and from color representations in various
468
476
  # languages over compactness. For example, the fields of this representation can
469
477
  # be trivially provided to the constructor of `java.awt.Color` in Java; it can
470
478
  # also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
471
479
  # method in iOS; and, with just a little work, it can be easily formatted into a
472
- # CSS `rgba()` string in JavaScript. This reference page doesn't carry
480
+ # CSS `rgba()` string in JavaScript. This reference page does not have
473
481
  # information about the absolute color space that should be used to interpret
474
- # the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default,
482
+ # the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default,
475
483
  # applications should assume the sRGB color space. When color equality needs to
476
484
  # be decided, implementations, unless documented otherwise, treat two colors as
477
- # equal if all their red, green, blue, and alpha values each differ by at most
478
- # 1e-5. Example (Java): import com.google.type.Color; // ... public static java.
485
+ # equal if all their red, green, blue, and alpha values each differ by at most `
486
+ # 1e-5`. Example (Java): import com.google.type.Color; // ... public static java.
479
487
  # awt.Color fromProto(Color protocolor) ` float alpha = protocolor.hasAlpha() ?
480
488
  # protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.
481
489
  # getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); ` public static
@@ -625,6 +633,25 @@ module Google
625
633
  end
626
634
  end
627
635
 
636
+ # Represents a custom emoji.
637
+ class CustomEmoji
638
+ include Google::Apis::Core::Hashable
639
+
640
+ # Unique key for the custom emoji resource.
641
+ # Corresponds to the JSON property `uid`
642
+ # @return [String]
643
+ attr_accessor :uid
644
+
645
+ def initialize(**args)
646
+ update!(**args)
647
+ end
648
+
649
+ # Update properties of this object
650
+ def update!(**args)
651
+ @uid = args[:uid] if args.key?(:uid)
652
+ end
653
+ end
654
+
628
655
  # Date input values.
629
656
  class DateInput
630
657
  include Google::Apis::Core::Hashable
@@ -677,12 +704,32 @@ module Google
677
704
  end
678
705
  end
679
706
 
707
+ # Information about a deleted message. A message is deleted when `delete_time`
708
+ # is set.
709
+ class DeletionMetadata
710
+ include Google::Apis::Core::Hashable
711
+
712
+ # Indicates who deleted the message.
713
+ # Corresponds to the JSON property `deletionType`
714
+ # @return [String]
715
+ attr_accessor :deletion_type
716
+
717
+ def initialize(**args)
718
+ update!(**args)
719
+ end
720
+
721
+ # Update properties of this object
722
+ def update!(**args)
723
+ @deletion_type = args[:deletion_type] if args.key?(:deletion_type)
724
+ end
725
+ end
726
+
680
727
  # Google Chat events.
681
728
  class DeprecatedEvent
682
729
  include Google::Apis::Core::Hashable
683
730
 
684
731
  # A form action describes the behavior when the form is submitted. For example,
685
- # an Apps Script can be invoked to handle the form.
732
+ # you can invoke Apps Script to handle the form.
686
733
  # Corresponds to the JSON property `action`
687
734
  # @return [Google::Apis::ChatV1::FormAction]
688
735
  attr_accessor :action
@@ -792,22 +839,22 @@ module Google
792
839
  # text message, just beneath the text message. - As a [dialog](https://
793
840
  # developers.google.com/chat/how-tos/dialogs). The following example JSON
794
841
  # creates a "contact card" that features: - A header with the contact's name,
795
- # job title, avatar picture. - A section with the contact information, including
796
- # formatted text. - Buttons that users can click to share the contact or see
797
- # more or less info. ![Example contact card](https://developers.google.com/chat/
798
- # images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "unique-card-id",
799
- # "card": ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "
800
- # imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.
801
- # png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `, "sections":
802
- # [ ` "header": "Contact Info", "collapsible": true, "uncollapsibleWidgetsCount"
803
- # : 1, "widgets": [ ` "decoratedText": ` "startIcon": ` "knownIcon": "EMAIL", `,
804
- # "text": "sasha@example.com", ` `, ` "decoratedText": ` "startIcon": ` "
805
- # knownIcon": "PERSON", `, "text": "Online", `, `, ` "decoratedText": ` "
806
- # startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555) 555-1234", ` `, ` "
807
- # buttonList": ` "buttons": [ ` "text": "Share", "onClick": ` "openLink": ` "url"
808
- # : "https://example.com/share", ` ` `, ` "text": "Edit", "onClick": ` "action":
809
- # ` "function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT",
810
- # ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
842
+ # job title, and avatar picture. - A section with the contact information,
843
+ # including formatted text. - Buttons that users can click to share the contact,
844
+ # or see more or less information. ![Example contact card](https://developers.
845
+ # google.com/chat/images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "
846
+ # unique-card-id", "card": ` "header": ` "title": "Sasha", "subtitle": "Software
847
+ # Engineer", "imageUrl": "https://developers.google.com/chat/images/quickstart-
848
+ # app-avatar.png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `,
849
+ # "sections": [ ` "header": "Contact Info", "collapsible": true, "
850
+ # uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "startIcon": `
851
+ # "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "decoratedText":
852
+ # ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `, `, ` "
853
+ # decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555)
854
+ # 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "onClick": `
855
+ # "openLink": ` "url": "https://example.com/share", ` ` `, ` "text": "Edit", "
856
+ # onClick": ` "action": ` "function": "goToView", "parameters": [ ` "key": "
857
+ # viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
811
858
  # Corresponds to the JSON property `body`
812
859
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Card]
813
860
  attr_accessor :body
@@ -853,7 +900,7 @@ module Google
853
900
  class DriveDataRef
854
901
  include Google::Apis::Core::Hashable
855
902
 
856
- # The id for the drive file, for use with the Drive API.
903
+ # The ID for the drive file. Use with the Drive API.
857
904
  # Corresponds to the JSON property `driveFileId`
858
905
  # @return [String]
859
906
  attr_accessor :drive_file_id
@@ -868,6 +915,56 @@ module Google
868
915
  end
869
916
  end
870
917
 
918
+ # An emoji that is used as a reaction to a message.
919
+ class Emoji
920
+ include Google::Apis::Core::Hashable
921
+
922
+ # Represents a custom emoji.
923
+ # Corresponds to the JSON property `customEmoji`
924
+ # @return [Google::Apis::ChatV1::CustomEmoji]
925
+ attr_accessor :custom_emoji
926
+
927
+ # A basic emoji represented by a unicode string.
928
+ # Corresponds to the JSON property `unicode`
929
+ # @return [String]
930
+ attr_accessor :unicode
931
+
932
+ def initialize(**args)
933
+ update!(**args)
934
+ end
935
+
936
+ # Update properties of this object
937
+ def update!(**args)
938
+ @custom_emoji = args[:custom_emoji] if args.key?(:custom_emoji)
939
+ @unicode = args[:unicode] if args.key?(:unicode)
940
+ end
941
+ end
942
+
943
+ # The number of people who reacted to a message with a specific emoji.
944
+ class EmojiReactionSummary
945
+ include Google::Apis::Core::Hashable
946
+
947
+ # An emoji that is used as a reaction to a message.
948
+ # Corresponds to the JSON property `emoji`
949
+ # @return [Google::Apis::ChatV1::Emoji]
950
+ attr_accessor :emoji
951
+
952
+ # The total number of reactions using the associated emoji.
953
+ # Corresponds to the JSON property `reactionCount`
954
+ # @return [Fixnum]
955
+ attr_accessor :reaction_count
956
+
957
+ def initialize(**args)
958
+ update!(**args)
959
+ end
960
+
961
+ # Update properties of this object
962
+ def update!(**args)
963
+ @emoji = args[:emoji] if args.key?(:emoji)
964
+ @reaction_count = args[:reaction_count] if args.key?(:reaction_count)
965
+ end
966
+ end
967
+
871
968
  # A generic empty message that you can re-use to avoid defining duplicated empty
872
969
  # messages in your APIs. A typical example is to use it as the request or the
873
970
  # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -885,14 +982,14 @@ module Google
885
982
  end
886
983
 
887
984
  # A form action describes the behavior when the form is submitted. For example,
888
- # an Apps Script can be invoked to handle the form.
985
+ # you can invoke Apps Script to handle the form.
889
986
  class FormAction
890
987
  include Google::Apis::Core::Hashable
891
988
 
892
989
  # The method name is used to identify which part of the form triggered the form
893
990
  # submission. This information is echoed back to the Chat app as part of the
894
- # card click event. The same method name can be used for several elements that
895
- # trigger a common behavior if desired.
991
+ # card click event. You can use the same method name for several elements that
992
+ # trigger a common behavior.
896
993
  # Corresponds to the JSON property `actionMethodName`
897
994
  # @return [String]
898
995
  attr_accessor :action_method_name
@@ -914,8 +1011,8 @@ module Google
914
1011
  end
915
1012
 
916
1013
  # An action that describes the behavior when the form is submitted. For example,
917
- # an Apps Script can be invoked to handle the form. If the action is triggered,
918
- # the form values are sent to the server.
1014
+ # you can invoke an Apps Script script to handle the form. If the action is
1015
+ # triggered, the form values are sent to the server.
919
1016
  class GoogleAppsCardV1Action
920
1017
  include Google::Apis::Core::Hashable
921
1018
 
@@ -928,12 +1025,12 @@ module Google
928
1025
 
929
1026
  # Optional. Required when opening a [dialog](https://developers.google.com/chat/
930
1027
  # how-tos/dialogs). What to do in response to an interaction with a user, such
931
- # as a user clicking button on a card message. If unspecified, the app responds
932
- # by executing an `action` - like opening a link or running a function - as
1028
+ # as a user clicking a button in a card message. If unspecified, the app
1029
+ # responds by executing an `action`—like opening a link or running a functionas
933
1030
  # normal. By specifying an `interaction`, the app can respond in special
934
1031
  # interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the
935
1032
  # app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs).
936
- # When specified, a loading indicator is not shown. Supported by Chat apps, but
1033
+ # When specified, a loading indicator isn't shown. Supported by Chat apps, but
937
1034
  # not Google Workspace Add-ons. If specified for an add-on, the entire card is
938
1035
  # stripped and nothing is shown in the client.
939
1036
  # Corresponds to the JSON property `interaction`
@@ -953,18 +1050,18 @@ module Google
953
1050
 
954
1051
  # Indicates whether form values persist after the action. The default value is `
955
1052
  # false`. If `true`, form values remain after the action is triggered. To let
956
- # the user make changes while the action is being processed, set [LoadIndicator](
957
- # https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.
958
- # v1#loadindicator) to `NONE`. For [card messages](https://developers.google.com/
959
- # chat/api/guides/message-formats/cards) in Chat apps, you must also set the
960
- # action's [ResponseType](https://developers.google.com/chat/api/reference/rest/
961
- # v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same [`
962
- # card_id`](https://developers.google.com/chat/api/reference/rest/v1/spaces.
963
- # messages#CardWithId) from the card that contained the action. If `false`, the
964
- # form values are cleared when the action is triggered. To prevent the user from
965
- # making changes while the action is being processed, set [LoadIndicator](https:/
966
- # /developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#
967
- # loadindicator) to `SPINNER`.
1053
+ # the user make changes while the action is being processed, set [`LoadIndicator`
1054
+ # ](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.
1055
+ # card.v1#loadindicator) to `NONE`. For [card messages](https://developers.
1056
+ # google.com/chat/api/guides/message-formats/cards) in Chat apps, you must also
1057
+ # set the action's [`ResponseType`](https://developers.google.com/chat/api/
1058
+ # reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use
1059
+ # the same [`card_id`](https://developers.google.com/chat/api/reference/rest/v1/
1060
+ # spaces.messages#CardWithId) from the card that contained the action. If `false`
1061
+ # , the form values are cleared when the action is triggered. To prevent the
1062
+ # user from making changes while the action is being processed, set [`
1063
+ # LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/
1064
+ # google.apps.card.v1#loadindicator) to `SPINNER`.
968
1065
  # Corresponds to the JSON property `persistValues`
969
1066
  # @return [Boolean]
970
1067
  attr_accessor :persist_values
@@ -985,10 +1082,10 @@ module Google
985
1082
  end
986
1083
 
987
1084
  # List of string parameters to supply when the action method is invoked. For
988
- # example, consider three snooze buttons: snooze now, snooze 1 day, snooze next
989
- # week. You might use action method = snooze(), passing the snooze type and
990
- # snooze time in the list of string parameters. To learn more, see [
991
- # CommonEventObject](https://developers.google.com/chat/api/reference/rest/v1/
1085
+ # example, consider three snooze buttons: snooze now, snooze one day, or snooze
1086
+ # next week. You might use `action method = snooze()`, passing the snooze type
1087
+ # and snooze time in the list of string parameters. To learn more, see [`
1088
+ # CommonEventObject`](https://developers.google.com/chat/api/reference/rest/v1/
992
1089
  # Event#commoneventobject).
993
1090
  class GoogleAppsCardV1ActionParameter
994
1091
  include Google::Apis::Core::Hashable
@@ -1025,18 +1122,18 @@ module Google
1025
1122
  attr_accessor :corner_radius
1026
1123
 
1027
1124
  # Represents a color in the RGBA color space. This representation is designed
1028
- # for simplicity of conversion to/from color representations in various
1125
+ # for simplicity of conversion to and from color representations in various
1029
1126
  # languages over compactness. For example, the fields of this representation can
1030
1127
  # be trivially provided to the constructor of `java.awt.Color` in Java; it can
1031
1128
  # also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
1032
1129
  # method in iOS; and, with just a little work, it can be easily formatted into a
1033
- # CSS `rgba()` string in JavaScript. This reference page doesn't carry
1130
+ # CSS `rgba()` string in JavaScript. This reference page does not have
1034
1131
  # information about the absolute color space that should be used to interpret
1035
- # the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default,
1132
+ # the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default,
1036
1133
  # applications should assume the sRGB color space. When color equality needs to
1037
1134
  # be decided, implementations, unless documented otherwise, treat two colors as
1038
- # equal if all their red, green, blue, and alpha values each differ by at most
1039
- # 1e-5. Example (Java): import com.google.type.Color; // ... public static java.
1135
+ # equal if all their red, green, blue, and alpha values each differ by at most `
1136
+ # 1e-5`. Example (Java): import com.google.type.Color; // ... public static java.
1040
1137
  # awt.Color fromProto(Color protocolor) ` float alpha = protocolor.hasAlpha() ?
1041
1138
  # protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.
1042
1139
  # getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); ` public static
@@ -1090,33 +1187,33 @@ module Google
1090
1187
  end
1091
1188
  end
1092
1189
 
1093
- # A text, icon, or text + icon button that users can click. To make an image a
1094
- # clickable button, specify an Image (not an ImageComponent) and set an `onClick`
1095
- # action.
1190
+ # A text, icon, or text and icon button that users can click. To make an image a
1191
+ # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1192
+ # onClick` action.
1096
1193
  class GoogleAppsCardV1Button
1097
1194
  include Google::Apis::Core::Hashable
1098
1195
 
1099
- # The alternative text used for accessibility. Set descriptive text that lets
1100
- # users know what the button does. For example, if a button opens a hyperlink,
1101
- # you might write: "Opens a new browser tab and navigates to the Google Chat
1102
- # developer documentation at https://developers.google.com/chat".
1196
+ # The alternative text that's used for accessibility. Set descriptive text that
1197
+ # lets users know what the button does. For example, if a button opens a
1198
+ # hyperlink, you might write: "Opens a new browser tab and navigates to the
1199
+ # Google Chat developer documentation at https://developers.google.com/chat".
1103
1200
  # Corresponds to the JSON property `altText`
1104
1201
  # @return [String]
1105
1202
  attr_accessor :alt_text
1106
1203
 
1107
1204
  # Represents a color in the RGBA color space. This representation is designed
1108
- # for simplicity of conversion to/from color representations in various
1205
+ # for simplicity of conversion to and from color representations in various
1109
1206
  # languages over compactness. For example, the fields of this representation can
1110
1207
  # be trivially provided to the constructor of `java.awt.Color` in Java; it can
1111
1208
  # also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
1112
1209
  # method in iOS; and, with just a little work, it can be easily formatted into a
1113
- # CSS `rgba()` string in JavaScript. This reference page doesn't carry
1210
+ # CSS `rgba()` string in JavaScript. This reference page does not have
1114
1211
  # information about the absolute color space that should be used to interpret
1115
- # the RGB value (e.g. sRGB, Adobe RGB, DCI-P3, BT.2020, etc.). By default,
1212
+ # the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default,
1116
1213
  # applications should assume the sRGB color space. When color equality needs to
1117
1214
  # be decided, implementations, unless documented otherwise, treat two colors as
1118
- # equal if all their red, green, blue, and alpha values each differ by at most
1119
- # 1e-5. Example (Java): import com.google.type.Color; // ... public static java.
1215
+ # equal if all their red, green, blue, and alpha values each differ by at most `
1216
+ # 1e-5`. Example (Java): import com.google.type.Color; // ... public static java.
1120
1217
  # awt.Color fromProto(Color protocolor) ` float alpha = protocolor.hasAlpha() ?
1121
1218
  # protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.
1122
1219
  # getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); ` public static
@@ -1220,29 +1317,29 @@ module Google
1220
1317
  # text message, just beneath the text message. - As a [dialog](https://
1221
1318
  # developers.google.com/chat/how-tos/dialogs). The following example JSON
1222
1319
  # creates a "contact card" that features: - A header with the contact's name,
1223
- # job title, avatar picture. - A section with the contact information, including
1224
- # formatted text. - Buttons that users can click to share the contact or see
1225
- # more or less info. ![Example contact card](https://developers.google.com/chat/
1226
- # images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "unique-card-id",
1227
- # "card": ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "
1228
- # imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.
1229
- # png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `, "sections":
1230
- # [ ` "header": "Contact Info", "collapsible": true, "uncollapsibleWidgetsCount"
1231
- # : 1, "widgets": [ ` "decoratedText": ` "startIcon": ` "knownIcon": "EMAIL", `,
1232
- # "text": "sasha@example.com", ` `, ` "decoratedText": ` "startIcon": ` "
1233
- # knownIcon": "PERSON", `, "text": "Online", `, `, ` "decoratedText": ` "
1234
- # startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555) 555-1234", ` `, ` "
1235
- # buttonList": ` "buttons": [ ` "text": "Share", "onClick": ` "openLink": ` "url"
1236
- # : "https://example.com/share", ` ` `, ` "text": "Edit", "onClick": ` "action":
1237
- # ` "function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT",
1238
- # ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
1320
+ # job title, and avatar picture. - A section with the contact information,
1321
+ # including formatted text. - Buttons that users can click to share the contact,
1322
+ # or see more or less information. ![Example contact card](https://developers.
1323
+ # google.com/chat/images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "
1324
+ # unique-card-id", "card": ` "header": ` "title": "Sasha", "subtitle": "Software
1325
+ # Engineer", "imageUrl": "https://developers.google.com/chat/images/quickstart-
1326
+ # app-avatar.png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `,
1327
+ # "sections": [ ` "header": "Contact Info", "collapsible": true, "
1328
+ # uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "startIcon": `
1329
+ # "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "decoratedText":
1330
+ # ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `, `, ` "
1331
+ # decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555)
1332
+ # 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "onClick": `
1333
+ # "openLink": ` "url": "https://example.com/share", ` ` `, ` "text": "Edit", "
1334
+ # onClick": ` "action": ` "function": "goToView", "parameters": [ ` "key": "
1335
+ # viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
1239
1336
  class GoogleAppsCardV1Card
1240
1337
  include Google::Apis::Core::Hashable
1241
1338
 
1242
1339
  # The card's actions. Actions are added to the card's toolbar menu. Because Chat
1243
- # app cards have no toolbar, `cardActions[]` is not supported by Chat apps. For
1244
- # example, the following JSON constructs a card action menu with Settings and
1245
- # Send Feedback options: ``` "card_actions": [ ` "actionLabel": "Settings", "
1340
+ # app cards have no toolbar, `cardActions[]` isn't supported by Chat apps. For
1341
+ # example, the following JSON constructs a card action menu with `Settings` and `
1342
+ # Send Feedback` options: ``` "card_actions": [ ` "actionLabel": "Settings", "
1246
1343
  # onClick": ` "action": ` "functionName": "goToView", "parameters": [ ` "key": "
1247
1344
  # viewType", "value": "SETTING" ` ], "loadIndicator": "LoadIndicator.SPINNER" ` `
1248
1345
  # `, ` "actionLabel": "Send Feedback", "onClick": ` "openLink": ` "url": "https:
@@ -1342,20 +1439,26 @@ module Google
1342
1439
  class GoogleAppsCardV1CardFixedFooter
1343
1440
  include Google::Apis::Core::Hashable
1344
1441
 
1345
- # A text, icon, or text + icon button that users can click. To make an image a
1346
- # clickable button, specify an Image (not an ImageComponent) and set an `onClick`
1347
- # action.
1442
+ # A text, icon, or text and icon button that users can click. To make an image a
1443
+ # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1444
+ # onClick` action.
1348
1445
  # Corresponds to the JSON property `primaryButton`
1349
1446
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
1350
1447
  attr_accessor :primary_button
1351
1448
 
1352
- # A text, icon, or text + icon button that users can click. To make an image a
1353
- # clickable button, specify an Image (not an ImageComponent) and set an `onClick`
1354
- # action.
1449
+ # A text, icon, or text and icon button that users can click. To make an image a
1450
+ # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1451
+ # onClick` action.
1355
1452
  # Corresponds to the JSON property `secondaryButton`
1356
1453
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
1357
1454
  attr_accessor :secondary_button
1358
1455
 
1456
+ # A list of widgets included in the card footer. Primary button and secondary
1457
+ # button are rendered below these widgets.
1458
+ # Corresponds to the JSON property `widgets`
1459
+ # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1FooterWidget>]
1460
+ attr_accessor :widgets
1461
+
1359
1462
  def initialize(**args)
1360
1463
  update!(**args)
1361
1464
  end
@@ -1364,6 +1467,7 @@ module Google
1364
1467
  def update!(**args)
1365
1468
  @primary_button = args[:primary_button] if args.key?(:primary_button)
1366
1469
  @secondary_button = args[:secondary_button] if args.key?(:secondary_button)
1470
+ @widgets = args[:widgets] if args.key?(:widgets)
1367
1471
  end
1368
1472
  end
1369
1473
 
@@ -1371,7 +1475,7 @@ module Google
1371
1475
  class GoogleAppsCardV1CardHeader
1372
1476
  include Google::Apis::Core::Hashable
1373
1477
 
1374
- # The alternative text of this image which is used for accessibility.
1478
+ # The alternative text of this image that's used for accessibility.
1375
1479
  # Corresponds to the JSON property `imageAltText`
1376
1480
  # @return [String]
1377
1481
  attr_accessor :image_alt_text
@@ -1413,54 +1517,125 @@ module Google
1413
1517
  end
1414
1518
  end
1415
1519
 
1416
- # Lets users specify a date, a time, or both a date and a time. Accepts text
1417
- # input from users, but features an interactive date and time selector that
1418
- # helps users enter correctly-formatted dates and times. If users enter a date
1419
- # or time incorrectly, the widget shows an error that prompts users to enter the
1420
- # correct format. Not supported by Chat apps. Support by Chat apps coming soon.
1520
+ # A column.
1521
+ class GoogleAppsCardV1Column
1522
+ include Google::Apis::Core::Hashable
1523
+
1524
+ # Specifies whether widgets align to the left, right, or center of a column.
1525
+ # Corresponds to the JSON property `horizontalAlignment`
1526
+ # @return [String]
1527
+ attr_accessor :horizontal_alignment
1528
+
1529
+ # Specifies how a column fills the width of the card.
1530
+ # Corresponds to the JSON property `horizontalSizeStyle`
1531
+ # @return [String]
1532
+ attr_accessor :horizontal_size_style
1533
+
1534
+ # Specifies whether widgets align to the top, bottom, or center of a column.
1535
+ # Corresponds to the JSON property `verticalAlignment`
1536
+ # @return [String]
1537
+ attr_accessor :vertical_alignment
1538
+
1539
+ # An array of widgets included in a column. Widgets appear in the order that
1540
+ # they are specified.
1541
+ # Corresponds to the JSON property `widgets`
1542
+ # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Widgets>]
1543
+ attr_accessor :widgets
1544
+
1545
+ def initialize(**args)
1546
+ update!(**args)
1547
+ end
1548
+
1549
+ # Update properties of this object
1550
+ def update!(**args)
1551
+ @horizontal_alignment = args[:horizontal_alignment] if args.key?(:horizontal_alignment)
1552
+ @horizontal_size_style = args[:horizontal_size_style] if args.key?(:horizontal_size_style)
1553
+ @vertical_alignment = args[:vertical_alignment] if args.key?(:vertical_alignment)
1554
+ @widgets = args[:widgets] if args.key?(:widgets)
1555
+ end
1556
+ end
1557
+
1558
+ # The `Columns` widget displays up to 2 columns in a card message or dialog. You
1559
+ # can add widgets to each column; the widgets appear in the order that they are
1560
+ # specified. The height of each column is determined by the taller column. For
1561
+ # example, if the first column is taller than the second column, both columns
1562
+ # have the height of the first column. Because each column can contain a
1563
+ # different number of widgets, you can't define rows or align widgets between
1564
+ # the columns. Columns are displayed side-by-side. You can customize the width
1565
+ # of each column using the `HorizontalSizeStyle` field. If the user's screen
1566
+ # width is too narrow, the second column wraps below the first: * On web, the
1567
+ # second column wraps if the screen width is less than or equal to 480 pixels. *
1568
+ # On iOS devices, the second column wraps if the screen width is less than or
1569
+ # equal to 300 pt. * On Android devices, the second column wraps if the screen
1570
+ # width is less than or equal to 320 dp. To include more than 2 columns, or to
1571
+ # use rows, use the `Grid` widget. Supported by Chat apps, but not Google
1572
+ # Workspace Add-ons.
1573
+ class GoogleAppsCardV1Columns
1574
+ include Google::Apis::Core::Hashable
1575
+
1576
+ # An array of columns. You can include up to 2 columns in a card or dialog.
1577
+ # Corresponds to the JSON property `columnItems`
1578
+ # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Column>]
1579
+ attr_accessor :column_items
1580
+
1581
+ def initialize(**args)
1582
+ update!(**args)
1583
+ end
1584
+
1585
+ # Update properties of this object
1586
+ def update!(**args)
1587
+ @column_items = args[:column_items] if args.key?(:column_items)
1588
+ end
1589
+ end
1590
+
1591
+ # Lets users input a date, a time, or both a date and a time. Users can input
1592
+ # text or use the picker to select dates and times. If users input an invalid
1593
+ # date or time, the picker shows an error that prompts users to input the
1594
+ # information correctly.
1421
1595
  class GoogleAppsCardV1DateTimePicker
1422
1596
  include Google::Apis::Core::Hashable
1423
1597
 
1424
- # The text that prompts users to enter a date, time, or datetime. Specify text
1425
- # that helps the user enter the information your app needs. For example, if
1426
- # users are setting an appointment, then a label like "Appointment date" or "
1427
- # Appointment date and time" might work well.
1598
+ # The text that prompts users to input a date, a time, or a date and time. For
1599
+ # example, if users are scheduling an appointment, use a label such as `
1600
+ # Appointment date` or `Appointment date and time`.
1428
1601
  # Corresponds to the JSON property `label`
1429
1602
  # @return [String]
1430
1603
  attr_accessor :label
1431
1604
 
1432
- # The name by which the datetime picker is identified in a form input event. For
1433
- # details about working with form inputs, see [Receive form data](https://
1605
+ # The name by which the `DateTimePicker` is identified in a form input event.
1606
+ # For details about working with form inputs, see [Receive form data](https://
1434
1607
  # developers.google.com/chat/how-tos/dialogs#receive_form_data_from_dialogs).
1435
1608
  # Corresponds to the JSON property `name`
1436
1609
  # @return [String]
1437
1610
  attr_accessor :name
1438
1611
 
1439
1612
  # An action that describes the behavior when the form is submitted. For example,
1440
- # an Apps Script can be invoked to handle the form. If the action is triggered,
1441
- # the form values are sent to the server.
1613
+ # you can invoke an Apps Script script to handle the form. If the action is
1614
+ # triggered, the form values are sent to the server.
1442
1615
  # Corresponds to the JSON property `onChangeAction`
1443
1616
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
1444
1617
  attr_accessor :on_change_action
1445
1618
 
1446
1619
  # The number representing the time zone offset from UTC, in minutes. If set, the
1447
- # `value_ms_epoch` is displayed in the specified time zone. If not set, it uses
1448
- # the user's time zone setting on the client side.
1620
+ # `value_ms_epoch` is displayed in the specified time zone. If unset, the value
1621
+ # defaults to the user's time zone setting.
1449
1622
  # Corresponds to the JSON property `timezoneOffsetDate`
1450
1623
  # @return [Fixnum]
1451
1624
  attr_accessor :timezone_offset_date
1452
1625
 
1453
- # What kind of date and time input the datetime picker supports.
1626
+ # Whether the widget supports inputting a date, a time, or the date and time.
1454
1627
  # Corresponds to the JSON property `type`
1455
1628
  # @return [String]
1456
1629
  attr_accessor :type
1457
1630
 
1458
- # The value displayed as the default value before user input or previous user
1459
- # input, represented in milliseconds ([Epoch time](https://en.wikipedia.org/wiki/
1460
- # Unix_time)). For `DATE_AND_TIME` type, the full epoch value is used. For `
1461
- # DATE_ONLY` type, only date of the epoch time is used. For `TIME_ONLY` type,
1462
- # only time of the epoch time is used. For example, to represent 3:00 AM, set
1463
- # epoch time to `3 * 60 * 60 * 1000`.
1631
+ # The default value displayed in the widget, in milliseconds since [Unix epoch
1632
+ # time](https://en.wikipedia.org/wiki/Unix_time). Specify the value based on the
1633
+ # type of picker (`DateTimePickerType`): * `DATE_AND_TIME`: a calendar date and
1634
+ # time in UTC. For example, to represent January 1, 2023 at 12:00 PM UTC, use `
1635
+ # 1672574400000`. * `DATE_ONLY`: a calendar date at 00:00:00 UTC. For example,
1636
+ # to represent January 1, 2023, use `1672531200000`. * `TIME_ONLY`: a time in
1637
+ # UTC. For example, to represent 12:00 PM, use `43200000` (or `12 * 60 * 60 *
1638
+ # 1000`).
1464
1639
  # Corresponds to the JSON property `valueMsEpoch`
1465
1640
  # @return [Fixnum]
1466
1641
  attr_accessor :value_ms_epoch
@@ -1481,19 +1656,19 @@ module Google
1481
1656
  end
1482
1657
 
1483
1658
  # A widget that displays text with optional decorations such as a label above or
1484
- # below the text, an icon in front of the text, a selection widget or a button
1659
+ # below the text, an icon in front of the text, a selection widget, or a button
1485
1660
  # after the text.
1486
1661
  class GoogleAppsCardV1DecoratedText
1487
1662
  include Google::Apis::Core::Hashable
1488
1663
 
1489
- # The text that appears below `text`. Always truncates.
1664
+ # The text that appears below `text`. Always wraps.
1490
1665
  # Corresponds to the JSON property `bottomLabel`
1491
1666
  # @return [String]
1492
1667
  attr_accessor :bottom_label
1493
1668
 
1494
- # A text, icon, or text + icon button that users can click. To make an image a
1495
- # clickable button, specify an Image (not an ImageComponent) and set an `onClick`
1496
- # action.
1669
+ # A text, icon, or text and icon button that users can click. To make an image a
1670
+ # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1671
+ # onClick` action.
1497
1672
  # Corresponds to the JSON property `button`
1498
1673
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
1499
1674
  attr_accessor :button
@@ -1529,14 +1704,16 @@ module Google
1529
1704
  attr_accessor :start_icon
1530
1705
 
1531
1706
  # Either a toggle-style switch or a checkbox inside a `decoratedText` widget.
1532
- # Only supported on the `decoratedText` widget.
1707
+ # Only supported in the `decoratedText` widget.
1533
1708
  # Corresponds to the JSON property `switchControl`
1534
1709
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1SwitchControl]
1535
1710
  attr_accessor :switch_control
1536
1711
 
1537
1712
  # Required. The primary text. Supports simple formatting. For more information
1538
- # about formatting text, see Formatting text in Google Chat apps and Formatting
1539
- # text in Google Workspace Add-ons.
1713
+ # about formatting text, see [Formatting text in Google Chat apps](https://
1714
+ # developers.google.com/chat/api/guides/message-formats/cards#
1715
+ # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
1716
+ # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
1540
1717
  # Corresponds to the JSON property `text`
1541
1718
  # @return [String]
1542
1719
  attr_accessor :text
@@ -1573,7 +1750,7 @@ module Google
1573
1750
  end
1574
1751
  end
1575
1752
 
1576
- # Displays a divider between widgets, a horizontal line. For example, the
1753
+ # Displays a divider between widgets as a horizontal line. For example, the
1577
1754
  # following JSON creates a divider: ``` "divider": `` ```
1578
1755
  class GoogleAppsCardV1Divider
1579
1756
  include Google::Apis::Core::Hashable
@@ -1587,16 +1764,75 @@ module Google
1587
1764
  end
1588
1765
  end
1589
1766
 
1590
- # Displays a grid with a collection of items. A grid supports any number of
1591
- # columns and items. The number of rows is determined by items divided by
1592
- # columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items
1593
- # and 2 columns has 6 rows. For example, the following JSON creates a 2 column
1594
- # grid with a single item: ``` "grid": ` "title": "A fine collection of items", "
1595
- # columnCount": 2, "borderStyle": ` "type": "STROKE", "cornerRadius": 4 `, "
1596
- # items": [ ` "image": ` "imageUri": "https://www.example.com/image.png", "
1597
- # cropStyle": ` "type": "SQUARE" `, "borderStyle": ` "type": "STROKE" ` `, "
1598
- # title": "An item", "textAlignment": "CENTER" ` ], "onClick": ` "openLink": ` "
1599
- # url": "https://www.example.com" ` ` ` ```
1767
+ # The CardFixedFooter can contain a list of these widgets.
1768
+ class GoogleAppsCardV1FooterWidget
1769
+ include Google::Apis::Core::Hashable
1770
+
1771
+ # A list of buttons layed out horizontally.
1772
+ # Corresponds to the JSON property `buttonList`
1773
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
1774
+ attr_accessor :button_list
1775
+
1776
+ # Lets users input a date, a time, or both a date and a time. Users can input
1777
+ # text or use the picker to select dates and times. If users input an invalid
1778
+ # date or time, the picker shows an error that prompts users to input the
1779
+ # information correctly.
1780
+ # Corresponds to the JSON property `dateTimePicker`
1781
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
1782
+ attr_accessor :date_time_picker
1783
+
1784
+ # A widget that displays text with optional decorations such as a label above or
1785
+ # below the text, an icon in front of the text, a selection widget, or a button
1786
+ # after the text.
1787
+ # Corresponds to the JSON property `decoratedText`
1788
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
1789
+ attr_accessor :decorated_text
1790
+
1791
+ # A field in which users can enter text. Supports suggestions and on-change
1792
+ # actions. Chat apps receive and can process the value of entered text during
1793
+ # form input events. For details about working with form inputs, see [Receive
1794
+ # form data](https://developers.google.com/chat/how-tos/dialogs#
1795
+ # receive_form_data_from_dialogs). When you need to collect undefined or
1796
+ # abstract data from users, use a text input. To collect defined or enumerated
1797
+ # data from users, use the SelectionInput widget.
1798
+ # Corresponds to the JSON property `textInput`
1799
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
1800
+ attr_accessor :text_input
1801
+
1802
+ # A paragraph of text that supports formatting. For more information about
1803
+ # formatting text, see [Formatting text in Google Chat apps](https://developers.
1804
+ # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
1805
+ # Formatting text in Google Workspace Add-ons](https://developers.google.com/
1806
+ # apps-script/add-ons/concepts/widgets#text_formatting).
1807
+ # Corresponds to the JSON property `textParagraph`
1808
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
1809
+ attr_accessor :text_paragraph
1810
+
1811
+ def initialize(**args)
1812
+ update!(**args)
1813
+ end
1814
+
1815
+ # Update properties of this object
1816
+ def update!(**args)
1817
+ @button_list = args[:button_list] if args.key?(:button_list)
1818
+ @date_time_picker = args[:date_time_picker] if args.key?(:date_time_picker)
1819
+ @decorated_text = args[:decorated_text] if args.key?(:decorated_text)
1820
+ @text_input = args[:text_input] if args.key?(:text_input)
1821
+ @text_paragraph = args[:text_paragraph] if args.key?(:text_paragraph)
1822
+ end
1823
+ end
1824
+
1825
+ # Displays a grid with a collection of items. Items can only include text or
1826
+ # images. A grid supports any number of columns and items. The number of rows is
1827
+ # determined by items divided by columns. A grid with 10 items and 2 columns has
1828
+ # 5 rows. A grid with 11 items and 2 columns has 6 rows. For responsive columns,
1829
+ # or to include more than text or images, use `Columns`. For example, the
1830
+ # following JSON creates a 2 column grid with a single item: ``` "grid": ` "
1831
+ # title": "A fine collection of items", "columnCount": 2, "borderStyle": ` "type"
1832
+ # : "STROKE", "cornerRadius": 4 `, "items": [ ` "image": ` "imageUri": "https://
1833
+ # www.example.com/image.png", "cropStyle": ` "type": "SQUARE" `, "borderStyle": `
1834
+ # "type": "STROKE" ` `, "title": "An item", "textAlignment": "CENTER" ` ], "
1835
+ # onClick": ` "openLink": ` "url": "https://www.example.com" ` ` ` ```
1600
1836
  class GoogleAppsCardV1Grid
1601
1837
  include Google::Apis::Core::Hashable
1602
1838
 
@@ -1643,12 +1879,13 @@ module Google
1643
1879
  end
1644
1880
  end
1645
1881
 
1646
- # Represents a single item in the grid layout.
1882
+ # Represents an item in a grid layout. Items can contain text, an image, or both
1883
+ # text and an image.
1647
1884
  class GoogleAppsCardV1GridItem
1648
1885
  include Google::Apis::Core::Hashable
1649
1886
 
1650
1887
  # A user-specified identifier for this grid item. This identifier is returned in
1651
- # the parent Grid's onClick callback parameters.
1888
+ # the parent grid's `onClick` callback parameters.
1652
1889
  # Corresponds to the JSON property `id`
1653
1890
  # @return [String]
1654
1891
  attr_accessor :id
@@ -1695,11 +1932,11 @@ module Google
1695
1932
  include Google::Apis::Core::Hashable
1696
1933
 
1697
1934
  # Optional. A description of the icon used for accessibility. If unspecified,
1698
- # the default value "Button" is provided. As a best practice, you should set a
1935
+ # the default value `Button` is provided. As a best practice, you should set a
1699
1936
  # helpful description for what the icon displays, and if applicable, what it
1700
1937
  # does. For example, `A user's account portrait`, or `Opens a new browser tab
1701
1938
  # and navigates to the Google Chat developer documentation at https://developers.
1702
- # google.com/chat`. If the icon is set in a Button, the `altText` appears as
1939
+ # google.com/chat`. If the icon is set in a `Button`, the `altText` appears as
1703
1940
  # helper text when the user hovers over the button. However, if the button also
1704
1941
  # sets `text`, the icon's `altText` is ignored.
1705
1942
  # Corresponds to the JSON property `altText`
@@ -1744,13 +1981,13 @@ module Google
1744
1981
  class GoogleAppsCardV1Image
1745
1982
  include Google::Apis::Core::Hashable
1746
1983
 
1747
- # The alternative text of this image, used for accessibility.
1984
+ # The alternative text of this image that's used for accessibility.
1748
1985
  # Corresponds to the JSON property `altText`
1749
1986
  # @return [String]
1750
1987
  attr_accessor :alt_text
1751
1988
 
1752
- # The `https` URL that hosts the image. For example: ``` https://developers.
1753
- # google.com/chat/images/quickstart-app-avatar.png ```
1989
+ # The HTTPS URL that hosts the image. For example: ``` https://developers.google.
1990
+ # com/chat/images/quickstart-app-avatar.png ```
1754
1991
  # Corresponds to the JSON property `imageUrl`
1755
1992
  # @return [String]
1756
1993
  attr_accessor :image_url
@@ -1789,7 +2026,7 @@ module Google
1789
2026
  attr_accessor :border_style
1790
2027
 
1791
2028
  # Represents the crop style applied to an image. For example, here's how to
1792
- # apply a 16 by 9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM", "
2029
+ # apply a 16:9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM", "
1793
2030
  # aspectRatio": 16/9 ` ```
1794
2031
  # Corresponds to the JSON property `cropStyle`
1795
2032
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ImageCropStyle]
@@ -1814,13 +2051,13 @@ module Google
1814
2051
  end
1815
2052
 
1816
2053
  # Represents the crop style applied to an image. For example, here's how to
1817
- # apply a 16 by 9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM", "
2054
+ # apply a 16:9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM", "
1818
2055
  # aspectRatio": 16/9 ` ```
1819
2056
  class GoogleAppsCardV1ImageCropStyle
1820
2057
  include Google::Apis::Core::Hashable
1821
2058
 
1822
2059
  # The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. For example,
1823
- # here's how to apply a 16 by 9 aspect ratio: ``` cropStyle ` "type": "
2060
+ # here's how to apply a 16:9 aspect ratio: ``` cropStyle ` "type": "
1824
2061
  # RECTANGLE_CUSTOM", "aspectRatio": 16/9 ` ```
1825
2062
  # Corresponds to the JSON property `aspectRatio`
1826
2063
  # @return [Float]
@@ -1848,8 +2085,8 @@ module Google
1848
2085
  include Google::Apis::Core::Hashable
1849
2086
 
1850
2087
  # An action that describes the behavior when the form is submitted. For example,
1851
- # an Apps Script can be invoked to handle the form. If the action is triggered,
1852
- # the form values are sent to the server.
2088
+ # you can invoke an Apps Script script to handle the form. If the action is
2089
+ # triggered, the form values are sent to the server.
1853
2090
  # Corresponds to the JSON property `action`
1854
2091
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
1855
2092
  attr_accessor :action
@@ -1861,29 +2098,29 @@ module Google
1861
2098
  # text message, just beneath the text message. - As a [dialog](https://
1862
2099
  # developers.google.com/chat/how-tos/dialogs). The following example JSON
1863
2100
  # creates a "contact card" that features: - A header with the contact's name,
1864
- # job title, avatar picture. - A section with the contact information, including
1865
- # formatted text. - Buttons that users can click to share the contact or see
1866
- # more or less info. ![Example contact card](https://developers.google.com/chat/
1867
- # images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "unique-card-id",
1868
- # "card": ` "header": ` "title": "Sasha", "subtitle": "Software Engineer", "
1869
- # imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.
1870
- # png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `, "sections":
1871
- # [ ` "header": "Contact Info", "collapsible": true, "uncollapsibleWidgetsCount"
1872
- # : 1, "widgets": [ ` "decoratedText": ` "startIcon": ` "knownIcon": "EMAIL", `,
1873
- # "text": "sasha@example.com", ` `, ` "decoratedText": ` "startIcon": ` "
1874
- # knownIcon": "PERSON", `, "text": "Online", `, `, ` "decoratedText": ` "
1875
- # startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555) 555-1234", ` `, ` "
1876
- # buttonList": ` "buttons": [ ` "text": "Share", "onClick": ` "openLink": ` "url"
1877
- # : "https://example.com/share", ` ` `, ` "text": "Edit", "onClick": ` "action":
1878
- # ` "function": "goToView", "parameters": [ ` "key": "viewType", "value": "EDIT",
1879
- # ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
2101
+ # job title, and avatar picture. - A section with the contact information,
2102
+ # including formatted text. - Buttons that users can click to share the contact,
2103
+ # or see more or less information. ![Example contact card](https://developers.
2104
+ # google.com/chat/images/card_api_reference.png) ``` ` "cardsV2": [ ` "cardId": "
2105
+ # unique-card-id", "card": ` "header": ` "title": "Sasha", "subtitle": "Software
2106
+ # Engineer", "imageUrl": "https://developers.google.com/chat/images/quickstart-
2107
+ # app-avatar.png", "imageType": "CIRCLE", "imageAltText": "Avatar for Sasha", `,
2108
+ # "sections": [ ` "header": "Contact Info", "collapsible": true, "
2109
+ # uncollapsibleWidgetsCount": 1, "widgets": [ ` "decoratedText": ` "startIcon": `
2110
+ # "knownIcon": "EMAIL", `, "text": "sasha@example.com", ` `, ` "decoratedText":
2111
+ # ` "startIcon": ` "knownIcon": "PERSON", `, "text": "Online", `, `, ` "
2112
+ # decoratedText": ` "startIcon": ` "knownIcon": "PHONE", `, "text": "+1 (555)
2113
+ # 555-1234", ` `, ` "buttonList": ` "buttons": [ ` "text": "Share", "onClick": `
2114
+ # "openLink": ` "url": "https://example.com/share", ` ` `, ` "text": "Edit", "
2115
+ # onClick": ` "action": ` "function": "goToView", "parameters": [ ` "key": "
2116
+ # viewType", "value": "EDIT", ` ], ` ` `, ], ` `, ], `, ], `, ` ], ` ```
1880
2117
  # Corresponds to the JSON property `card`
1881
2118
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Card]
1882
2119
  attr_accessor :card
1883
2120
 
1884
2121
  # An action that describes the behavior when the form is submitted. For example,
1885
- # an Apps Script can be invoked to handle the form. If the action is triggered,
1886
- # the form values are sent to the server.
2122
+ # you can invoke an Apps Script script to handle the form. If the action is
2123
+ # triggered, the form values are sent to the server.
1887
2124
  # Corresponds to the JSON property `openDynamicLinkAction`
1888
2125
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
1889
2126
  attr_accessor :open_dynamic_link_action
@@ -1939,7 +2176,7 @@ module Google
1939
2176
  end
1940
2177
 
1941
2178
  # A section contains a collection of widgets that are rendered vertically in the
1942
- # order that they are specified.
2179
+ # order that they're specified.
1943
2180
  class GoogleAppsCardV1Section
1944
2181
  include Google::Apis::Core::Hashable
1945
2182
 
@@ -1954,8 +2191,10 @@ module Google
1954
2191
  alias_method :collapsible?, :collapsible
1955
2192
 
1956
2193
  # Text that appears at the top of a section. Supports simple HTML formatted text.
1957
- # For more information about formatting text, see Formatting text in Google
1958
- # Chat apps and Formatting text in Google Workspace Add-ons.
2194
+ # For more information about formatting text, see [Formatting text in Google
2195
+ # Chat apps](https://developers.google.com/chat/api/guides/message-formats/cards#
2196
+ # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
2197
+ # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
1959
2198
  # Corresponds to the JSON property `header`
1960
2199
  # @return [String]
1961
2200
  attr_accessor :header
@@ -1970,7 +2209,7 @@ module Google
1970
2209
  # @return [Fixnum]
1971
2210
  attr_accessor :uncollapsible_widgets_count
1972
2211
 
1973
- # All the widgets in the section. Must contain at least 1 widget.
2212
+ # All the widgets in the section. Must contain at least one widget.
1974
2213
  # Corresponds to the JSON property `widgets`
1975
2214
  # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Widget>]
1976
2215
  attr_accessor :widgets
@@ -2020,8 +2259,8 @@ module Google
2020
2259
  attr_accessor :name
2021
2260
 
2022
2261
  # An action that describes the behavior when the form is submitted. For example,
2023
- # an Apps Script can be invoked to handle the form. If the action is triggered,
2024
- # the form values are sent to the server.
2262
+ # you can invoke an Apps Script script to handle the form. If the action is
2263
+ # triggered, the form values are sent to the server.
2025
2264
  # Corresponds to the JSON property `onChangeAction`
2026
2265
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
2027
2266
  attr_accessor :on_change_action
@@ -2091,7 +2330,7 @@ module Google
2091
2330
  include Google::Apis::Core::Hashable
2092
2331
 
2093
2332
  # The value of a suggested input to a text input field. This is equivalent to
2094
- # what users would enter themselves.
2333
+ # what users enter themselves.
2095
2334
  # Corresponds to the JSON property `text`
2096
2335
  # @return [String]
2097
2336
  attr_accessor :text
@@ -2110,12 +2349,12 @@ module Google
2110
2349
  # inside the text input field. As users type, the suggested values dynamically
2111
2350
  # filter to match what the users have typed. For example, a text input field for
2112
2351
  # programming language might suggest Java, JavaScript, Python, and C++. When
2113
- # users start typing "Jav", the list of suggestions filters to show just Java
2114
- # and JavaScript. Suggested values help guide users to enter values that your
2115
- # app can make sense of. When referring to JavaScript, some users might enter "
2116
- # javascript" and others "java script". Suggesting "JavaScript" can standardize
2352
+ # users start typing `Jav`, the list of suggestions filters to show `Java` and `
2353
+ # JavaScript`. Suggested values help guide users to enter values that your app
2354
+ # can make sense of. When referring to JavaScript, some users might enter `
2355
+ # javascript` and others `java script`. Suggesting `JavaScript` can standardize
2117
2356
  # how users interact with your app. When specified, `TextInput.type` is always `
2118
- # SINGLE_LINE`, even if it is set to `MULTIPLE_LINE`.
2357
+ # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`.
2119
2358
  class GoogleAppsCardV1Suggestions
2120
2359
  include Google::Apis::Core::Hashable
2121
2360
 
@@ -2136,7 +2375,7 @@ module Google
2136
2375
  end
2137
2376
 
2138
2377
  # Either a toggle-style switch or a checkbox inside a `decoratedText` widget.
2139
- # Only supported on the `decoratedText` widget.
2378
+ # Only supported in the `decoratedText` widget.
2140
2379
  class GoogleAppsCardV1SwitchControl
2141
2380
  include Google::Apis::Core::Hashable
2142
2381
 
@@ -2153,8 +2392,8 @@ module Google
2153
2392
  attr_accessor :name
2154
2393
 
2155
2394
  # An action that describes the behavior when the form is submitted. For example,
2156
- # an Apps Script can be invoked to handle the form. If the action is triggered,
2157
- # the form values are sent to the server.
2395
+ # you can invoke an Apps Script script to handle the form. If the action is
2396
+ # triggered, the form values are sent to the server.
2158
2397
  # Corresponds to the JSON property `onChangeAction`
2159
2398
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
2160
2399
  attr_accessor :on_change_action
@@ -2197,8 +2436,8 @@ module Google
2197
2436
  include Google::Apis::Core::Hashable
2198
2437
 
2199
2438
  # An action that describes the behavior when the form is submitted. For example,
2200
- # an Apps Script can be invoked to handle the form. If the action is triggered,
2201
- # the form values are sent to the server.
2439
+ # you can invoke an Apps Script script to handle the form. If the action is
2440
+ # triggered, the form values are sent to the server.
2202
2441
  # Corresponds to the JSON property `autoCompleteAction`
2203
2442
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
2204
2443
  attr_accessor :auto_complete_action
@@ -2214,12 +2453,12 @@ module Google
2214
2453
  # inside the text input field. As users type, the suggested values dynamically
2215
2454
  # filter to match what the users have typed. For example, a text input field for
2216
2455
  # programming language might suggest Java, JavaScript, Python, and C++. When
2217
- # users start typing "Jav", the list of suggestions filters to show just Java
2218
- # and JavaScript. Suggested values help guide users to enter values that your
2219
- # app can make sense of. When referring to JavaScript, some users might enter "
2220
- # javascript" and others "java script". Suggesting "JavaScript" can standardize
2456
+ # users start typing `Jav`, the list of suggestions filters to show `Java` and `
2457
+ # JavaScript`. Suggested values help guide users to enter values that your app
2458
+ # can make sense of. When referring to JavaScript, some users might enter `
2459
+ # javascript` and others `java script`. Suggesting `JavaScript` can standardize
2221
2460
  # how users interact with your app. When specified, `TextInput.type` is always `
2222
- # SINGLE_LINE`, even if it is set to `MULTIPLE_LINE`.
2461
+ # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`.
2223
2462
  # Corresponds to the JSON property `initialSuggestions`
2224
2463
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Suggestions]
2225
2464
  attr_accessor :initial_suggestions
@@ -2227,7 +2466,7 @@ module Google
2227
2466
  # The text that appears above the text input field in the user interface.
2228
2467
  # Specify text that helps the user enter the information your app needs. For
2229
2468
  # example, if you are asking someone's name, but specifically need their surname,
2230
- # write "surname" instead of "name". Required if `hintText` is unspecified.
2469
+ # write `surname` instead of `name`. Required if `hintText` is unspecified.
2231
2470
  # Otherwise, optional.
2232
2471
  # Corresponds to the JSON property `label`
2233
2472
  # @return [String]
@@ -2241,8 +2480,8 @@ module Google
2241
2480
  attr_accessor :name
2242
2481
 
2243
2482
  # An action that describes the behavior when the form is submitted. For example,
2244
- # an Apps Script can be invoked to handle the form. If the action is triggered,
2245
- # the form values are sent to the server.
2483
+ # you can invoke an Apps Script script to handle the form. If the action is
2484
+ # triggered, the form values are sent to the server.
2246
2485
  # Corresponds to the JSON property `onChangeAction`
2247
2486
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
2248
2487
  attr_accessor :on_change_action
@@ -2278,8 +2517,10 @@ module Google
2278
2517
  end
2279
2518
 
2280
2519
  # A paragraph of text that supports formatting. For more information about
2281
- # formatting text, see Formatting text in Google Chat apps and Formatting text
2282
- # in Google Workspace Add-ons.
2520
+ # formatting text, see [Formatting text in Google Chat apps](https://developers.
2521
+ # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
2522
+ # Formatting text in Google Workspace Add-ons](https://developers.google.com/
2523
+ # apps-script/add-ons/concepts/widgets#text_formatting).
2283
2524
  class GoogleAppsCardV1TextParagraph
2284
2525
  include Google::Apis::Core::Hashable
2285
2526
 
@@ -2308,42 +2549,66 @@ module Google
2308
2549
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
2309
2550
  attr_accessor :button_list
2310
2551
 
2311
- # Lets users specify a date, a time, or both a date and a time. Accepts text
2312
- # input from users, but features an interactive date and time selector that
2313
- # helps users enter correctly-formatted dates and times. If users enter a date
2314
- # or time incorrectly, the widget shows an error that prompts users to enter the
2315
- # correct format. Not supported by Chat apps. Support by Chat apps coming soon.
2552
+ # The `Columns` widget displays up to 2 columns in a card message or dialog. You
2553
+ # can add widgets to each column; the widgets appear in the order that they are
2554
+ # specified. The height of each column is determined by the taller column. For
2555
+ # example, if the first column is taller than the second column, both columns
2556
+ # have the height of the first column. Because each column can contain a
2557
+ # different number of widgets, you can't define rows or align widgets between
2558
+ # the columns. Columns are displayed side-by-side. You can customize the width
2559
+ # of each column using the `HorizontalSizeStyle` field. If the user's screen
2560
+ # width is too narrow, the second column wraps below the first: * On web, the
2561
+ # second column wraps if the screen width is less than or equal to 480 pixels. *
2562
+ # On iOS devices, the second column wraps if the screen width is less than or
2563
+ # equal to 300 pt. * On Android devices, the second column wraps if the screen
2564
+ # width is less than or equal to 320 dp. To include more than 2 columns, or to
2565
+ # use rows, use the `Grid` widget. Supported by Chat apps, but not Google
2566
+ # Workspace Add-ons.
2567
+ # Corresponds to the JSON property `columns`
2568
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1Columns]
2569
+ attr_accessor :columns
2570
+
2571
+ # Lets users input a date, a time, or both a date and a time. Users can input
2572
+ # text or use the picker to select dates and times. If users input an invalid
2573
+ # date or time, the picker shows an error that prompts users to input the
2574
+ # information correctly.
2316
2575
  # Corresponds to the JSON property `dateTimePicker`
2317
2576
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
2318
2577
  attr_accessor :date_time_picker
2319
2578
 
2320
2579
  # A widget that displays text with optional decorations such as a label above or
2321
- # below the text, an icon in front of the text, a selection widget or a button
2580
+ # below the text, an icon in front of the text, a selection widget, or a button
2322
2581
  # after the text.
2323
2582
  # Corresponds to the JSON property `decoratedText`
2324
2583
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
2325
2584
  attr_accessor :decorated_text
2326
2585
 
2327
- # Displays a divider between widgets, a horizontal line. For example, the
2586
+ # Displays a divider between widgets as a horizontal line. For example, the
2328
2587
  # following JSON creates a divider: ``` "divider": `` ```
2329
2588
  # Corresponds to the JSON property `divider`
2330
2589
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Divider]
2331
2590
  attr_accessor :divider
2332
2591
 
2333
- # Displays a grid with a collection of items. A grid supports any number of
2334
- # columns and items. The number of rows is determined by items divided by
2335
- # columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items
2336
- # and 2 columns has 6 rows. For example, the following JSON creates a 2 column
2337
- # grid with a single item: ``` "grid": ` "title": "A fine collection of items", "
2338
- # columnCount": 2, "borderStyle": ` "type": "STROKE", "cornerRadius": 4 `, "
2339
- # items": [ ` "image": ` "imageUri": "https://www.example.com/image.png", "
2340
- # cropStyle": ` "type": "SQUARE" `, "borderStyle": ` "type": "STROKE" ` `, "
2341
- # title": "An item", "textAlignment": "CENTER" ` ], "onClick": ` "openLink": ` "
2342
- # url": "https://www.example.com" ` ` ` ```
2592
+ # Displays a grid with a collection of items. Items can only include text or
2593
+ # images. A grid supports any number of columns and items. The number of rows is
2594
+ # determined by items divided by columns. A grid with 10 items and 2 columns has
2595
+ # 5 rows. A grid with 11 items and 2 columns has 6 rows. For responsive columns,
2596
+ # or to include more than text or images, use `Columns`. For example, the
2597
+ # following JSON creates a 2 column grid with a single item: ``` "grid": ` "
2598
+ # title": "A fine collection of items", "columnCount": 2, "borderStyle": ` "type"
2599
+ # : "STROKE", "cornerRadius": 4 `, "items": [ ` "image": ` "imageUri": "https://
2600
+ # www.example.com/image.png", "cropStyle": ` "type": "SQUARE" `, "borderStyle": `
2601
+ # "type": "STROKE" ` `, "title": "An item", "textAlignment": "CENTER" ` ], "
2602
+ # onClick": ` "openLink": ` "url": "https://www.example.com" ` ` ` ```
2343
2603
  # Corresponds to the JSON property `grid`
2344
2604
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Grid]
2345
2605
  attr_accessor :grid
2346
2606
 
2607
+ # Specifies whether widgets align to the left, right, or center of a column.
2608
+ # Corresponds to the JSON property `horizontalAlignment`
2609
+ # @return [String]
2610
+ attr_accessor :horizontal_alignment
2611
+
2347
2612
  # An image that is specified by a URL and can have an `onClick` action.
2348
2613
  # Corresponds to the JSON property `image`
2349
2614
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
@@ -2372,8 +2637,10 @@ module Google
2372
2637
  attr_accessor :text_input
2373
2638
 
2374
2639
  # A paragraph of text that supports formatting. For more information about
2375
- # formatting text, see Formatting text in Google Chat apps and Formatting text
2376
- # in Google Workspace Add-ons.
2640
+ # formatting text, see [Formatting text in Google Chat apps](https://developers.
2641
+ # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
2642
+ # Formatting text in Google Workspace Add-ons](https://developers.google.com/
2643
+ # apps-script/add-ons/concepts/widgets#text_formatting).
2377
2644
  # Corresponds to the JSON property `textParagraph`
2378
2645
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
2379
2646
  attr_accessor :text_paragraph
@@ -2385,10 +2652,12 @@ module Google
2385
2652
  # Update properties of this object
2386
2653
  def update!(**args)
2387
2654
  @button_list = args[:button_list] if args.key?(:button_list)
2655
+ @columns = args[:columns] if args.key?(:columns)
2388
2656
  @date_time_picker = args[:date_time_picker] if args.key?(:date_time_picker)
2389
2657
  @decorated_text = args[:decorated_text] if args.key?(:decorated_text)
2390
2658
  @divider = args[:divider] if args.key?(:divider)
2391
2659
  @grid = args[:grid] if args.key?(:grid)
2660
+ @horizontal_alignment = args[:horizontal_alignment] if args.key?(:horizontal_alignment)
2392
2661
  @image = args[:image] if args.key?(:image)
2393
2662
  @selection_input = args[:selection_input] if args.key?(:selection_input)
2394
2663
  @text_input = args[:text_input] if args.key?(:text_input)
@@ -2396,14 +2665,90 @@ module Google
2396
2665
  end
2397
2666
  end
2398
2667
 
2399
- # An image that is specified by a URL and can have an onclick action.
2668
+ # The supported widgets that you can include in a column.
2669
+ class GoogleAppsCardV1Widgets
2670
+ include Google::Apis::Core::Hashable
2671
+
2672
+ # A list of buttons layed out horizontally.
2673
+ # Corresponds to the JSON property `buttonList`
2674
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
2675
+ attr_accessor :button_list
2676
+
2677
+ # Lets users input a date, a time, or both a date and a time. Users can input
2678
+ # text or use the picker to select dates and times. If users input an invalid
2679
+ # date or time, the picker shows an error that prompts users to input the
2680
+ # information correctly.
2681
+ # Corresponds to the JSON property `dateTimePicker`
2682
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
2683
+ attr_accessor :date_time_picker
2684
+
2685
+ # A widget that displays text with optional decorations such as a label above or
2686
+ # below the text, an icon in front of the text, a selection widget, or a button
2687
+ # after the text.
2688
+ # Corresponds to the JSON property `decoratedText`
2689
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
2690
+ attr_accessor :decorated_text
2691
+
2692
+ # An image that is specified by a URL and can have an `onClick` action.
2693
+ # Corresponds to the JSON property `image`
2694
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
2695
+ attr_accessor :image
2696
+
2697
+ # A widget that creates one or more UI items that users can select. For example,
2698
+ # a dropdown menu or checkboxes. You can use this widget to collect data that
2699
+ # can be predicted or enumerated. Chat apps can process the value of items that
2700
+ # users select or input. For details about working with form inputs, see [
2701
+ # Receive form data](https://developers.google.com/chat/how-tos/dialogs#
2702
+ # receive_form_data_from_dialogs). To collect undefined or abstract data from
2703
+ # users, use the TextInput widget.
2704
+ # Corresponds to the JSON property `selectionInput`
2705
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1SelectionInput]
2706
+ attr_accessor :selection_input
2707
+
2708
+ # A field in which users can enter text. Supports suggestions and on-change
2709
+ # actions. Chat apps receive and can process the value of entered text during
2710
+ # form input events. For details about working with form inputs, see [Receive
2711
+ # form data](https://developers.google.com/chat/how-tos/dialogs#
2712
+ # receive_form_data_from_dialogs). When you need to collect undefined or
2713
+ # abstract data from users, use a text input. To collect defined or enumerated
2714
+ # data from users, use the SelectionInput widget.
2715
+ # Corresponds to the JSON property `textInput`
2716
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
2717
+ attr_accessor :text_input
2718
+
2719
+ # A paragraph of text that supports formatting. For more information about
2720
+ # formatting text, see [Formatting text in Google Chat apps](https://developers.
2721
+ # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
2722
+ # Formatting text in Google Workspace Add-ons](https://developers.google.com/
2723
+ # apps-script/add-ons/concepts/widgets#text_formatting).
2724
+ # Corresponds to the JSON property `textParagraph`
2725
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
2726
+ attr_accessor :text_paragraph
2727
+
2728
+ def initialize(**args)
2729
+ update!(**args)
2730
+ end
2731
+
2732
+ # Update properties of this object
2733
+ def update!(**args)
2734
+ @button_list = args[:button_list] if args.key?(:button_list)
2735
+ @date_time_picker = args[:date_time_picker] if args.key?(:date_time_picker)
2736
+ @decorated_text = args[:decorated_text] if args.key?(:decorated_text)
2737
+ @image = args[:image] if args.key?(:image)
2738
+ @selection_input = args[:selection_input] if args.key?(:selection_input)
2739
+ @text_input = args[:text_input] if args.key?(:text_input)
2740
+ @text_paragraph = args[:text_paragraph] if args.key?(:text_paragraph)
2741
+ end
2742
+ end
2743
+
2744
+ # An image that's specified by a URL and can have an `onclick` action.
2400
2745
  class Image
2401
2746
  include Google::Apis::Core::Hashable
2402
2747
 
2403
- # The aspect ratio of this image (width/height). This field allows clients to
2404
- # reserve the right height for the image while waiting for it to load. It's not
2405
- # meant to override the native aspect ratio of the image. If unset, the server
2406
- # fills it by prefetching the image.
2748
+ # The aspect ratio of this image (width and height). This field lets you reserve
2749
+ # the right height for the image while waiting for it to load. It's not meant to
2750
+ # override the built-in aspect ratio of the image. If unset, the server fills it
2751
+ # by prefetching the image.
2407
2752
  # Corresponds to the JSON property `aspectRatio`
2408
2753
  # @return [Float]
2409
2754
  attr_accessor :aspect_ratio
@@ -2413,7 +2758,7 @@ module Google
2413
2758
  # @return [String]
2414
2759
  attr_accessor :image_url
2415
2760
 
2416
- # An onclick action (e.g. open a link).
2761
+ # An `onclick` action (for example, open a link).
2417
2762
  # Corresponds to the JSON property `onClick`
2418
2763
  # @return [Google::Apis::ChatV1::OnClick]
2419
2764
  attr_accessor :on_click
@@ -2430,11 +2775,11 @@ module Google
2430
2775
  end
2431
2776
  end
2432
2777
 
2433
- # An image button with an onclick action.
2778
+ # An image button with an `onclick` action.
2434
2779
  class ImageButton
2435
2780
  include Google::Apis::Core::Hashable
2436
2781
 
2437
- # The icon specified by an enum that indices to an icon provided by Chat API.
2782
+ # The icon specified by an `enum` that indices to an icon provided by Chat API.
2438
2783
  # Corresponds to the JSON property `icon`
2439
2784
  # @return [String]
2440
2785
  attr_accessor :icon
@@ -2444,13 +2789,13 @@ module Google
2444
2789
  # @return [String]
2445
2790
  attr_accessor :icon_url
2446
2791
 
2447
- # The name of this image_button which will be used for accessibility. Default
2448
- # value will be provided if developers don't specify.
2792
+ # The name of this `image_button` that's used for accessibility. Default value
2793
+ # is provided if this name isn't specified.
2449
2794
  # Corresponds to the JSON property `name`
2450
2795
  # @return [String]
2451
2796
  attr_accessor :name
2452
2797
 
2453
- # An onclick action (e.g. open a link).
2798
+ # An `onclick` action (for example, open a link).
2454
2799
  # Corresponds to the JSON property `onClick`
2455
2800
  # @return [Google::Apis::ChatV1::OnClick]
2456
2801
  attr_accessor :on_click
@@ -2507,14 +2852,16 @@ module Google
2507
2852
  end
2508
2853
  end
2509
2854
 
2510
- # A UI element contains a key (label) and a value (content). And this element
2511
- # may also contain some actions such as onclick button.
2855
+ # A UI element contains a key (label) and a value (content). This element can
2856
+ # also contain some actions such as `onclick` button.
2512
2857
  class KeyValue
2513
2858
  include Google::Apis::Core::Hashable
2514
2859
 
2515
2860
  # The text of the bottom label. Formatted text supported. For more information
2516
- # about formatting text, see Formatting text in Google Chat apps and Formatting
2517
- # text in Google Workspace Add-ons.
2861
+ # about formatting text, see [Formatting text in Google Chat apps](https://
2862
+ # developers.google.com/chat/api/guides/message-formats/cards#
2863
+ # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
2864
+ # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
2518
2865
  # Corresponds to the JSON property `bottomLabel`
2519
2866
  # @return [String]
2520
2867
  attr_accessor :bottom_label
@@ -2525,8 +2872,10 @@ module Google
2525
2872
  attr_accessor :button
2526
2873
 
2527
2874
  # The text of the content. Formatted text supported and always required. For
2528
- # more information about formatting text, see Formatting text in Google Chat
2529
- # apps and Formatting text in Google Workspace Add-ons.
2875
+ # more information about formatting text, see [Formatting text in Google Chat
2876
+ # apps](https://developers.google.com/chat/api/guides/message-formats/cards#
2877
+ # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
2878
+ # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
2530
2879
  # Corresponds to the JSON property `content`
2531
2880
  # @return [String]
2532
2881
  attr_accessor :content
@@ -2537,8 +2886,8 @@ module Google
2537
2886
  attr_accessor :content_multiline
2538
2887
  alias_method :content_multiline?, :content_multiline
2539
2888
 
2540
- # An enum value that will be replaced by the Chat API with the corresponding
2541
- # icon image.
2889
+ # An enum value that's replaced by the Chat API with the corresponding icon
2890
+ # image.
2542
2891
  # Corresponds to the JSON property `icon`
2543
2892
  # @return [String]
2544
2893
  attr_accessor :icon
@@ -2548,14 +2897,16 @@ module Google
2548
2897
  # @return [String]
2549
2898
  attr_accessor :icon_url
2550
2899
 
2551
- # An onclick action (e.g. open a link).
2900
+ # An `onclick` action (for example, open a link).
2552
2901
  # Corresponds to the JSON property `onClick`
2553
2902
  # @return [Google::Apis::ChatV1::OnClick]
2554
2903
  attr_accessor :on_click
2555
2904
 
2556
2905
  # The text of the top label. Formatted text supported. For more information
2557
- # about formatting text, see Formatting text in Google Chat apps and Formatting
2558
- # text in Google Workspace Add-ons.
2906
+ # about formatting text, see [Formatting text in Google Chat apps](https://
2907
+ # developers.google.com/chat/api/guides/message-formats/cards#
2908
+ # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
2909
+ # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
2559
2910
  # Corresponds to the JSON property `topLabel`
2560
2911
  # @return [String]
2561
2912
  attr_accessor :top_label
@@ -2586,7 +2937,7 @@ module Google
2586
2937
  # @return [Array<Google::Apis::ChatV1::Membership>]
2587
2938
  attr_accessor :memberships
2588
2939
 
2589
- # A token that can be sent as `pageToken` to retrieve the next page of results.
2940
+ # A token that you can send as `pageToken` to retrieve the next page of results.
2590
2941
  # If empty, there are no subsequent pages.
2591
2942
  # Corresponds to the JSON property `nextPageToken`
2592
2943
  # @return [String]
@@ -2603,12 +2954,64 @@ module Google
2603
2954
  end
2604
2955
  end
2605
2956
 
2957
+ #
2958
+ class ListMessagesResponse
2959
+ include Google::Apis::Core::Hashable
2960
+
2961
+ # List of messages.
2962
+ # Corresponds to the JSON property `messages`
2963
+ # @return [Array<Google::Apis::ChatV1::Message>]
2964
+ attr_accessor :messages
2965
+
2966
+ # You can send a token as `pageToken` to retrieve the next page of results. If
2967
+ # empty, there are no subsequent pages.
2968
+ # Corresponds to the JSON property `nextPageToken`
2969
+ # @return [String]
2970
+ attr_accessor :next_page_token
2971
+
2972
+ def initialize(**args)
2973
+ update!(**args)
2974
+ end
2975
+
2976
+ # Update properties of this object
2977
+ def update!(**args)
2978
+ @messages = args[:messages] if args.key?(:messages)
2979
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
2980
+ end
2981
+ end
2982
+
2983
+ #
2984
+ class ListReactionsResponse
2985
+ include Google::Apis::Core::Hashable
2986
+
2987
+ # Continuation token to retrieve the next page of results. It's empty for the
2988
+ # last page of results.
2989
+ # Corresponds to the JSON property `nextPageToken`
2990
+ # @return [String]
2991
+ attr_accessor :next_page_token
2992
+
2993
+ # List of reactions in the requested (or first) page.
2994
+ # Corresponds to the JSON property `reactions`
2995
+ # @return [Array<Google::Apis::ChatV1::Reaction>]
2996
+ attr_accessor :reactions
2997
+
2998
+ def initialize(**args)
2999
+ update!(**args)
3000
+ end
3001
+
3002
+ # Update properties of this object
3003
+ def update!(**args)
3004
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
3005
+ @reactions = args[:reactions] if args.key?(:reactions)
3006
+ end
3007
+ end
3008
+
2606
3009
  #
2607
3010
  class ListSpacesResponse
2608
3011
  include Google::Apis::Core::Hashable
2609
3012
 
2610
- # A token that can be sent as `pageToken` to retrieve the next page of results.
2611
- # If empty, there are no subsequent pages.
3013
+ # You can send a token as `pageToken` to retrieve the next page of results. If
3014
+ # empty, there are no subsequent pages.
2612
3015
  # Corresponds to the JSON property `nextPageToken`
2613
3016
  # @return [String]
2614
3017
  attr_accessor :next_page_token
@@ -2629,13 +3032,13 @@ module Google
2629
3032
  end
2630
3033
  end
2631
3034
 
2632
- # A matched url in a Chat message. Chat apps can preview matched URLs. For more
2633
- # information, refer to [Preview links](https://developers.google.com/chat/how-
2634
- # tos/preview-links).
3035
+ # A matched URL in a Chat message. Chat apps can preview matched URLs. For more
3036
+ # information, see [Preview links](https://developers.google.com/chat/how-tos/
3037
+ # preview-links).
2635
3038
  class MatchedUrl
2636
3039
  include Google::Apis::Core::Hashable
2637
3040
 
2638
- # Output only. The url that was matched.
3041
+ # Output only. The URL that was matched.
2639
3042
  # Corresponds to the JSON property `url`
2640
3043
  # @return [String]
2641
3044
  attr_accessor :url
@@ -2685,8 +3088,8 @@ module Google
2685
3088
  # @return [Google::Apis::ChatV1::User]
2686
3089
  attr_accessor :member
2687
3090
 
2688
- # Resource name of the membership, assigned by the server. Format: spaces/`space`
2689
- # /members/`member`
3091
+ # Resource name of the membership, assigned by the server. Format: `spaces/`
3092
+ # space`/members/`member``
2690
3093
  # Corresponds to the JSON property `name`
2691
3094
  # @return [String]
2692
3095
  attr_accessor :name
@@ -2725,7 +3128,7 @@ module Google
2725
3128
  # @return [Google::Apis::ChatV1::ActionResponse]
2726
3129
  attr_accessor :action_response
2727
3130
 
2728
- # Output only. Annotations associated with the text in this message.
3131
+ # Output only. Annotations associated with the `text` in this message.
2729
3132
  # Corresponds to the JSON property `annotations`
2730
3133
  # @return [Array<Google::Apis::ChatV1::Annotation>]
2731
3134
  attr_accessor :annotations
@@ -2741,8 +3144,8 @@ module Google
2741
3144
  # @return [Array<Google::Apis::ChatV1::Attachment>]
2742
3145
  attr_accessor :attachment
2743
3146
 
2744
- # Deprecated: Use `cards_v2` instead. Rich, formatted and interactive cards that
2745
- # can be used to display UI elements such as: formatted texts, buttons,
3147
+ # Deprecated: Use `cards_v2` instead. Rich, formatted, and interactive cards
3148
+ # that you can use to display UI elements such as: formatted texts, buttons, and
2746
3149
  # clickable images. Cards are normally displayed below the plain-text body of
2747
3150
  # the message. `cards` and `cards_v2` can have a maximum size of 32 KB.
2748
3151
  # Corresponds to the JSON property `cards`
@@ -2765,19 +3168,43 @@ module Google
2765
3168
  # A custom name for a Chat message assigned at creation. Must start with `client-
2766
3169
  # ` and contain only lowercase letters, numbers, and hyphens up to 63 characters
2767
3170
  # in length. Specify this field to get, update, or delete the message with the
2768
- # specified value. For example usage, see [Name a created message](https://
2769
- # developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).
3171
+ # specified value. Assigning a custom name lets a Chat app recall the message
3172
+ # without saving the message `name` from the [response body](/chat/api/reference/
3173
+ # rest/v1/spaces.messages/get#response-body) returned when creating the message.
3174
+ # Assigning a custom name doesn't replace the generated `name` field, the
3175
+ # message's resource name. Instead, it sets the custom name as the `
3176
+ # clientAssignedMessageId` field, which you can reference while processing later
3177
+ # operations, like updating or deleting the message. For example usage, see [
3178
+ # Name a created message](https://developers.google.com/chat/api/guides/crudl/
3179
+ # messages#name_a_created_message).
2770
3180
  # Corresponds to the JSON property `clientAssignedMessageId`
2771
3181
  # @return [String]
2772
3182
  attr_accessor :client_assigned_message_id
2773
3183
 
2774
- # Output only. The time at which the message was created in Google Chat server.
3184
+ # Output only. The time at which the message was created in Google Chat.
2775
3185
  # Corresponds to the JSON property `createTime`
2776
3186
  # @return [String]
2777
3187
  attr_accessor :create_time
2778
3188
 
3189
+ # Output only. The time at which the message was deleted in Google Chat. If the
3190
+ # message is never deleted, this field is empty.
3191
+ # Corresponds to the JSON property `deleteTime`
3192
+ # @return [String]
3193
+ attr_accessor :delete_time
3194
+
3195
+ # Information about a deleted message. A message is deleted when `delete_time`
3196
+ # is set.
3197
+ # Corresponds to the JSON property `deletionMetadata`
3198
+ # @return [Google::Apis::ChatV1::DeletionMetadata]
3199
+ attr_accessor :deletion_metadata
3200
+
3201
+ # Output only. The list of emoji reaction summaries on the message.
3202
+ # Corresponds to the JSON property `emojiReactionSummaries`
3203
+ # @return [Array<Google::Apis::ChatV1::EmojiReactionSummary>]
3204
+ attr_accessor :emoji_reaction_summaries
3205
+
2779
3206
  # A plain-text description of the message's cards, used when the actual cards
2780
- # cannot be displayed (e.g. mobile notifications).
3207
+ # can't be displayed—for example, mobile notifications.
2781
3208
  # Corresponds to the JSON property `fallbackText`
2782
3209
  # @return [String]
2783
3210
  attr_accessor :fallback_text
@@ -2788,9 +3215,9 @@ module Google
2788
3215
  # @return [String]
2789
3216
  attr_accessor :last_update_time
2790
3217
 
2791
- # A matched url in a Chat message. Chat apps can preview matched URLs. For more
2792
- # information, refer to [Preview links](https://developers.google.com/chat/how-
2793
- # tos/preview-links).
3218
+ # A matched URL in a Chat message. Chat apps can preview matched URLs. For more
3219
+ # information, see [Preview links](https://developers.google.com/chat/how-tos/
3220
+ # preview-links).
2794
3221
  # Corresponds to the JSON property `matchedUrl`
2795
3222
  # @return [Google::Apis::ChatV1::MatchedUrl]
2796
3223
  attr_accessor :matched_url
@@ -2852,6 +3279,9 @@ module Google
2852
3279
  @cards_v2 = args[:cards_v2] if args.key?(:cards_v2)
2853
3280
  @client_assigned_message_id = args[:client_assigned_message_id] if args.key?(:client_assigned_message_id)
2854
3281
  @create_time = args[:create_time] if args.key?(:create_time)
3282
+ @delete_time = args[:delete_time] if args.key?(:delete_time)
3283
+ @deletion_metadata = args[:deletion_metadata] if args.key?(:deletion_metadata)
3284
+ @emoji_reaction_summaries = args[:emoji_reaction_summaries] if args.key?(:emoji_reaction_summaries)
2855
3285
  @fallback_text = args[:fallback_text] if args.key?(:fallback_text)
2856
3286
  @last_update_time = args[:last_update_time] if args.key?(:last_update_time)
2857
3287
  @matched_url = args[:matched_url] if args.key?(:matched_url)
@@ -2865,12 +3295,12 @@ module Google
2865
3295
  end
2866
3296
  end
2867
3297
 
2868
- # An onclick action (e.g. open a link).
3298
+ # An `onclick` action (for example, open a link).
2869
3299
  class OnClick
2870
3300
  include Google::Apis::Core::Hashable
2871
3301
 
2872
3302
  # A form action describes the behavior when the form is submitted. For example,
2873
- # an Apps Script can be invoked to handle the form.
3303
+ # you can invoke Apps Script to handle the form.
2874
3304
  # Corresponds to the JSON property `action`
2875
3305
  # @return [Google::Apis::ChatV1::FormAction]
2876
3306
  attr_accessor :action
@@ -2910,20 +3340,55 @@ module Google
2910
3340
  end
2911
3341
  end
2912
3342
 
3343
+ # A reaction to a message.
3344
+ class Reaction
3345
+ include Google::Apis::Core::Hashable
3346
+
3347
+ # An emoji that is used as a reaction to a message.
3348
+ # Corresponds to the JSON property `emoji`
3349
+ # @return [Google::Apis::ChatV1::Emoji]
3350
+ attr_accessor :emoji
3351
+
3352
+ # The resource name of the reaction. Format: `spaces/`space`/messages/`message`/
3353
+ # reactions/`reaction``
3354
+ # Corresponds to the JSON property `name`
3355
+ # @return [String]
3356
+ attr_accessor :name
3357
+
3358
+ # A user in Google Chat.
3359
+ # Corresponds to the JSON property `user`
3360
+ # @return [Google::Apis::ChatV1::User]
3361
+ attr_accessor :user
3362
+
3363
+ def initialize(**args)
3364
+ update!(**args)
3365
+ end
3366
+
3367
+ # Update properties of this object
3368
+ def update!(**args)
3369
+ @emoji = args[:emoji] if args.key?(:emoji)
3370
+ @name = args[:name] if args.key?(:name)
3371
+ @user = args[:user] if args.key?(:user)
3372
+ end
3373
+ end
3374
+
2913
3375
  # A section contains a collection of widgets that are rendered (vertically) in
2914
3376
  # the order that they are specified. Across all platforms, cards have a narrow
2915
- # fixed width, so there is currently no need for layout properties (e.g. float).
3377
+ # fixed width, so there's currently no need for layout properties (for example,
3378
+ # float).
2916
3379
  class Section
2917
3380
  include Google::Apis::Core::Hashable
2918
3381
 
2919
3382
  # The header of the section. Formatted text is supported. For more information
2920
- # about formatting text, see Formatting text in Google Chat apps and Formatting
2921
- # text in Google Workspace Add-ons.
3383
+ # about formatting text, see [Formatting text in Google Chat apps](https://
3384
+ # developers.google.com/chat/api/guides/message-formats/cards#
3385
+ # card_text_formatting) and [Formatting text in Google Workspace Add-ons](https:/
3386
+ # /developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
2922
3387
  # Corresponds to the JSON property `header`
2923
3388
  # @return [String]
2924
3389
  attr_accessor :header
2925
3390
 
2926
- # A section must contain at least 1 widget.
3391
+ # A section must contain at least one widget.
2927
3392
  # Corresponds to the JSON property `widgets`
2928
3393
  # @return [Array<Google::Apis::ChatV1::WidgetMarkup>]
2929
3394
  attr_accessor :widgets
@@ -2939,12 +3404,58 @@ module Google
2939
3404
  end
2940
3405
  end
2941
3406
 
3407
+ #
3408
+ class SetUpSpaceRequest
3409
+ include Google::Apis::Core::Hashable
3410
+
3411
+ # Optional. The initial set of in-domain users invited to join the space. The
3412
+ # calling user is automatically added to the space, and shouldn't be specified
3413
+ # as a membership. The set currently allows up to 20 memberships (in addition to
3414
+ # the caller). The `Membership.member` field must contain a user with `name`
3415
+ # populated and `User.Type.HUMAN`. All other fields are ignored. Optional when
3416
+ # setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType`
3417
+ # to `GROUP_CHAT`, along with at least two memberships. Required when setting `
3418
+ # Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one
3419
+ # membership. Must be empty when creating a 1:1 conversation between a human and
3420
+ # the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `
3421
+ # Space.singleUserBotDm` to `true`). Not supported: Inviting guest users, or
3422
+ # adding other Chat apps.
3423
+ # Corresponds to the JSON property `memberships`
3424
+ # @return [Array<Google::Apis::ChatV1::Membership>]
3425
+ attr_accessor :memberships
3426
+
3427
+ # Optional. A unique identifier for this request. A random UUID is recommended.
3428
+ # Specifying an existing request ID returns the space created with that ID
3429
+ # instead of creating a new space. Specifying an existing request ID from the
3430
+ # same Chat app with a different authenticated user returns an error.
3431
+ # Corresponds to the JSON property `requestId`
3432
+ # @return [String]
3433
+ attr_accessor :request_id
3434
+
3435
+ # A space in Google Chat. Spaces are conversations between two or more users or
3436
+ # 1:1 messages between a user and a Chat app.
3437
+ # Corresponds to the JSON property `space`
3438
+ # @return [Google::Apis::ChatV1::Space]
3439
+ attr_accessor :space
3440
+
3441
+ def initialize(**args)
3442
+ update!(**args)
3443
+ end
3444
+
3445
+ # Update properties of this object
3446
+ def update!(**args)
3447
+ @memberships = args[:memberships] if args.key?(:memberships)
3448
+ @request_id = args[:request_id] if args.key?(:request_id)
3449
+ @space = args[:space] if args.key?(:space)
3450
+ end
3451
+ end
3452
+
2942
3453
  # A [slash command](https://developers.google.com/chat/how-tos/slash-commands)
2943
3454
  # in Google Chat.
2944
3455
  class SlashCommand
2945
3456
  include Google::Apis::Core::Hashable
2946
3457
 
2947
- # The id of the slash command invoked.
3458
+ # The ID of the slash command invoked.
2948
3459
  # Corresponds to the JSON property `commandId`
2949
3460
  # @return [Fixnum]
2950
3461
  attr_accessor :command_id
@@ -2968,7 +3479,7 @@ module Google
2968
3479
  # @return [Google::Apis::ChatV1::User]
2969
3480
  attr_accessor :bot
2970
3481
 
2971
- # The command id of the invoked slash command.
3482
+ # The command ID of the invoked slash command.
2972
3483
  # Corresponds to the JSON property `commandId`
2973
3484
  # @return [Fixnum]
2974
3485
  attr_accessor :command_id
@@ -2978,7 +3489,7 @@ module Google
2978
3489
  # @return [String]
2979
3490
  attr_accessor :command_name
2980
3491
 
2981
- # Indicating whether the slash command is for a dialog.
3492
+ # Indicates whether the slash command is for a dialog.
2982
3493
  # Corresponds to the JSON property `triggersDialog`
2983
3494
  # @return [Boolean]
2984
3495
  attr_accessor :triggers_dialog
@@ -3020,12 +3531,12 @@ module Google
3020
3531
 
3021
3532
  # The space's display name. Required when [creating a space](https://developers.
3022
3533
  # google.com/chat/api/reference/rest/v1/spaces/create). For direct messages,
3023
- # this field may be empty. Supports up to 128 characters.
3534
+ # this field might be empty. Supports up to 128 characters.
3024
3535
  # Corresponds to the JSON property `displayName`
3025
3536
  # @return [String]
3026
3537
  attr_accessor :display_name
3027
3538
 
3028
- # Resource name of the space. Format: spaces/`space`
3539
+ # Resource name of the space. Format: `spaces/`space``
3029
3540
  # Corresponds to the JSON property `name`
3030
3541
  # @return [String]
3031
3542
  attr_accessor :name
@@ -3041,11 +3552,22 @@ module Google
3041
3552
  # @return [Google::Apis::ChatV1::SpaceDetails]
3042
3553
  attr_accessor :space_details
3043
3554
 
3555
+ # The message history state for messages and threads in this space.
3556
+ # Corresponds to the JSON property `spaceHistoryState`
3557
+ # @return [String]
3558
+ attr_accessor :space_history_state
3559
+
3044
3560
  # Output only. The threading state in the Chat space.
3045
3561
  # Corresponds to the JSON property `spaceThreadingState`
3046
3562
  # @return [String]
3047
3563
  attr_accessor :space_threading_state
3048
3564
 
3565
+ # The type of space. Required when creating a space or updating the space type
3566
+ # of a space. Output only for other usage.
3567
+ # Corresponds to the JSON property `spaceType`
3568
+ # @return [String]
3569
+ attr_accessor :space_type
3570
+
3049
3571
  # Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages
3050
3572
  # are threaded in this space.
3051
3573
  # Corresponds to the JSON property `threaded`
@@ -3053,8 +3575,7 @@ module Google
3053
3575
  attr_accessor :threaded
3054
3576
  alias_method :threaded?, :threaded
3055
3577
 
3056
- # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer
3057
- # preview) instead. The type of a space.
3578
+ # Output only. Deprecated: Use `space_type` instead. The type of a space.
3058
3579
  # Corresponds to the JSON property `type`
3059
3580
  # @return [String]
3060
3581
  attr_accessor :type
@@ -3070,7 +3591,9 @@ module Google
3070
3591
  @name = args[:name] if args.key?(:name)
3071
3592
  @single_user_bot_dm = args[:single_user_bot_dm] if args.key?(:single_user_bot_dm)
3072
3593
  @space_details = args[:space_details] if args.key?(:space_details)
3594
+ @space_history_state = args[:space_history_state] if args.key?(:space_history_state)
3073
3595
  @space_threading_state = args[:space_threading_state] if args.key?(:space_threading_state)
3596
+ @space_type = args[:space_type] if args.key?(:space_type)
3074
3597
  @threaded = args[:threaded] if args.key?(:threaded)
3075
3598
  @type = args[:type] if args.key?(:type)
3076
3599
  end
@@ -3080,8 +3603,9 @@ module Google
3080
3603
  class SpaceDetails
3081
3604
  include Google::Apis::Core::Hashable
3082
3605
 
3083
- # Optional. A description of the space. It could describe the space's discussion
3084
- # topic, functional purpose, or participants. Supports up to 150 characters.
3606
+ # Optional. A description of the space. For example, describe the space's
3607
+ # discussion topic, functional purpose, or participants. Supports up to 150
3608
+ # characters.
3085
3609
  # Corresponds to the JSON property `description`
3086
3610
  # @return [String]
3087
3611
  attr_accessor :description
@@ -3163,11 +3687,11 @@ module Google
3163
3687
  end
3164
3688
  end
3165
3689
 
3166
- # A button with text and onclick action.
3690
+ # A button with text and `onclick` action.
3167
3691
  class TextButton
3168
3692
  include Google::Apis::Core::Hashable
3169
3693
 
3170
- # An onclick action (e.g. open a link).
3694
+ # An `onclick` action (for example, open a link).
3171
3695
  # Corresponds to the JSON property `onClick`
3172
3696
  # @return [Google::Apis::ChatV1::OnClick]
3173
3697
  attr_accessor :on_click
@@ -3189,8 +3713,10 @@ module Google
3189
3713
  end
3190
3714
 
3191
3715
  # A paragraph of text. Formatted text supported. For more information about
3192
- # formatting text, see Formatting text in Google Chat apps and Formatting text
3193
- # in Google Workspace Add-ons.
3716
+ # formatting text, see [Formatting text in Google Chat apps](https://developers.
3717
+ # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
3718
+ # Formatting text in Google Workspace Add-ons](https://developers.google.com/
3719
+ # apps-script/add-ons/concepts/widgets#text_formatting).
3194
3720
  class TextParagraph
3195
3721
  include Google::Apis::Core::Hashable
3196
3722
 
@@ -3213,7 +3739,7 @@ module Google
3213
3739
  class Thread
3214
3740
  include Google::Apis::Core::Hashable
3215
3741
 
3216
- # Resource name of the thread. Example: spaces/`space`/threads/`thread`
3742
+ # Resource name of the thread. Example: `spaces/`space`/threads/`thread``
3217
3743
  # Corresponds to the JSON property `name`
3218
3744
  # @return [String]
3219
3745
  attr_accessor :name
@@ -3294,6 +3820,44 @@ module Google
3294
3820
  end
3295
3821
  end
3296
3822
 
3823
+ #
3824
+ class UploadAttachmentRequest
3825
+ include Google::Apis::Core::Hashable
3826
+
3827
+ # Required. The filename of the attachment, including the file extension.
3828
+ # Corresponds to the JSON property `filename`
3829
+ # @return [String]
3830
+ attr_accessor :filename
3831
+
3832
+ def initialize(**args)
3833
+ update!(**args)
3834
+ end
3835
+
3836
+ # Update properties of this object
3837
+ def update!(**args)
3838
+ @filename = args[:filename] if args.key?(:filename)
3839
+ end
3840
+ end
3841
+
3842
+ #
3843
+ class UploadAttachmentResponse
3844
+ include Google::Apis::Core::Hashable
3845
+
3846
+ # Reference to the uploaded attachment.
3847
+ # Corresponds to the JSON property `attachmentDataRef`
3848
+ # @return [Google::Apis::ChatV1::AttachmentDataRef]
3849
+ attr_accessor :attachment_data_ref
3850
+
3851
+ def initialize(**args)
3852
+ update!(**args)
3853
+ end
3854
+
3855
+ # Update properties of this object
3856
+ def update!(**args)
3857
+ @attachment_data_ref = args[:attachment_data_ref] if args.key?(:attachment_data_ref)
3858
+ end
3859
+ end
3860
+
3297
3861
  # A user in Google Chat.
3298
3862
  class User
3299
3863
  include Google::Apis::Core::Hashable
@@ -3370,7 +3934,7 @@ module Google
3370
3934
  end
3371
3935
  end
3372
3936
 
3373
- # A widget is a UI element that presents texts, images, etc.
3937
+ # A widget is a UI element that presents text and images.
3374
3938
  class WidgetMarkup
3375
3939
  include Google::Apis::Core::Hashable
3376
3940
 
@@ -3380,20 +3944,22 @@ module Google
3380
3944
  # @return [Array<Google::Apis::ChatV1::Button>]
3381
3945
  attr_accessor :buttons
3382
3946
 
3383
- # An image that is specified by a URL and can have an onclick action.
3947
+ # An image that's specified by a URL and can have an `onclick` action.
3384
3948
  # Corresponds to the JSON property `image`
3385
3949
  # @return [Google::Apis::ChatV1::Image]
3386
3950
  attr_accessor :image
3387
3951
 
3388
- # A UI element contains a key (label) and a value (content). And this element
3389
- # may also contain some actions such as onclick button.
3952
+ # A UI element contains a key (label) and a value (content). This element can
3953
+ # also contain some actions such as `onclick` button.
3390
3954
  # Corresponds to the JSON property `keyValue`
3391
3955
  # @return [Google::Apis::ChatV1::KeyValue]
3392
3956
  attr_accessor :key_value
3393
3957
 
3394
3958
  # A paragraph of text. Formatted text supported. For more information about
3395
- # formatting text, see Formatting text in Google Chat apps and Formatting text
3396
- # in Google Workspace Add-ons.
3959
+ # formatting text, see [Formatting text in Google Chat apps](https://developers.
3960
+ # google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [
3961
+ # Formatting text in Google Workspace Add-ons](https://developers.google.com/
3962
+ # apps-script/add-ons/concepts/widgets#text_formatting).
3397
3963
  # Corresponds to the JSON property `textParagraph`
3398
3964
  # @return [Google::Apis::ChatV1::TextParagraph]
3399
3965
  attr_accessor :text_paragraph