google-apis-chat_v1 0.114.0 → 0.116.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.
Files changed (8) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +9 -0
  3. data/lib/google/apis/chat_v1/classes.rb +351 -195
  4. data/lib/google/apis/chat_v1/gem_version.rb +3 -3
  5. data/lib/google/apis/chat_v1/representations.rb +52 -0
  6. data/lib/google/apis/chat_v1/service.rb +8 -8
  7. data/lib/google/apis/chat_v1.rb +4 -4
  8. metadata +4 -7
data/lib/google/apis/chat_v1/classes.rb CHANGED
@@ -73,7 +73,7 @@ module Google
73
73
 
74
74
  # A list of buttons layed out horizontally. For an example in Google Chat apps,
75
75
  # see [Add a button](https://developers.google.com/workspace/chat/design-
76
- # interactive-card-dialog#add_a_button). [Google Workspace Add-ons and Chat apps]
76
+ # interactive-card-dialog#add_a_button). [Google Workspace add-ons and Chat apps]
77
77
  # (https://developers.google.com/workspace/extend):
78
78
  # Corresponds to the JSON property `buttonList`
79
79
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
@@ -195,6 +195,11 @@ module Google
195
195
  class Annotation
196
196
  include Google::Apis::Core::Hashable
197
197
 
198
+ # Annotation metadata for custom emoji.
199
+ # Corresponds to the JSON property `customEmojiMetadata`
200
+ # @return [Google::Apis::ChatV1::CustomEmojiMetadata]
201
+ attr_accessor :custom_emoji_metadata
202
+
198
203
  # Length of the substring in the plain-text message body this annotation
199
204
  # corresponds to.
200
205
  # Corresponds to the JSON property `length`
@@ -233,6 +238,7 @@ module Google
233
238
 
234
239
  # Update properties of this object
235
240
  def update!(**args)
241
+ @custom_emoji_metadata = args[:custom_emoji_metadata] if args.key?(:custom_emoji_metadata)
236
242
  @length = args[:length] if args.key?(:length)
237
243
  @rich_link_metadata = args[:rich_link_metadata] if args.key?(:rich_link_metadata)
238
244
  @slash_command = args[:slash_command] if args.key?(:slash_command)
@@ -242,6 +248,32 @@ module Google
242
248
  end
243
249
  end
244
250
 
251
+ # Metadata about a [Chat app command](https://developers.google.com/workspace/
252
+ # chat/commands).
253
+ class AppCommandMetadata
254
+ include Google::Apis::Core::Hashable
255
+
256
+ # The ID for the command specified in the Chat API configuration.
257
+ # Corresponds to the JSON property `appCommandId`
258
+ # @return [Fixnum]
259
+ attr_accessor :app_command_id
260
+
261
+ # The type of Chat app command.
262
+ # Corresponds to the JSON property `appCommandType`
263
+ # @return [String]
264
+ attr_accessor :app_command_type
265
+
266
+ def initialize(**args)
267
+ update!(**args)
268
+ end
269
+
270
+ # Update properties of this object
271
+ def update!(**args)
272
+ @app_command_id = args[:app_command_id] if args.key?(:app_command_id)
273
+ @app_command_type = args[:app_command_type] if args.key?(:app_command_type)
274
+ end
275
+ end
276
+
245
277
  # A GIF image that's specified by a URL.
246
278
  class AttachedGif
247
279
  include Google::Apis::Core::Hashable
@@ -491,18 +523,18 @@ module Google
491
523
  class CardWithId
492
524
  include Google::Apis::Core::Hashable
493
525
 
494
- # A card interface displayed in a Google Chat message or Google Workspace Add-on.
526
+ # A card interface displayed in a Google Chat message or Google Workspace add-on.
495
527
  # Cards support a defined layout, interactive UI elements like buttons, and
496
528
  # rich media like images. Use cards to present detailed information, gather
497
529
  # information from users, and guide users to take a next step. [Card builder](
498
530
  # https://addons.gsuite.google.com/uikit/builder) To learn how to build cards,
499
531
  # see the following documentation: * For Google Chat apps, see [Design the
500
532
  # components of a card or dialog](https://developers.google.com/workspace/chat/
501
- # design-components-card-dialog). * For Google Workspace Add-ons, see [Card-
533
+ # design-components-card-dialog). * For Google Workspace add-ons, see [Card-
502
534
  # based interfaces](https://developers.google.com/apps-script/add-ons/concepts/
503
535
  # cards). Note: You can add up to 100 widgets per card. Any widgets beyond this
504
536
  # limit are ignored. This limit applies to both card messages and dialogs in
505
- # Google Chat apps, and to cards in Google Workspace Add-ons. **Example: Card
537
+ # Google Chat apps, and to cards in Google Workspace add-ons. **Example: Card
506
538
  # message for a Google Chat app** ![Example contact card](https://developers.
507
539
  # google.com/workspace/chat/images/card_api_reference.png) To create the sample
508
540
  # card message in Google Chat, use the following JSON: ``` ` "cardsV2": [ ` "
@@ -846,6 +878,25 @@ module Google
846
878
  end
847
879
  end
848
880
 
881
+ # Annotation metadata for custom emoji.
882
+ class CustomEmojiMetadata
883
+ include Google::Apis::Core::Hashable
884
+
885
+ # Represents a custom emoji.
886
+ # Corresponds to the JSON property `customEmoji`
887
+ # @return [Google::Apis::ChatV1::CustomEmoji]
888
+ attr_accessor :custom_emoji
889
+
890
+ def initialize(**args)
891
+ update!(**args)
892
+ end
893
+
894
+ # Update properties of this object
895
+ def update!(**args)
896
+ @custom_emoji = args[:custom_emoji] if args.key?(:custom_emoji)
897
+ end
898
+ end
899
+
849
900
  # Date input values.
850
901
  class DateInput
851
902
  include Google::Apis::Core::Hashable
@@ -935,6 +986,12 @@ module Google
935
986
  # @return [Google::Apis::ChatV1::FormAction]
936
987
  attr_accessor :action
937
988
 
989
+ # Metadata about a [Chat app command](https://developers.google.com/workspace/
990
+ # chat/commands).
991
+ # Corresponds to the JSON property `appCommandMetadata`
992
+ # @return [Google::Apis::ChatV1::AppCommandMetadata]
993
+ attr_accessor :app_command_metadata
994
+
938
995
  # Represents information about the user's client, such as locale, host app, and
939
996
  # platform. For Chat apps, `CommonEventObject` includes data submitted by users
940
997
  # interacting with cards, like data entered in [dialogs](https://developers.
@@ -943,11 +1000,12 @@ module Google
943
1000
  # @return [Google::Apis::ChatV1::CommonEventObject]
944
1001
  attr_accessor :common
945
1002
 
946
- # For `MESSAGE` interaction events, the URL that users must be redirected to
947
- # after they complete an authorization or configuration flow outside of Google
948
- # Chat. For more information, see [Connect a Chat app with other services and
949
- # tools](https://developers.google.com/workspace/chat/connect-web-services-tools)
950
- # .
1003
+ # This URL is populated for `MESSAGE`, `ADDED_TO_SPACE`, and `APP_COMMAND`
1004
+ # interaction events. After completing an authorization or configuration flow
1005
+ # outside of Google Chat, users must be redirected to this URL to signal to
1006
+ # Google Chat that the authorization or configuration flow was successful. For
1007
+ # more information, see [Connect a Chat app with other services and tools](https:
1008
+ # //developers.google.com/workspace/chat/connect-web-services-tools).
951
1009
  # Corresponds to the JSON property `configCompleteRedirectUrl`
952
1010
  # @return [String]
953
1011
  attr_accessor :config_complete_redirect_url
@@ -982,6 +1040,16 @@ module Google
982
1040
  # @return [Google::Apis::ChatV1::Space]
983
1041
  attr_accessor :space
984
1042
 
1043
+ # A thread in a Google Chat space. For example usage, see [Start or reply to a
1044
+ # message thread](https://developers.google.com/workspace/chat/create-messages#
1045
+ # create-message-thread). If you specify a thread when creating a message, you
1046
+ # can set the [`messageReplyOption`](https://developers.google.com/workspace/
1047
+ # chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption) field to
1048
+ # determine what happens if no matching thread is found.
1049
+ # Corresponds to the JSON property `thread`
1050
+ # @return [Google::Apis::ChatV1::Thread]
1051
+ attr_accessor :thread
1052
+
985
1053
  # The Chat app-defined key for the thread related to the interaction event. See [
986
1054
  # `spaces.messages.thread.threadKey`](/chat/api/reference/rest/v1/spaces.
987
1055
  # messages#Thread.FIELDS.thread_key) for more information.
@@ -1021,6 +1089,7 @@ module Google
1021
1089
  # Update properties of this object
1022
1090
  def update!(**args)
1023
1091
  @action = args[:action] if args.key?(:action)
1092
+ @app_command_metadata = args[:app_command_metadata] if args.key?(:app_command_metadata)
1024
1093
  @common = args[:common] if args.key?(:common)
1025
1094
  @config_complete_redirect_url = args[:config_complete_redirect_url] if args.key?(:config_complete_redirect_url)
1026
1095
  @dialog_event_type = args[:dialog_event_type] if args.key?(:dialog_event_type)
@@ -1028,6 +1097,7 @@ module Google
1028
1097
  @is_dialog_event = args[:is_dialog_event] if args.key?(:is_dialog_event)
1029
1098
  @message = args[:message] if args.key?(:message)
1030
1099
  @space = args[:space] if args.key?(:space)
1100
+ @thread = args[:thread] if args.key?(:thread)
1031
1101
  @thread_key = args[:thread_key] if args.key?(:thread_key)
1032
1102
  @token = args[:token] if args.key?(:token)
1033
1103
  @type = args[:type] if args.key?(:type)
@@ -1039,18 +1109,18 @@ module Google
1039
1109
  class Dialog
1040
1110
  include Google::Apis::Core::Hashable
1041
1111
 
1042
- # A card interface displayed in a Google Chat message or Google Workspace Add-on.
1112
+ # A card interface displayed in a Google Chat message or Google Workspace add-on.
1043
1113
  # Cards support a defined layout, interactive UI elements like buttons, and
1044
1114
  # rich media like images. Use cards to present detailed information, gather
1045
1115
  # information from users, and guide users to take a next step. [Card builder](
1046
1116
  # https://addons.gsuite.google.com/uikit/builder) To learn how to build cards,
1047
1117
  # see the following documentation: * For Google Chat apps, see [Design the
1048
1118
  # components of a card or dialog](https://developers.google.com/workspace/chat/
1049
- # design-components-card-dialog). * For Google Workspace Add-ons, see [Card-
1119
+ # design-components-card-dialog). * For Google Workspace add-ons, see [Card-
1050
1120
  # based interfaces](https://developers.google.com/apps-script/add-ons/concepts/
1051
1121
  # cards). Note: You can add up to 100 widgets per card. Any widgets beyond this
1052
1122
  # limit are ignored. This limit applies to both card messages and dialogs in
1053
- # Google Chat apps, and to cards in Google Workspace Add-ons. **Example: Card
1123
+ # Google Chat apps, and to cards in Google Workspace add-ons. **Example: Card
1054
1124
  # message for a Google Chat app** ![Example contact card](https://developers.
1055
1125
  # google.com/workspace/chat/images/card_api_reference.png) To create the sample
1056
1126
  # card message in Google Chat, use the following JSON: ``` ` "cardsV2": [ ` "
@@ -1248,11 +1318,19 @@ module Google
1248
1318
 
1249
1319
  # An action that describes the behavior when the form is submitted. For example,
1250
1320
  # you can invoke an Apps Script script to handle the form. If the action is
1251
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
1321
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
1252
1322
  # and Chat apps](https://developers.google.com/workspace/extend):
1253
1323
  class GoogleAppsCardV1Action
1254
1324
  include Google::Apis::Core::Hashable
1255
1325
 
1326
+ # Optional. If this is true, then all widgets are considered required by this
1327
+ # action. [Google Workspace add-ons and Chat apps](https://developers.google.com/
1328
+ # workspace/extend):
1329
+ # Corresponds to the JSON property `allWidgetsAreRequired`
1330
+ # @return [Boolean]
1331
+ attr_accessor :all_widgets_are_required
1332
+ alias_method :all_widgets_are_required?, :all_widgets_are_required
1333
+
1256
1334
  # A custom function to invoke when the containing element is clicked or
1257
1335
  # otherwise activated. For example usage, see [Read form data](https://
1258
1336
  # developers.google.com/workspace/chat/read-form-data).
@@ -1305,17 +1383,27 @@ module Google
1305
1383
  attr_accessor :persist_values
1306
1384
  alias_method :persist_values?, :persist_values
1307
1385
 
1386
+ # Optional. Fill this list with the names of widgets that this Action needs for
1387
+ # a valid submission. If the widgets listed here don't have a value when this
1388
+ # Action is invoked, the form submission is aborted. [Google Workspace add-ons
1389
+ # and Chat apps](https://developers.google.com/workspace/extend):
1390
+ # Corresponds to the JSON property `requiredWidgets`
1391
+ # @return [Array<String>]
1392
+ attr_accessor :required_widgets
1393
+
1308
1394
  def initialize(**args)
1309
1395
  update!(**args)
1310
1396
  end
1311
1397
 
1312
1398
  # Update properties of this object
1313
1399
  def update!(**args)
1400
+ @all_widgets_are_required = args[:all_widgets_are_required] if args.key?(:all_widgets_are_required)
1314
1401
  @function = args[:function] if args.key?(:function)
1315
1402
  @interaction = args[:interaction] if args.key?(:interaction)
1316
1403
  @load_indicator = args[:load_indicator] if args.key?(:load_indicator)
1317
1404
  @parameters = args[:parameters] if args.key?(:parameters)
1318
1405
  @persist_values = args[:persist_values] if args.key?(:persist_values)
1406
+ @required_widgets = args[:required_widgets] if args.key?(:required_widgets)
1319
1407
  end
1320
1408
  end
1321
1409
 
@@ -1324,7 +1412,7 @@ module Google
1324
1412
  # next week. You might use `action method = snooze()`, passing the snooze type
1325
1413
  # and snooze time in the list of string parameters. To learn more, see [`
1326
1414
  # CommonEventObject`](https://developers.google.com/workspace/chat/api/reference/
1327
- # rest/v1/Event#commoneventobject). [Google Workspace Add-ons and Chat apps](
1415
+ # rest/v1/Event#commoneventobject). [Google Workspace add-ons and Chat apps](
1328
1416
  # https://developers.google.com/workspace/extend):
1329
1417
  class GoogleAppsCardV1ActionParameter
1330
1418
  include Google::Apis::Core::Hashable
@@ -1351,7 +1439,7 @@ module Google
1351
1439
  end
1352
1440
 
1353
1441
  # The style options for the border of a card or widget, including the border
1354
- # type and color. [Google Workspace Add-ons and Chat apps](https://developers.
1442
+ # type and color. [Google Workspace add-ons and Chat apps](https://developers.
1355
1443
  # google.com/workspace/extend):
1356
1444
  class GoogleAppsCardV1BorderStyle
1357
1445
  include Google::Apis::Core::Hashable
@@ -1431,7 +1519,7 @@ module Google
1431
1519
  # Google Chat apps, see [Add a button](https://developers.google.com/workspace/
1432
1520
  # chat/design-interactive-card-dialog#add_a_button). To make an image a
1433
1521
  # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1434
- # onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.
1522
+ # onClick` action. [Google Workspace add-ons and Chat apps](https://developers.
1435
1523
  # google.com/workspace/extend):
1436
1524
  class GoogleAppsCardV1Button
1437
1525
  include Google::Apis::Core::Hashable
@@ -1506,14 +1594,14 @@ module Google
1506
1594
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
1507
1595
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
1508
1596
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
1509
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
1597
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
1510
1598
  # extend):
1511
1599
  # Corresponds to the JSON property `icon`
1512
1600
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
1513
1601
  attr_accessor :icon
1514
1602
 
1515
1603
  # Represents how to respond when users click an interactive element on a card,
1516
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
1604
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
1517
1605
  # google.com/workspace/extend):
1518
1606
  # Corresponds to the JSON property `onClick`
1519
1607
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -1526,8 +1614,7 @@ module Google
1526
1614
 
1527
1615
  # Optional. The type of a button. If unset, button type defaults to `OUTLINED`.
1528
1616
  # If the `color` field is set, the button type is forced to `FILLED` and any
1529
- # value set for this field is ignored. [Google Chat apps](https://developers.
1530
- # google.com/workspace/chat):
1617
+ # value set for this field is ignored.
1531
1618
  # Corresponds to the JSON property `type`
1532
1619
  # @return [String]
1533
1620
  attr_accessor :type
@@ -1550,7 +1637,7 @@ module Google
1550
1637
 
1551
1638
  # A list of buttons layed out horizontally. For an example in Google Chat apps,
1552
1639
  # see [Add a button](https://developers.google.com/workspace/chat/design-
1553
- # interactive-card-dialog#add_a_button). [Google Workspace Add-ons and Chat apps]
1640
+ # interactive-card-dialog#add_a_button). [Google Workspace add-ons and Chat apps]
1554
1641
  # (https://developers.google.com/workspace/extend):
1555
1642
  class GoogleAppsCardV1ButtonList
1556
1643
  include Google::Apis::Core::Hashable
@@ -1570,18 +1657,18 @@ module Google
1570
1657
  end
1571
1658
  end
1572
1659
 
1573
- # A card interface displayed in a Google Chat message or Google Workspace Add-on.
1660
+ # A card interface displayed in a Google Chat message or Google Workspace add-on.
1574
1661
  # Cards support a defined layout, interactive UI elements like buttons, and
1575
1662
  # rich media like images. Use cards to present detailed information, gather
1576
1663
  # information from users, and guide users to take a next step. [Card builder](
1577
1664
  # https://addons.gsuite.google.com/uikit/builder) To learn how to build cards,
1578
1665
  # see the following documentation: * For Google Chat apps, see [Design the
1579
1666
  # components of a card or dialog](https://developers.google.com/workspace/chat/
1580
- # design-components-card-dialog). * For Google Workspace Add-ons, see [Card-
1667
+ # design-components-card-dialog). * For Google Workspace add-ons, see [Card-
1581
1668
  # based interfaces](https://developers.google.com/apps-script/add-ons/concepts/
1582
1669
  # cards). Note: You can add up to 100 widgets per card. Any widgets beyond this
1583
1670
  # limit are ignored. This limit applies to both card messages and dialogs in
1584
- # Google Chat apps, and to cards in Google Workspace Add-ons. **Example: Card
1671
+ # Google Chat apps, and to cards in Google Workspace add-ons. **Example: Card
1585
1672
  # message for a Google Chat app** ![Example contact card](https://developers.
1586
1673
  # google.com/workspace/chat/images/card_api_reference.png) To create the sample
1587
1674
  # card message in Google Chat, use the following JSON: ``` ` "cardsV2": [ ` "
@@ -1601,7 +1688,7 @@ module Google
1601
1688
  include Google::Apis::Core::Hashable
1602
1689
 
1603
1690
  # The card's actions. Actions are added to the card's toolbar menu. [Google
1604
- # Workspace Add-ons](https://developers.google.com/workspace/add-ons): For
1691
+ # Workspace add-ons](https://developers.google.com/workspace/add-ons): For
1605
1692
  # example, the following JSON constructs a card action menu with `Settings` and `
1606
1693
  # Send Feedback` options: ``` "card_actions": [ ` "actionLabel": "Settings", "
1607
1694
  # onClick": ` "action": ` "functionName": "goToView", "parameters": [ ` "key": "
@@ -1612,8 +1699,8 @@ module Google
1612
1699
  # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1CardAction>]
1613
1700
  attr_accessor :card_actions
1614
1701
 
1615
- # In Google Workspace Add-ons, sets the display properties of the `
1616
- # peekCardHeader`. [Google Workspace Add-ons](https://developers.google.com/
1702
+ # In Google Workspace add-ons, sets the display properties of the `
1703
+ # peekCardHeader`. [Google Workspace add-ons](https://developers.google.com/
1617
1704
  # workspace/add-ons):
1618
1705
  # Corresponds to the JSON property `displayStyle`
1619
1706
  # @return [String]
@@ -1626,7 +1713,7 @@ module Google
1626
1713
  # messages](https://developers.google.com/workspace/chat/create-messages#create).
1627
1714
  # For an example in Google Chat apps, see [Add a persistent footer](https://
1628
1715
  # developers.google.com/workspace/chat/design-components-card-dialog#
1629
- # add_a_persistent_footer). [Google Workspace Add-ons and Chat apps](https://
1716
+ # add_a_persistent_footer). [Google Workspace add-ons and Chat apps](https://
1630
1717
  # developers.google.com/workspace/extend):
1631
1718
  # Corresponds to the JSON property `fixedFooter`
1632
1719
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardFixedFooter]
@@ -1634,21 +1721,21 @@ module Google
1634
1721
 
1635
1722
  # Represents a card header. For an example in Google Chat apps, see [Add a
1636
1723
  # header](https://developers.google.com/workspace/chat/design-components-card-
1637
- # dialog#add_a_header). [Google Workspace Add-ons and Chat apps](https://
1724
+ # dialog#add_a_header). [Google Workspace add-ons and Chat apps](https://
1638
1725
  # developers.google.com/workspace/extend):
1639
1726
  # Corresponds to the JSON property `header`
1640
1727
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardHeader]
1641
1728
  attr_accessor :header
1642
1729
 
1643
1730
  # Name of the card. Used as a card identifier in card navigation. [Google
1644
- # Workspace Add-ons](https://developers.google.com/workspace/add-ons):
1731
+ # Workspace add-ons](https://developers.google.com/workspace/add-ons):
1645
1732
  # Corresponds to the JSON property `name`
1646
1733
  # @return [String]
1647
1734
  attr_accessor :name
1648
1735
 
1649
1736
  # Represents a card header. For an example in Google Chat apps, see [Add a
1650
1737
  # header](https://developers.google.com/workspace/chat/design-components-card-
1651
- # dialog#add_a_header). [Google Workspace Add-ons and Chat apps](https://
1738
+ # dialog#add_a_header). [Google Workspace add-ons and Chat apps](https://
1652
1739
  # developers.google.com/workspace/extend):
1653
1740
  # Corresponds to the JSON property `peekCardHeader`
1654
1741
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardHeader]
@@ -1686,7 +1773,7 @@ module Google
1686
1773
 
1687
1774
  # A card action is the action associated with the card. For example, an invoice
1688
1775
  # card might include actions such as delete invoice, email invoice, or open the
1689
- # invoice in a browser. [Google Workspace Add-ons](https://developers.google.com/
1776
+ # invoice in a browser. [Google Workspace add-ons](https://developers.google.com/
1690
1777
  # workspace/add-ons):
1691
1778
  class GoogleAppsCardV1CardAction
1692
1779
  include Google::Apis::Core::Hashable
@@ -1697,7 +1784,7 @@ module Google
1697
1784
  attr_accessor :action_label
1698
1785
 
1699
1786
  # Represents how to respond when users click an interactive element on a card,
1700
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
1787
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
1701
1788
  # google.com/workspace/extend):
1702
1789
  # Corresponds to the JSON property `onClick`
1703
1790
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -1721,7 +1808,7 @@ module Google
1721
1808
  # messages](https://developers.google.com/workspace/chat/create-messages#create).
1722
1809
  # For an example in Google Chat apps, see [Add a persistent footer](https://
1723
1810
  # developers.google.com/workspace/chat/design-components-card-dialog#
1724
- # add_a_persistent_footer). [Google Workspace Add-ons and Chat apps](https://
1811
+ # add_a_persistent_footer). [Google Workspace add-ons and Chat apps](https://
1725
1812
  # developers.google.com/workspace/extend):
1726
1813
  class GoogleAppsCardV1CardFixedFooter
1727
1814
  include Google::Apis::Core::Hashable
@@ -1730,7 +1817,7 @@ module Google
1730
1817
  # Google Chat apps, see [Add a button](https://developers.google.com/workspace/
1731
1818
  # chat/design-interactive-card-dialog#add_a_button). To make an image a
1732
1819
  # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1733
- # onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.
1820
+ # onClick` action. [Google Workspace add-ons and Chat apps](https://developers.
1734
1821
  # google.com/workspace/extend):
1735
1822
  # Corresponds to the JSON property `primaryButton`
1736
1823
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
@@ -1740,7 +1827,7 @@ module Google
1740
1827
  # Google Chat apps, see [Add a button](https://developers.google.com/workspace/
1741
1828
  # chat/design-interactive-card-dialog#add_a_button). To make an image a
1742
1829
  # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1743
- # onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.
1830
+ # onClick` action. [Google Workspace add-ons and Chat apps](https://developers.
1744
1831
  # google.com/workspace/extend):
1745
1832
  # Corresponds to the JSON property `secondaryButton`
1746
1833
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
@@ -1759,7 +1846,7 @@ module Google
1759
1846
 
1760
1847
  # Represents a card header. For an example in Google Chat apps, see [Add a
1761
1848
  # header](https://developers.google.com/workspace/chat/design-components-card-
1762
- # dialog#add_a_header). [Google Workspace Add-ons and Chat apps](https://
1849
+ # dialog#add_a_header). [Google Workspace add-ons and Chat apps](https://
1763
1850
  # developers.google.com/workspace/extend):
1764
1851
  class GoogleAppsCardV1CardHeader
1765
1852
  include Google::Apis::Core::Hashable
@@ -1769,7 +1856,7 @@ module Google
1769
1856
  # @return [String]
1770
1857
  attr_accessor :image_alt_text
1771
1858
 
1772
- # The shape used to crop the image. [Google Workspace Add-ons and Chat apps](
1859
+ # The shape used to crop the image. [Google Workspace add-ons and Chat apps](
1773
1860
  # https://developers.google.com/workspace/extend):
1774
1861
  # Corresponds to the JSON property `imageType`
1775
1862
  # @return [String]
@@ -1863,8 +1950,8 @@ module Google
1863
1950
  end
1864
1951
  end
1865
1952
 
1866
- # A text, icon, or text and icon chip that users can click. [Google Chat apps](
1867
- # https://developers.google.com/workspace/chat):
1953
+ # A text, icon, or text and icon chip that users can click. [Google Workspace
1954
+ # add-ons and Chat apps](https://developers.google.com/workspace/extend):
1868
1955
  class GoogleAppsCardV1Chip
1869
1956
  include Google::Apis::Core::Hashable
1870
1957
 
@@ -1895,7 +1982,7 @@ module Google
1895
1982
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
1896
1983
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
1897
1984
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
1898
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
1985
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
1899
1986
  # extend):
1900
1987
  # Corresponds to the JSON property `icon`
1901
1988
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
@@ -1907,7 +1994,7 @@ module Google
1907
1994
  attr_accessor :label
1908
1995
 
1909
1996
  # Represents how to respond when users click an interactive element on a card,
1910
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
1997
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
1911
1998
  # google.com/workspace/extend):
1912
1999
  # Corresponds to the JSON property `onClick`
1913
2000
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -1929,8 +2016,8 @@ module Google
1929
2016
  end
1930
2017
 
1931
2018
  # A list of chips layed out horizontally, which can either scroll horizontally
1932
- # or wrap to the next line. [Google Chat apps](https://developers.google.com/
1933
- # workspace/chat):
2019
+ # or wrap to the next line. [Google Workspace add-ons and Chat apps](https://
2020
+ # developers.google.com/workspace/extend):
1934
2021
  class GoogleAppsCardV1ChipList
1935
2022
  include Google::Apis::Core::Hashable
1936
2023
 
@@ -1955,8 +2042,8 @@ module Google
1955
2042
  end
1956
2043
  end
1957
2044
 
1958
- # Represent an expand and collapse control. [Google Chat apps](https://
1959
- # developers.google.com/workspace/chat):
2045
+ # Represent an expand and collapse control. [Google Workspace add-ons and Chat
2046
+ # apps](https://developers.google.com/workspace/extend):
1960
2047
  class GoogleAppsCardV1CollapseControl
1961
2048
  include Google::Apis::Core::Hashable
1962
2049
 
@@ -1964,7 +2051,7 @@ module Google
1964
2051
  # Google Chat apps, see [Add a button](https://developers.google.com/workspace/
1965
2052
  # chat/design-interactive-card-dialog#add_a_button). To make an image a
1966
2053
  # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1967
- # onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.
2054
+ # onClick` action. [Google Workspace add-ons and Chat apps](https://developers.
1968
2055
  # google.com/workspace/extend):
1969
2056
  # Corresponds to the JSON property `collapseButton`
1970
2057
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
@@ -1974,7 +2061,7 @@ module Google
1974
2061
  # Google Chat apps, see [Add a button](https://developers.google.com/workspace/
1975
2062
  # chat/design-interactive-card-dialog#add_a_button). To make an image a
1976
2063
  # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
1977
- # onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.
2064
+ # onClick` action. [Google Workspace add-ons and Chat apps](https://developers.
1978
2065
  # google.com/workspace/extend):
1979
2066
  # Corresponds to the JSON property `expandButton`
1980
2067
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
@@ -1997,7 +2084,7 @@ module Google
1997
2084
  end
1998
2085
  end
1999
2086
 
2000
- # A column. [Google Workspace Add-ons and Chat apps](https://developers.google.
2087
+ # A column. [Google Workspace add-ons and Chat apps](https://developers.google.
2001
2088
  # com/workspace/extend)
2002
2089
  class GoogleAppsCardV1Column
2003
2090
  include Google::Apis::Core::Hashable
@@ -2052,7 +2139,7 @@ module Google
2052
2139
  # column wraps if the screen width is less than or equal to 300 pt. * On Android
2053
2140
  # devices, the second column wraps if the screen width is less than or equal to
2054
2141
  # 320 dp. To include more than two columns, or to use rows, use the `Grid`
2055
- # widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/
2142
+ # widget. [Google Workspace add-ons and Chat apps](https://developers.google.com/
2056
2143
  # workspace/extend): The add-on UIs that support columns include: * The dialog
2057
2144
  # displayed when users open the add-on from an email draft. * The dialog
2058
2145
  # displayed when users open the add-on from the **Add attachment** menu in a
@@ -2075,14 +2162,16 @@ module Google
2075
2162
  end
2076
2163
  end
2077
2164
 
2078
- # Lets users input a date, a time, or both a date and a time. For an example in
2079
- # Google Chat apps, see [Let a user pick a date and time](https://developers.
2080
- # google.com/workspace/chat/design-interactive-card-dialog#
2081
- # let_a_user_pick_a_date_and_time). Users can input text or use the picker to
2082
- # select dates and times. If users input an invalid date or time, the picker
2083
- # shows an error that prompts users to input the information correctly. [Google
2084
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
2085
- # extend):
2165
+ # Lets users input a date, a time, or both a date and a time. Supports form
2166
+ # submission validation. When `Action.all_widgets_are_required` is set to `true`
2167
+ # or this widget is specified in `Action.required_widgets`, the submission
2168
+ # action is blocked unless a value is selected. For an example in Google Chat
2169
+ # apps, see [Let a user pick a date and time](https://developers.google.com/
2170
+ # workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time).
2171
+ # Users can input text or use the picker to select dates and times. If users
2172
+ # input an invalid date or time, the picker shows an error that prompts users to
2173
+ # input the information correctly. [Google Workspace add-ons and Chat apps](
2174
+ # https://developers.google.com/workspace/extend):
2086
2175
  class GoogleAppsCardV1DateTimePicker
2087
2176
  include Google::Apis::Core::Hashable
2088
2177
 
@@ -2102,7 +2191,7 @@ module Google
2102
2191
 
2103
2192
  # An action that describes the behavior when the form is submitted. For example,
2104
2193
  # you can invoke an Apps Script script to handle the form. If the action is
2105
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
2194
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
2106
2195
  # and Chat apps](https://developers.google.com/workspace/extend):
2107
2196
  # Corresponds to the JSON property `onChangeAction`
2108
2197
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
@@ -2151,7 +2240,7 @@ module Google
2151
2240
  # below the text, an icon in front of the text, a selection widget, or a button
2152
2241
  # after the text. For an example in Google Chat apps, see [Display text with
2153
2242
  # decorative text](https://developers.google.com/workspace/chat/add-text-image-
2154
- # card-dialog#display_text_with_decorative_elements). [Google Workspace Add-ons
2243
+ # card-dialog#display_text_with_decorative_elements). [Google Workspace add-ons
2155
2244
  # and Chat apps](https://developers.google.com/workspace/extend):
2156
2245
  class GoogleAppsCardV1DecoratedText
2157
2246
  include Google::Apis::Core::Hashable
@@ -2165,7 +2254,7 @@ module Google
2165
2254
  # Google Chat apps, see [Add a button](https://developers.google.com/workspace/
2166
2255
  # chat/design-interactive-card-dialog#add_a_button). To make an image a
2167
2256
  # clickable button, specify an `Image` (not an `ImageComponent`) and set an `
2168
- # onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.
2257
+ # onClick` action. [Google Workspace add-ons and Chat apps](https://developers.
2169
2258
  # google.com/workspace/extend):
2170
2259
  # Corresponds to the JSON property `button`
2171
2260
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Button]
@@ -2176,7 +2265,7 @@ module Google
2176
2265
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
2177
2266
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
2178
2267
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
2179
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
2268
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
2180
2269
  # extend):
2181
2270
  # Corresponds to the JSON property `endIcon`
2182
2271
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
@@ -2187,14 +2276,14 @@ module Google
2187
2276
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
2188
2277
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
2189
2278
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
2190
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
2279
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
2191
2280
  # extend):
2192
2281
  # Corresponds to the JSON property `icon`
2193
2282
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
2194
2283
  attr_accessor :icon
2195
2284
 
2196
2285
  # Represents how to respond when users click an interactive element on a card,
2197
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
2286
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
2198
2287
  # google.com/workspace/extend):
2199
2288
  # Corresponds to the JSON property `onClick`
2200
2289
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -2205,14 +2294,14 @@ module Google
2205
2294
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
2206
2295
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
2207
2296
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
2208
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
2297
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
2209
2298
  # extend):
2210
2299
  # Corresponds to the JSON property `startIcon`
2211
2300
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
2212
2301
  attr_accessor :start_icon
2213
2302
 
2214
2303
  # Either a toggle-style switch or a checkbox inside a `decoratedText` widget. [
2215
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
2304
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
2216
2305
  # workspace/extend): Only supported in the `decoratedText` widget.
2217
2306
  # Corresponds to the JSON property `switchControl`
2218
2307
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1SwitchControl]
@@ -2221,7 +2310,7 @@ module Google
2221
2310
  # Required. The primary text. Supports simple formatting. For more information
2222
2311
  # about formatting text, see [Formatting text in Google Chat apps](https://
2223
2312
  # developers.google.com/workspace/chat/format-messages#card-formatting) and [
2224
- # Formatting text in Google Workspace Add-ons](https://developers.google.com/
2313
+ # Formatting text in Google Workspace add-ons](https://developers.google.com/
2225
2314
  # apps-script/add-ons/concepts/widgets#text_formatting).
2226
2315
  # Corresponds to the JSON property `text`
2227
2316
  # @return [String]
@@ -2262,7 +2351,7 @@ module Google
2262
2351
  # Displays a divider between widgets as a horizontal line. For an example in
2263
2352
  # Google Chat apps, see [Add a horizontal divider between widgets](https://
2264
2353
  # developers.google.com/workspace/chat/format-structure-card-dialog#
2265
- # add_a_horizontal_divider_between_widgets). [Google Workspace Add-ons and Chat
2354
+ # add_a_horizontal_divider_between_widgets). [Google Workspace add-ons and Chat
2266
2355
  # apps](https://developers.google.com/workspace/extend): For example, the
2267
2356
  # following JSON creates a divider: ``` "divider": `` ```
2268
2357
  class GoogleAppsCardV1Divider
@@ -2284,7 +2373,7 @@ module Google
2284
2373
  # structure-card-dialog#display_a_grid_with_a_collection_of_items). A grid
2285
2374
  # supports any number of columns and items. The number of rows is determined by
2286
2375
  # items divided by columns. A grid with 10 items and 2 columns has 5 rows. A
2287
- # grid with 11 items and 2 columns has 6 rows. [Google Workspace Add-ons and
2376
+ # grid with 11 items and 2 columns has 6 rows. [Google Workspace add-ons and
2288
2377
  # Chat apps](https://developers.google.com/workspace/extend): For example, the
2289
2378
  # following JSON creates a 2 column grid with a single item: ``` "grid": ` "
2290
2379
  # title": "A fine collection of items", "columnCount": 2, "borderStyle": ` "type"
@@ -2296,7 +2385,7 @@ module Google
2296
2385
  include Google::Apis::Core::Hashable
2297
2386
 
2298
2387
  # The style options for the border of a card or widget, including the border
2299
- # type and color. [Google Workspace Add-ons and Chat apps](https://developers.
2388
+ # type and color. [Google Workspace add-ons and Chat apps](https://developers.
2300
2389
  # google.com/workspace/extend):
2301
2390
  # Corresponds to the JSON property `borderStyle`
2302
2391
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1BorderStyle]
@@ -2315,7 +2404,7 @@ module Google
2315
2404
  attr_accessor :items
2316
2405
 
2317
2406
  # Represents how to respond when users click an interactive element on a card,
2318
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
2407
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
2319
2408
  # google.com/workspace/extend):
2320
2409
  # Corresponds to the JSON property `onClick`
2321
2410
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -2341,7 +2430,7 @@ module Google
2341
2430
  end
2342
2431
 
2343
2432
  # Represents an item in a grid layout. Items can contain text, an image, or both
2344
- # text and an image. [Google Workspace Add-ons and Chat apps](https://developers.
2433
+ # text and an image. [Google Workspace add-ons and Chat apps](https://developers.
2345
2434
  # google.com/workspace/extend):
2346
2435
  class GoogleAppsCardV1GridItem
2347
2436
  include Google::Apis::Core::Hashable
@@ -2352,7 +2441,7 @@ module Google
2352
2441
  # @return [String]
2353
2442
  attr_accessor :id
2354
2443
 
2355
- # Represents an image. [Google Workspace Add-ons and Chat apps](https://
2444
+ # Represents an image. [Google Workspace add-ons and Chat apps](https://
2356
2445
  # developers.google.com/workspace/extend):
2357
2446
  # Corresponds to the JSON property `image`
2358
2447
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ImageComponent]
@@ -2392,7 +2481,7 @@ module Google
2392
2481
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
2393
2482
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
2394
2483
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
2395
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
2484
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
2396
2485
  # extend):
2397
2486
  class GoogleAppsCardV1Icon
2398
2487
  include Google::Apis::Core::Hashable
@@ -2456,7 +2545,7 @@ module Google
2456
2545
 
2457
2546
  # An image that is specified by a URL and can have an `onClick` action. For an
2458
2547
  # example, see [Add an image](https://developers.google.com/workspace/chat/add-
2459
- # text-image-card-dialog#add_an_image). [Google Workspace Add-ons and Chat apps](
2548
+ # text-image-card-dialog#add_an_image). [Google Workspace add-ons and Chat apps](
2460
2549
  # https://developers.google.com/workspace/extend):
2461
2550
  class GoogleAppsCardV1Image
2462
2551
  include Google::Apis::Core::Hashable
@@ -2473,7 +2562,7 @@ module Google
2473
2562
  attr_accessor :image_url
2474
2563
 
2475
2564
  # Represents how to respond when users click an interactive element on a card,
2476
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
2565
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
2477
2566
  # google.com/workspace/extend):
2478
2567
  # Corresponds to the JSON property `onClick`
2479
2568
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -2491,7 +2580,7 @@ module Google
2491
2580
  end
2492
2581
  end
2493
2582
 
2494
- # Represents an image. [Google Workspace Add-ons and Chat apps](https://
2583
+ # Represents an image. [Google Workspace add-ons and Chat apps](https://
2495
2584
  # developers.google.com/workspace/extend):
2496
2585
  class GoogleAppsCardV1ImageComponent
2497
2586
  include Google::Apis::Core::Hashable
@@ -2502,13 +2591,13 @@ module Google
2502
2591
  attr_accessor :alt_text
2503
2592
 
2504
2593
  # The style options for the border of a card or widget, including the border
2505
- # type and color. [Google Workspace Add-ons and Chat apps](https://developers.
2594
+ # type and color. [Google Workspace add-ons and Chat apps](https://developers.
2506
2595
  # google.com/workspace/extend):
2507
2596
  # Corresponds to the JSON property `borderStyle`
2508
2597
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1BorderStyle]
2509
2598
  attr_accessor :border_style
2510
2599
 
2511
- # Represents the crop style applied to an image. [Google Workspace Add-ons and
2600
+ # Represents the crop style applied to an image. [Google Workspace add-ons and
2512
2601
  # Chat apps](https://developers.google.com/workspace/extend): For example, here'
2513
2602
  # s how to apply a 16:9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM",
2514
2603
  # "aspectRatio": 16/9 ` ```
@@ -2534,7 +2623,7 @@ module Google
2534
2623
  end
2535
2624
  end
2536
2625
 
2537
- # Represents the crop style applied to an image. [Google Workspace Add-ons and
2626
+ # Represents the crop style applied to an image. [Google Workspace add-ons and
2538
2627
  # Chat apps](https://developers.google.com/workspace/extend): For example, here'
2539
2628
  # s how to apply a 16:9 aspect ratio: ``` cropStyle ` "type": "RECTANGLE_CUSTOM",
2540
2629
  # "aspectRatio": 16/9 ` ```
@@ -2628,7 +2717,7 @@ module Google
2628
2717
 
2629
2718
  # A list of buttons layed out horizontally. For an example in Google Chat apps,
2630
2719
  # see [Add a button](https://developers.google.com/workspace/chat/design-
2631
- # interactive-card-dialog#add_a_button). [Google Workspace Add-ons and Chat apps]
2720
+ # interactive-card-dialog#add_a_button). [Google Workspace add-ons and Chat apps]
2632
2721
  # (https://developers.google.com/workspace/extend):
2633
2722
  # Corresponds to the JSON property `buttonList`
2634
2723
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
@@ -2636,7 +2725,7 @@ module Google
2636
2725
 
2637
2726
  # An image that is specified by a URL and can have an `onClick` action. For an
2638
2727
  # example, see [Add an image](https://developers.google.com/workspace/chat/add-
2639
- # text-image-card-dialog#add_an_image). [Google Workspace Add-ons and Chat apps](
2728
+ # text-image-card-dialog#add_an_image). [Google Workspace add-ons and Chat apps](
2640
2729
  # https://developers.google.com/workspace/extend):
2641
2730
  # Corresponds to the JSON property `image`
2642
2731
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
@@ -2647,9 +2736,9 @@ module Google
2647
2736
  # workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text).
2648
2737
  # For more information about formatting text, see [Formatting text in Google
2649
2738
  # Chat apps](https://developers.google.com/workspace/chat/format-messages#card-
2650
- # formatting) and [Formatting text in Google Workspace Add-ons](https://
2739
+ # formatting) and [Formatting text in Google Workspace add-ons](https://
2651
2740
  # developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [
2652
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
2741
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
2653
2742
  # workspace/extend):
2654
2743
  # Corresponds to the JSON property `textParagraph`
2655
2744
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
@@ -2668,31 +2757,31 @@ module Google
2668
2757
  end
2669
2758
 
2670
2759
  # Represents how to respond when users click an interactive element on a card,
2671
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
2760
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
2672
2761
  # google.com/workspace/extend):
2673
2762
  class GoogleAppsCardV1OnClick
2674
2763
  include Google::Apis::Core::Hashable
2675
2764
 
2676
2765
  # An action that describes the behavior when the form is submitted. For example,
2677
2766
  # you can invoke an Apps Script script to handle the form. If the action is
2678
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
2767
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
2679
2768
  # and Chat apps](https://developers.google.com/workspace/extend):
2680
2769
  # Corresponds to the JSON property `action`
2681
2770
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
2682
2771
  attr_accessor :action
2683
2772
 
2684
- # A card interface displayed in a Google Chat message or Google Workspace Add-on.
2773
+ # A card interface displayed in a Google Chat message or Google Workspace add-on.
2685
2774
  # Cards support a defined layout, interactive UI elements like buttons, and
2686
2775
  # rich media like images. Use cards to present detailed information, gather
2687
2776
  # information from users, and guide users to take a next step. [Card builder](
2688
2777
  # https://addons.gsuite.google.com/uikit/builder) To learn how to build cards,
2689
2778
  # see the following documentation: * For Google Chat apps, see [Design the
2690
2779
  # components of a card or dialog](https://developers.google.com/workspace/chat/
2691
- # design-components-card-dialog). * For Google Workspace Add-ons, see [Card-
2780
+ # design-components-card-dialog). * For Google Workspace add-ons, see [Card-
2692
2781
  # based interfaces](https://developers.google.com/apps-script/add-ons/concepts/
2693
2782
  # cards). Note: You can add up to 100 widgets per card. Any widgets beyond this
2694
2783
  # limit are ignored. This limit applies to both card messages and dialogs in
2695
- # Google Chat apps, and to cards in Google Workspace Add-ons. **Example: Card
2784
+ # Google Chat apps, and to cards in Google Workspace add-ons. **Example: Card
2696
2785
  # message for a Google Chat app** ![Example contact card](https://developers.
2697
2786
  # google.com/workspace/chat/images/card_api_reference.png) To create the sample
2698
2787
  # card message in Google Chat, use the following JSON: ``` ` "cardsV2": [ ` "
@@ -2714,13 +2803,13 @@ module Google
2714
2803
 
2715
2804
  # An action that describes the behavior when the form is submitted. For example,
2716
2805
  # you can invoke an Apps Script script to handle the form. If the action is
2717
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
2806
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
2718
2807
  # and Chat apps](https://developers.google.com/workspace/extend):
2719
2808
  # Corresponds to the JSON property `openDynamicLinkAction`
2720
2809
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
2721
2810
  attr_accessor :open_dynamic_link_action
2722
2811
 
2723
- # Represents an `onClick` event that opens a hyperlink. [Google Workspace Add-
2812
+ # Represents an `onClick` event that opens a hyperlink. [Google Workspace add-
2724
2813
  # ons and Chat apps](https://developers.google.com/workspace/extend):
2725
2814
  # Corresponds to the JSON property `openLink`
2726
2815
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OpenLink]
@@ -2730,7 +2819,8 @@ module Google
2730
2819
  # invoke. For example, showing non-primary actions in a card. You can use this
2731
2820
  # widget when actions don't fit in the available space. To use, specify this
2732
2821
  # widget in the `OnClick` action of widgets that support it. For example, in a `
2733
- # Button`. [Google Chat apps](https://developers.google.com/workspace/chat):
2822
+ # Button`. [Google Workspace add-ons and Chat apps](https://developers.google.
2823
+ # com/workspace/extend):
2734
2824
  # Corresponds to the JSON property `overflowMenu`
2735
2825
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OverflowMenu]
2736
2826
  attr_accessor :overflow_menu
@@ -2749,19 +2839,19 @@ module Google
2749
2839
  end
2750
2840
  end
2751
2841
 
2752
- # Represents an `onClick` event that opens a hyperlink. [Google Workspace Add-
2842
+ # Represents an `onClick` event that opens a hyperlink. [Google Workspace add-
2753
2843
  # ons and Chat apps](https://developers.google.com/workspace/extend):
2754
2844
  class GoogleAppsCardV1OpenLink
2755
2845
  include Google::Apis::Core::Hashable
2756
2846
 
2757
2847
  # Whether the client forgets about a link after opening it, or observes it until
2758
- # the window closes. [Google Workspace Add-ons](https://developers.google.com/
2848
+ # the window closes. [Google Workspace add-ons](https://developers.google.com/
2759
2849
  # workspace/add-ons):
2760
2850
  # Corresponds to the JSON property `onClose`
2761
2851
  # @return [String]
2762
2852
  attr_accessor :on_close
2763
2853
 
2764
- # How to open a link. [Google Workspace Add-ons](https://developers.google.com/
2854
+ # How to open a link. [Google Workspace add-ons](https://developers.google.com/
2765
2855
  # workspace/add-ons):
2766
2856
  # Corresponds to the JSON property `openAs`
2767
2857
  # @return [String]
@@ -2788,7 +2878,8 @@ module Google
2788
2878
  # invoke. For example, showing non-primary actions in a card. You can use this
2789
2879
  # widget when actions don't fit in the available space. To use, specify this
2790
2880
  # widget in the `OnClick` action of widgets that support it. For example, in a `
2791
- # Button`. [Google Chat apps](https://developers.google.com/workspace/chat):
2881
+ # Button`. [Google Workspace add-ons and Chat apps](https://developers.google.
2882
+ # com/workspace/extend):
2792
2883
  class GoogleAppsCardV1OverflowMenu
2793
2884
  include Google::Apis::Core::Hashable
2794
2885
 
@@ -2807,8 +2898,8 @@ module Google
2807
2898
  end
2808
2899
  end
2809
2900
 
2810
- # An option that users can invoke in an overflow menu. [Google Chat apps](https:/
2811
- # /developers.google.com/workspace/chat):
2901
+ # An option that users can invoke in an overflow menu. [Google Workspace add-ons
2902
+ # and Chat apps](https://developers.google.com/workspace/extend):
2812
2903
  class GoogleAppsCardV1OverflowMenuItem
2813
2904
  include Google::Apis::Core::Hashable
2814
2905
 
@@ -2819,7 +2910,7 @@ module Google
2819
2910
  alias_method :disabled?, :disabled
2820
2911
 
2821
2912
  # Represents how to respond when users click an interactive element on a card,
2822
- # such as a button. [Google Workspace Add-ons and Chat apps](https://developers.
2913
+ # such as a button. [Google Workspace add-ons and Chat apps](https://developers.
2823
2914
  # google.com/workspace/extend):
2824
2915
  # Corresponds to the JSON property `onClick`
2825
2916
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1OnClick]
@@ -2830,7 +2921,7 @@ module Google
2830
2921
  # card-dialog#add_an_icon). Supports [built-in](https://developers.google.com/
2831
2922
  # workspace/chat/format-messages#builtinicons) and [custom](https://developers.
2832
2923
  # google.com/workspace/chat/format-messages#customicons) icons. [Google
2833
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
2924
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
2834
2925
  # extend):
2835
2926
  # Corresponds to the JSON property `startIcon`
2836
2927
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Icon]
@@ -2886,13 +2977,13 @@ module Google
2886
2977
  end
2887
2978
 
2888
2979
  # A section contains a collection of widgets that are rendered vertically in the
2889
- # order that they're specified. [Google Workspace Add-ons and Chat apps](https://
2980
+ # order that they're specified. [Google Workspace add-ons and Chat apps](https://
2890
2981
  # developers.google.com/workspace/extend):
2891
2982
  class GoogleAppsCardV1Section
2892
2983
  include Google::Apis::Core::Hashable
2893
2984
 
2894
- # Represent an expand and collapse control. [Google Chat apps](https://
2895
- # developers.google.com/workspace/chat):
2985
+ # Represent an expand and collapse control. [Google Workspace add-ons and Chat
2986
+ # apps](https://developers.google.com/workspace/extend):
2896
2987
  # Corresponds to the JSON property `collapseControl`
2897
2988
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1CollapseControl]
2898
2989
  attr_accessor :collapse_control
@@ -2910,7 +3001,7 @@ module Google
2910
3001
  # Text that appears at the top of a section. Supports simple HTML formatted text.
2911
3002
  # For more information about formatting text, see [Formatting text in Google
2912
3003
  # Chat apps](https://developers.google.com/workspace/chat/format-messages#card-
2913
- # formatting) and [Formatting text in Google Workspace Add-ons](https://
3004
+ # formatting) and [Formatting text in Google Workspace add-ons](https://
2914
3005
  # developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
2915
3006
  # Corresponds to the JSON property `header`
2916
3007
  # @return [String]
@@ -2945,22 +3036,25 @@ module Google
2945
3036
  end
2946
3037
  end
2947
3038
 
2948
- # A widget that creates one or more UI items that users can select. For example,
2949
- # a dropdown menu or checkboxes. You can use this widget to collect data that
2950
- # can be predicted or enumerated. For an example in Google Chat apps, see [Add
2951
- # selectable UI elements](/workspace/chat/design-interactive-card-dialog#
2952
- # add_selectable_ui_elements). Chat apps can process the value of items that
2953
- # users select or input. For details about working with form inputs, see [
2954
- # Receive form data](https://developers.google.com/workspace/chat/read-form-data)
2955
- # . To collect undefined or abstract data from users, use the TextInput widget. [
2956
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
2957
- # workspace/extend):
3039
+ # A widget that creates one or more UI items that users can select. Supports
3040
+ # form submission validation for `dropdown` and `multiselect` menus only. When `
3041
+ # Action.all_widgets_are_required` is set to `true` or this widget is specified
3042
+ # in `Action.required_widgets`, the submission action is blocked unless a value
3043
+ # is selected. For example, a dropdown menu or checkboxes. You can use this
3044
+ # widget to collect data that can be predicted or enumerated. For an example in
3045
+ # Google Chat apps, see [Add selectable UI elements](/workspace/chat/design-
3046
+ # interactive-card-dialog#add_selectable_ui_elements). Chat apps can process the
3047
+ # value of items that users select or input. For details about working with form
3048
+ # inputs, see [Receive form data](https://developers.google.com/workspace/chat/
3049
+ # read-form-data). To collect undefined or abstract data from users, use the
3050
+ # TextInput widget. [Google Workspace add-ons and Chat apps](https://developers.
3051
+ # google.com/workspace/extend):
2958
3052
  class GoogleAppsCardV1SelectionInput
2959
3053
  include Google::Apis::Core::Hashable
2960
3054
 
2961
3055
  # An action that describes the behavior when the form is submitted. For example,
2962
3056
  # you can invoke an Apps Script script to handle the form. If the action is
2963
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
3057
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
2964
3058
  # and Chat apps](https://developers.google.com/workspace/extend):
2965
3059
  # Corresponds to the JSON property `externalDataSource`
2966
3060
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
@@ -3006,7 +3100,7 @@ module Google
3006
3100
 
3007
3101
  # An action that describes the behavior when the form is submitted. For example,
3008
3102
  # you can invoke an Apps Script script to handle the form. If the action is
3009
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
3103
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
3010
3104
  # and Chat apps](https://developers.google.com/workspace/extend):
3011
3105
  # Corresponds to the JSON property `onChangeAction`
3012
3106
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
@@ -3046,7 +3140,7 @@ module Google
3046
3140
  end
3047
3141
 
3048
3142
  # An item that users can select in a selection input, such as a checkbox or
3049
- # switch. Supports up to 100 items. [Google Workspace Add-ons and Chat apps](
3143
+ # switch. Supports up to 100 items. [Google Workspace add-ons and Chat apps](
3050
3144
  # https://developers.google.com/workspace/extend):
3051
3145
  class GoogleAppsCardV1SelectionItem
3052
3146
  include Google::Apis::Core::Hashable
@@ -3099,7 +3193,7 @@ module Google
3099
3193
  end
3100
3194
 
3101
3195
  # One suggested value that users can enter in a text input field. [Google
3102
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
3196
+ # Workspace add-ons and Chat apps](https://developers.google.com/workspace/
3103
3197
  # extend):
3104
3198
  class GoogleAppsCardV1SuggestionItem
3105
3199
  include Google::Apis::Core::Hashable
@@ -3129,7 +3223,7 @@ module Google
3129
3223
  # can make sense of. When referring to JavaScript, some users might enter `
3130
3224
  # javascript` and others `java script`. Suggesting `JavaScript` can standardize
3131
3225
  # how users interact with your app. When specified, `TextInput.type` is always `
3132
- # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`. [Google Workspace Add-ons
3226
+ # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`. [Google Workspace add-ons
3133
3227
  # and Chat apps](https://developers.google.com/workspace/extend):
3134
3228
  class GoogleAppsCardV1Suggestions
3135
3229
  include Google::Apis::Core::Hashable
@@ -3151,12 +3245,12 @@ module Google
3151
3245
  end
3152
3246
 
3153
3247
  # Either a toggle-style switch or a checkbox inside a `decoratedText` widget. [
3154
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
3248
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
3155
3249
  # workspace/extend): Only supported in the `decoratedText` widget.
3156
3250
  class GoogleAppsCardV1SwitchControl
3157
3251
  include Google::Apis::Core::Hashable
3158
3252
 
3159
- # How the switch appears in the user interface. [Google Workspace Add-ons and
3253
+ # How the switch appears in the user interface. [Google Workspace add-ons and
3160
3254
  # Chat apps](https://developers.google.com/workspace/extend):
3161
3255
  # Corresponds to the JSON property `controlType`
3162
3256
  # @return [String]
@@ -3171,7 +3265,7 @@ module Google
3171
3265
 
3172
3266
  # An action that describes the behavior when the form is submitted. For example,
3173
3267
  # you can invoke an Apps Script script to handle the form. If the action is
3174
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
3268
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
3175
3269
  # and Chat apps](https://developers.google.com/workspace/extend):
3176
3270
  # Corresponds to the JSON property `onChangeAction`
3177
3271
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
@@ -3205,7 +3299,10 @@ module Google
3205
3299
  end
3206
3300
 
3207
3301
  # A field in which users can enter text. Supports suggestions and on-change
3208
- # actions. For an example in Google Chat apps, see [Add a field in which a user
3302
+ # actions. Supports form submission validation. When `Action.
3303
+ # all_widgets_are_required` is set to `true` or this widget is specified in `
3304
+ # Action.required_widgets`, the submission action is blocked unless a value is
3305
+ # entered. For an example in Google Chat apps, see [Add a field in which a user
3209
3306
  # can enter text](https://developers.google.com/workspace/chat/design-
3210
3307
  # interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). Chat apps
3211
3308
  # receive and can process the value of entered text during form input events.
@@ -3213,13 +3310,13 @@ module Google
3213
3310
  # developers.google.com/workspace/chat/read-form-data). When you need to collect
3214
3311
  # undefined or abstract data from users, use a text input. To collect defined or
3215
3312
  # enumerated data from users, use the SelectionInput widget. [Google Workspace
3216
- # Add-ons and Chat apps](https://developers.google.com/workspace/extend):
3313
+ # add-ons and Chat apps](https://developers.google.com/workspace/extend):
3217
3314
  class GoogleAppsCardV1TextInput
3218
3315
  include Google::Apis::Core::Hashable
3219
3316
 
3220
3317
  # An action that describes the behavior when the form is submitted. For example,
3221
3318
  # you can invoke an Apps Script script to handle the form. If the action is
3222
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
3319
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
3223
3320
  # and Chat apps](https://developers.google.com/workspace/extend):
3224
3321
  # Corresponds to the JSON property `autoCompleteAction`
3225
3322
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
@@ -3241,7 +3338,7 @@ module Google
3241
3338
  # can make sense of. When referring to JavaScript, some users might enter `
3242
3339
  # javascript` and others `java script`. Suggesting `JavaScript` can standardize
3243
3340
  # how users interact with your app. When specified, `TextInput.type` is always `
3244
- # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`. [Google Workspace Add-ons
3341
+ # SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`. [Google Workspace add-ons
3245
3342
  # and Chat apps](https://developers.google.com/workspace/extend):
3246
3343
  # Corresponds to the JSON property `initialSuggestions`
3247
3344
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Suggestions]
@@ -3265,7 +3362,7 @@ module Google
3265
3362
 
3266
3363
  # An action that describes the behavior when the form is submitted. For example,
3267
3364
  # you can invoke an Apps Script script to handle the form. If the action is
3268
- # triggered, the form values are sent to the server. [Google Workspace Add-ons
3365
+ # triggered, the form values are sent to the server. [Google Workspace add-ons
3269
3366
  # and Chat apps](https://developers.google.com/workspace/extend):
3270
3367
  # Corresponds to the JSON property `onChangeAction`
3271
3368
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
@@ -3284,6 +3381,13 @@ module Google
3284
3381
  # @return [String]
3285
3382
  attr_accessor :type
3286
3383
 
3384
+ # Represents the necessary data for validating the widget it's attached to. [
3385
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
3386
+ # workspace/extend):
3387
+ # Corresponds to the JSON property `validation`
3388
+ # @return [Google::Apis::ChatV1::GoogleAppsCardV1Validation]
3389
+ attr_accessor :validation
3390
+
3287
3391
  # The value entered by a user, returned as part of a form input event. For
3288
3392
  # details about working with form inputs, see [Receive form data](https://
3289
3393
  # developers.google.com/workspace/chat/read-form-data).
@@ -3305,6 +3409,7 @@ module Google
3305
3409
  @on_change_action = args[:on_change_action] if args.key?(:on_change_action)
3306
3410
  @placeholder_text = args[:placeholder_text] if args.key?(:placeholder_text)
3307
3411
  @type = args[:type] if args.key?(:type)
3412
+ @validation = args[:validation] if args.key?(:validation)
3308
3413
  @value = args[:value] if args.key?(:value)
3309
3414
  end
3310
3415
  end
@@ -3314,9 +3419,9 @@ module Google
3314
3419
  # workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text).
3315
3420
  # For more information about formatting text, see [Formatting text in Google
3316
3421
  # Chat apps](https://developers.google.com/workspace/chat/format-messages#card-
3317
- # formatting) and [Formatting text in Google Workspace Add-ons](https://
3422
+ # formatting) and [Formatting text in Google Workspace add-ons](https://
3318
3423
  # developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [
3319
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
3424
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
3320
3425
  # workspace/extend):
3321
3426
  class GoogleAppsCardV1TextParagraph
3322
3427
  include Google::Apis::Core::Hashable
@@ -3326,8 +3431,7 @@ module Google
3326
3431
  # concealed behind a **show more** button. If the text is equal or shorter than
3327
3432
  # the specified maximum number of lines, a **show more** button isn't displayed.
3328
3433
  # The default value is 0, in which case all context is displayed. Negative
3329
- # values are ignored. [Google Chat apps](https://developers.google.com/workspace/
3330
- # chat):
3434
+ # values are ignored.
3331
3435
  # Corresponds to the JSON property `maxLines`
3332
3436
  # @return [Fixnum]
3333
3437
  attr_accessor :max_lines
@@ -3348,6 +3452,36 @@ module Google
3348
3452
  end
3349
3453
  end
3350
3454
 
3455
+ # Represents the necessary data for validating the widget it's attached to. [
3456
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
3457
+ # workspace/extend):
3458
+ class GoogleAppsCardV1Validation
3459
+ include Google::Apis::Core::Hashable
3460
+
3461
+ # Specify the character limit for text input widgets. Note that this is only
3462
+ # used for text input and is ignored for other widgets. [Google Workspace add-
3463
+ # ons and Chat apps](https://developers.google.com/workspace/extend):
3464
+ # Corresponds to the JSON property `characterLimit`
3465
+ # @return [Fixnum]
3466
+ attr_accessor :character_limit
3467
+
3468
+ # Specify the type of the input widgets. [Google Workspace add-ons and Chat apps]
3469
+ # (https://developers.google.com/workspace/extend):
3470
+ # Corresponds to the JSON property `inputType`
3471
+ # @return [String]
3472
+ attr_accessor :input_type
3473
+
3474
+ def initialize(**args)
3475
+ update!(**args)
3476
+ end
3477
+
3478
+ # Update properties of this object
3479
+ def update!(**args)
3480
+ @character_limit = args[:character_limit] if args.key?(:character_limit)
3481
+ @input_type = args[:input_type] if args.key?(:input_type)
3482
+ end
3483
+ end
3484
+
3351
3485
  # Each card is made up of widgets. A widget is a composite object that can
3352
3486
  # represent one of text, images, buttons, and other object types.
3353
3487
  class GoogleAppsCardV1Widget
@@ -3355,7 +3489,7 @@ module Google
3355
3489
 
3356
3490
  # A list of buttons layed out horizontally. For an example in Google Chat apps,
3357
3491
  # see [Add a button](https://developers.google.com/workspace/chat/design-
3358
- # interactive-card-dialog#add_a_button). [Google Workspace Add-ons and Chat apps]
3492
+ # interactive-card-dialog#add_a_button). [Google Workspace add-ons and Chat apps]
3359
3493
  # (https://developers.google.com/workspace/extend):
3360
3494
  # Corresponds to the JSON property `buttonList`
3361
3495
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
@@ -3375,8 +3509,8 @@ module Google
3375
3509
  attr_accessor :carousel
3376
3510
 
3377
3511
  # A list of chips layed out horizontally, which can either scroll horizontally
3378
- # or wrap to the next line. [Google Chat apps](https://developers.google.com/
3379
- # workspace/chat):
3512
+ # or wrap to the next line. [Google Workspace add-ons and Chat apps](https://
3513
+ # developers.google.com/workspace/extend):
3380
3514
  # Corresponds to the JSON property `chipList`
3381
3515
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ChipList]
3382
3516
  attr_accessor :chip_list
@@ -3397,7 +3531,7 @@ module Google
3397
3531
  # column wraps if the screen width is less than or equal to 300 pt. * On Android
3398
3532
  # devices, the second column wraps if the screen width is less than or equal to
3399
3533
  # 320 dp. To include more than two columns, or to use rows, use the `Grid`
3400
- # widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/
3534
+ # widget. [Google Workspace add-ons and Chat apps](https://developers.google.com/
3401
3535
  # workspace/extend): The add-on UIs that support columns include: * The dialog
3402
3536
  # displayed when users open the add-on from an email draft. * The dialog
3403
3537
  # displayed when users open the add-on from the **Add attachment** menu in a
@@ -3406,14 +3540,16 @@ module Google
3406
3540
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Columns]
3407
3541
  attr_accessor :columns
3408
3542
 
3409
- # Lets users input a date, a time, or both a date and a time. For an example in
3410
- # Google Chat apps, see [Let a user pick a date and time](https://developers.
3411
- # google.com/workspace/chat/design-interactive-card-dialog#
3412
- # let_a_user_pick_a_date_and_time). Users can input text or use the picker to
3413
- # select dates and times. If users input an invalid date or time, the picker
3414
- # shows an error that prompts users to input the information correctly. [Google
3415
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
3416
- # extend):
3543
+ # Lets users input a date, a time, or both a date and a time. Supports form
3544
+ # submission validation. When `Action.all_widgets_are_required` is set to `true`
3545
+ # or this widget is specified in `Action.required_widgets`, the submission
3546
+ # action is blocked unless a value is selected. For an example in Google Chat
3547
+ # apps, see [Let a user pick a date and time](https://developers.google.com/
3548
+ # workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time).
3549
+ # Users can input text or use the picker to select dates and times. If users
3550
+ # input an invalid date or time, the picker shows an error that prompts users to
3551
+ # input the information correctly. [Google Workspace add-ons and Chat apps](
3552
+ # https://developers.google.com/workspace/extend):
3417
3553
  # Corresponds to the JSON property `dateTimePicker`
3418
3554
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
3419
3555
  attr_accessor :date_time_picker
@@ -3422,7 +3558,7 @@ module Google
3422
3558
  # below the text, an icon in front of the text, a selection widget, or a button
3423
3559
  # after the text. For an example in Google Chat apps, see [Display text with
3424
3560
  # decorative text](https://developers.google.com/workspace/chat/add-text-image-
3425
- # card-dialog#display_text_with_decorative_elements). [Google Workspace Add-ons
3561
+ # card-dialog#display_text_with_decorative_elements). [Google Workspace add-ons
3426
3562
  # and Chat apps](https://developers.google.com/workspace/extend):
3427
3563
  # Corresponds to the JSON property `decoratedText`
3428
3564
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
@@ -3431,7 +3567,7 @@ module Google
3431
3567
  # Displays a divider between widgets as a horizontal line. For an example in
3432
3568
  # Google Chat apps, see [Add a horizontal divider between widgets](https://
3433
3569
  # developers.google.com/workspace/chat/format-structure-card-dialog#
3434
- # add_a_horizontal_divider_between_widgets). [Google Workspace Add-ons and Chat
3570
+ # add_a_horizontal_divider_between_widgets). [Google Workspace add-ons and Chat
3435
3571
  # apps](https://developers.google.com/workspace/extend): For example, the
3436
3572
  # following JSON creates a divider: ``` "divider": `` ```
3437
3573
  # Corresponds to the JSON property `divider`
@@ -3445,7 +3581,7 @@ module Google
3445
3581
  # structure-card-dialog#display_a_grid_with_a_collection_of_items). A grid
3446
3582
  # supports any number of columns and items. The number of rows is determined by
3447
3583
  # items divided by columns. A grid with 10 items and 2 columns has 5 rows. A
3448
- # grid with 11 items and 2 columns has 6 rows. [Google Workspace Add-ons and
3584
+ # grid with 11 items and 2 columns has 6 rows. [Google Workspace add-ons and
3449
3585
  # Chat apps](https://developers.google.com/workspace/extend): For example, the
3450
3586
  # following JSON creates a 2 column grid with a single item: ``` "grid": ` "
3451
3587
  # title": "A fine collection of items", "columnCount": 2, "borderStyle": ` "type"
@@ -3464,28 +3600,34 @@ module Google
3464
3600
 
3465
3601
  # An image that is specified by a URL and can have an `onClick` action. For an
3466
3602
  # example, see [Add an image](https://developers.google.com/workspace/chat/add-
3467
- # text-image-card-dialog#add_an_image). [Google Workspace Add-ons and Chat apps](
3603
+ # text-image-card-dialog#add_an_image). [Google Workspace add-ons and Chat apps](
3468
3604
  # https://developers.google.com/workspace/extend):
3469
3605
  # Corresponds to the JSON property `image`
3470
3606
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
3471
3607
  attr_accessor :image
3472
3608
 
3473
- # A widget that creates one or more UI items that users can select. For example,
3474
- # a dropdown menu or checkboxes. You can use this widget to collect data that
3475
- # can be predicted or enumerated. For an example in Google Chat apps, see [Add
3476
- # selectable UI elements](/workspace/chat/design-interactive-card-dialog#
3477
- # add_selectable_ui_elements). Chat apps can process the value of items that
3478
- # users select or input. For details about working with form inputs, see [
3479
- # Receive form data](https://developers.google.com/workspace/chat/read-form-data)
3480
- # . To collect undefined or abstract data from users, use the TextInput widget. [
3481
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
3482
- # workspace/extend):
3609
+ # A widget that creates one or more UI items that users can select. Supports
3610
+ # form submission validation for `dropdown` and `multiselect` menus only. When `
3611
+ # Action.all_widgets_are_required` is set to `true` or this widget is specified
3612
+ # in `Action.required_widgets`, the submission action is blocked unless a value
3613
+ # is selected. For example, a dropdown menu or checkboxes. You can use this
3614
+ # widget to collect data that can be predicted or enumerated. For an example in
3615
+ # Google Chat apps, see [Add selectable UI elements](/workspace/chat/design-
3616
+ # interactive-card-dialog#add_selectable_ui_elements). Chat apps can process the
3617
+ # value of items that users select or input. For details about working with form
3618
+ # inputs, see [Receive form data](https://developers.google.com/workspace/chat/
3619
+ # read-form-data). To collect undefined or abstract data from users, use the
3620
+ # TextInput widget. [Google Workspace add-ons and Chat apps](https://developers.
3621
+ # google.com/workspace/extend):
3483
3622
  # Corresponds to the JSON property `selectionInput`
3484
3623
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1SelectionInput]
3485
3624
  attr_accessor :selection_input
3486
3625
 
3487
3626
  # A field in which users can enter text. Supports suggestions and on-change
3488
- # actions. For an example in Google Chat apps, see [Add a field in which a user
3627
+ # actions. Supports form submission validation. When `Action.
3628
+ # all_widgets_are_required` is set to `true` or this widget is specified in `
3629
+ # Action.required_widgets`, the submission action is blocked unless a value is
3630
+ # entered. For an example in Google Chat apps, see [Add a field in which a user
3489
3631
  # can enter text](https://developers.google.com/workspace/chat/design-
3490
3632
  # interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). Chat apps
3491
3633
  # receive and can process the value of entered text during form input events.
@@ -3493,7 +3635,7 @@ module Google
3493
3635
  # developers.google.com/workspace/chat/read-form-data). When you need to collect
3494
3636
  # undefined or abstract data from users, use a text input. To collect defined or
3495
3637
  # enumerated data from users, use the SelectionInput widget. [Google Workspace
3496
- # Add-ons and Chat apps](https://developers.google.com/workspace/extend):
3638
+ # add-ons and Chat apps](https://developers.google.com/workspace/extend):
3497
3639
  # Corresponds to the JSON property `textInput`
3498
3640
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
3499
3641
  attr_accessor :text_input
@@ -3503,9 +3645,9 @@ module Google
3503
3645
  # workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text).
3504
3646
  # For more information about formatting text, see [Formatting text in Google
3505
3647
  # Chat apps](https://developers.google.com/workspace/chat/format-messages#card-
3506
- # formatting) and [Formatting text in Google Workspace Add-ons](https://
3648
+ # formatting) and [Formatting text in Google Workspace add-ons](https://
3507
3649
  # developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [
3508
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
3650
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
3509
3651
  # workspace/extend):
3510
3652
  # Corresponds to the JSON property `textParagraph`
3511
3653
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
@@ -3533,34 +3675,36 @@ module Google
3533
3675
  end
3534
3676
  end
3535
3677
 
3536
- # The supported widgets that you can include in a column. [Google Workspace Add-
3678
+ # The supported widgets that you can include in a column. [Google Workspace add-
3537
3679
  # ons and Chat apps](https://developers.google.com/workspace/extend)
3538
3680
  class GoogleAppsCardV1Widgets
3539
3681
  include Google::Apis::Core::Hashable
3540
3682
 
3541
3683
  # A list of buttons layed out horizontally. For an example in Google Chat apps,
3542
3684
  # see [Add a button](https://developers.google.com/workspace/chat/design-
3543
- # interactive-card-dialog#add_a_button). [Google Workspace Add-ons and Chat apps]
3685
+ # interactive-card-dialog#add_a_button). [Google Workspace add-ons and Chat apps]
3544
3686
  # (https://developers.google.com/workspace/extend):
3545
3687
  # Corresponds to the JSON property `buttonList`
3546
3688
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
3547
3689
  attr_accessor :button_list
3548
3690
 
3549
3691
  # A list of chips layed out horizontally, which can either scroll horizontally
3550
- # or wrap to the next line. [Google Chat apps](https://developers.google.com/
3551
- # workspace/chat):
3692
+ # or wrap to the next line. [Google Workspace add-ons and Chat apps](https://
3693
+ # developers.google.com/workspace/extend):
3552
3694
  # Corresponds to the JSON property `chipList`
3553
3695
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ChipList]
3554
3696
  attr_accessor :chip_list
3555
3697
 
3556
- # Lets users input a date, a time, or both a date and a time. For an example in
3557
- # Google Chat apps, see [Let a user pick a date and time](https://developers.
3558
- # google.com/workspace/chat/design-interactive-card-dialog#
3559
- # let_a_user_pick_a_date_and_time). Users can input text or use the picker to
3560
- # select dates and times. If users input an invalid date or time, the picker
3561
- # shows an error that prompts users to input the information correctly. [Google
3562
- # Workspace Add-ons and Chat apps](https://developers.google.com/workspace/
3563
- # extend):
3698
+ # Lets users input a date, a time, or both a date and a time. Supports form
3699
+ # submission validation. When `Action.all_widgets_are_required` is set to `true`
3700
+ # or this widget is specified in `Action.required_widgets`, the submission
3701
+ # action is blocked unless a value is selected. For an example in Google Chat
3702
+ # apps, see [Let a user pick a date and time](https://developers.google.com/
3703
+ # workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time).
3704
+ # Users can input text or use the picker to select dates and times. If users
3705
+ # input an invalid date or time, the picker shows an error that prompts users to
3706
+ # input the information correctly. [Google Workspace add-ons and Chat apps](
3707
+ # https://developers.google.com/workspace/extend):
3564
3708
  # Corresponds to the JSON property `dateTimePicker`
3565
3709
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1DateTimePicker]
3566
3710
  attr_accessor :date_time_picker
@@ -3569,7 +3713,7 @@ module Google
3569
3713
  # below the text, an icon in front of the text, a selection widget, or a button
3570
3714
  # after the text. For an example in Google Chat apps, see [Display text with
3571
3715
  # decorative text](https://developers.google.com/workspace/chat/add-text-image-
3572
- # card-dialog#display_text_with_decorative_elements). [Google Workspace Add-ons
3716
+ # card-dialog#display_text_with_decorative_elements). [Google Workspace add-ons
3573
3717
  # and Chat apps](https://developers.google.com/workspace/extend):
3574
3718
  # Corresponds to the JSON property `decoratedText`
3575
3719
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1DecoratedText]
@@ -3577,28 +3721,34 @@ module Google
3577
3721
 
3578
3722
  # An image that is specified by a URL and can have an `onClick` action. For an
3579
3723
  # example, see [Add an image](https://developers.google.com/workspace/chat/add-
3580
- # text-image-card-dialog#add_an_image). [Google Workspace Add-ons and Chat apps](
3724
+ # text-image-card-dialog#add_an_image). [Google Workspace add-ons and Chat apps](
3581
3725
  # https://developers.google.com/workspace/extend):
3582
3726
  # Corresponds to the JSON property `image`
3583
3727
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Image]
3584
3728
  attr_accessor :image
3585
3729
 
3586
- # A widget that creates one or more UI items that users can select. For example,
3587
- # a dropdown menu or checkboxes. You can use this widget to collect data that
3588
- # can be predicted or enumerated. For an example in Google Chat apps, see [Add
3589
- # selectable UI elements](/workspace/chat/design-interactive-card-dialog#
3590
- # add_selectable_ui_elements). Chat apps can process the value of items that
3591
- # users select or input. For details about working with form inputs, see [
3592
- # Receive form data](https://developers.google.com/workspace/chat/read-form-data)
3593
- # . To collect undefined or abstract data from users, use the TextInput widget. [
3594
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
3595
- # workspace/extend):
3730
+ # A widget that creates one or more UI items that users can select. Supports
3731
+ # form submission validation for `dropdown` and `multiselect` menus only. When `
3732
+ # Action.all_widgets_are_required` is set to `true` or this widget is specified
3733
+ # in `Action.required_widgets`, the submission action is blocked unless a value
3734
+ # is selected. For example, a dropdown menu or checkboxes. You can use this
3735
+ # widget to collect data that can be predicted or enumerated. For an example in
3736
+ # Google Chat apps, see [Add selectable UI elements](/workspace/chat/design-
3737
+ # interactive-card-dialog#add_selectable_ui_elements). Chat apps can process the
3738
+ # value of items that users select or input. For details about working with form
3739
+ # inputs, see [Receive form data](https://developers.google.com/workspace/chat/
3740
+ # read-form-data). To collect undefined or abstract data from users, use the
3741
+ # TextInput widget. [Google Workspace add-ons and Chat apps](https://developers.
3742
+ # google.com/workspace/extend):
3596
3743
  # Corresponds to the JSON property `selectionInput`
3597
3744
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1SelectionInput]
3598
3745
  attr_accessor :selection_input
3599
3746
 
3600
3747
  # A field in which users can enter text. Supports suggestions and on-change
3601
- # actions. For an example in Google Chat apps, see [Add a field in which a user
3748
+ # actions. Supports form submission validation. When `Action.
3749
+ # all_widgets_are_required` is set to `true` or this widget is specified in `
3750
+ # Action.required_widgets`, the submission action is blocked unless a value is
3751
+ # entered. For an example in Google Chat apps, see [Add a field in which a user
3602
3752
  # can enter text](https://developers.google.com/workspace/chat/design-
3603
3753
  # interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). Chat apps
3604
3754
  # receive and can process the value of entered text during form input events.
@@ -3606,7 +3756,7 @@ module Google
3606
3756
  # developers.google.com/workspace/chat/read-form-data). When you need to collect
3607
3757
  # undefined or abstract data from users, use a text input. To collect defined or
3608
3758
  # enumerated data from users, use the SelectionInput widget. [Google Workspace
3609
- # Add-ons and Chat apps](https://developers.google.com/workspace/extend):
3759
+ # add-ons and Chat apps](https://developers.google.com/workspace/extend):
3610
3760
  # Corresponds to the JSON property `textInput`
3611
3761
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextInput]
3612
3762
  attr_accessor :text_input
@@ -3616,9 +3766,9 @@ module Google
3616
3766
  # workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text).
3617
3767
  # For more information about formatting text, see [Formatting text in Google
3618
3768
  # Chat apps](https://developers.google.com/workspace/chat/format-messages#card-
3619
- # formatting) and [Formatting text in Google Workspace Add-ons](https://
3769
+ # formatting) and [Formatting text in Google Workspace add-ons](https://
3620
3770
  # developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [
3621
- # Google Workspace Add-ons and Chat apps](https://developers.google.com/
3771
+ # Google Workspace add-ons and Chat apps](https://developers.google.com/
3622
3772
  # workspace/extend):
3623
3773
  # Corresponds to the JSON property `textParagraph`
3624
3774
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1TextParagraph]
@@ -4430,8 +4580,8 @@ module Google
4430
4580
  # @return [Google::Apis::ChatV1::User]
4431
4581
  attr_accessor :sender
4432
4582
 
4433
- # A [slash command](https://developers.google.com/workspace/chat/slash-commands)
4434
- # in Google Chat.
4583
+ # Metadata about a [slash command](https://developers.google.com/workspace/chat/
4584
+ # commands) in Google Chat.
4435
4585
  # Corresponds to the JSON property `slashCommand`
4436
4586
  # @return [Google::Apis::ChatV1::SlashCommand]
4437
4587
  attr_accessor :slash_command
@@ -5078,12 +5228,12 @@ module Google
5078
5228
  end
5079
5229
  end
5080
5230
 
5081
- # A [slash command](https://developers.google.com/workspace/chat/slash-commands)
5082
- # in Google Chat.
5231
+ # Metadata about a [slash command](https://developers.google.com/workspace/chat/
5232
+ # commands) in Google Chat.
5083
5233
  class SlashCommand
5084
5234
  include Google::Apis::Core::Hashable
5085
5235
 
5086
- # The ID of the slash command invoked.
5236
+ # The ID of the slash command.
5087
5237
  # Corresponds to the JSON property `commandId`
5088
5238
  # @return [Fixnum]
5089
5239
  attr_accessor :command_id
@@ -5246,7 +5396,13 @@ module Google
5246
5396
  # Optional. Input only. Predefined space permission settings, input only when
5247
5397
  # creating a space. If the field is not set, a collaboration space is created.
5248
5398
  # After you create the space, settings are populated in the `PermissionSettings`
5249
- # field.
5399
+ # field. Setting predefined permission settings supports: - In [Developer
5400
+ # Preview](https://developers.google.com/workspace/preview), [App authentication]
5401
+ # (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
5402
+ # with [administrator approval](https://support.google.com/a?p=chat-app-auth)
5403
+ # with the `chat.app.spaces` or `chat.app.spaces.create` scopes. - [User
5404
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
5405
+ # authorize-chat-user)
5250
5406
  # Corresponds to the JSON property `predefinedPermissionSettings`
5251
5407
  # @return [String]
5252
5408
  attr_accessor :predefined_permission_settings