google-apis-chat_v1 0.157.0 → 0.159.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a2965c5703b55c72fbd81511aa84169ab753f482ffb2835ea7a968e333057eae
4
- data.tar.gz: 6aa44c9f69109deaed9c2a3952741c71cb7784f9604b60aebfc2cbb931766a38
3
+ metadata.gz: c09cd0571e6cabf525fbcf8ac3acc8f75135d5023e1a89c9f6c4ebb065007aee
4
+ data.tar.gz: 519861463cea05b99c93401b82ae9b9546a14fb812d3a51bd2f0cf6809f5b210
5
5
  SHA512:
6
- metadata.gz: cd1a8f4c1686eb91afe1fbd15ecdf7f3837975a22e9f7eb0729e65d4d36943d175e45b5796464da97a29a54a039ab52dd58096d435df8b738875b7f4ce0aac5e
7
- data.tar.gz: feb9e0464df1b31682fb0d18b48f49264db917a04d810e76f0e2720b174d4985f03b2215974e167b7108e167f453cbe1d33c3c0511467014bb0bbc863b760fa6
6
+ metadata.gz: e3589e55a7f3230e00e2a306e646d330154a3b3f82f4f67bd993aed8e953ff322c22c78c68e9a3d9aee74def0ec361a6c91d48755f03114ebc934019965b54b9
7
+ data.tar.gz: 858dff6fd77e4f4764c3cc01f4bf1619f97d255241370dd0c51505e9c05a330606d05933a9054a51548c4e59db3b481e7ddac5d6faaa9f064f1ae414276bee17
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Release history for google-apis-chat_v1
2
2
 
3
+ ### v0.159.0 (2026-11-01)
4
+
5
+ * Regenerated from discovery document revision 20261026
6
+
7
+ ### v0.158.0 (2026-10-21)
8
+
9
+ * Regenerated from discovery document revision 20261015
10
+ * Regenerated using generator version 0.19.1
11
+
3
12
  ### v0.157.0 (2026-10-04)
4
13
 
5
14
  * Regenerated from discovery document revision 20260927
@@ -727,6 +727,15 @@ module Google
727
727
  # @return [String]
728
728
  attr_accessor :card_id
729
729
 
730
+ # If your Chat app [authenticates as a user](https://developers.google.com/
731
+ # workspace/chat/authenticate-authorize-chat-user), the output for a `User`
732
+ # resource (such as in the Messages and Memberships APIs) only populates the `
733
+ # name` and `type` fields for both internal and external users, unless they are
734
+ # members of the space or have prior affinity with the calling user.
735
+ # Corresponds to the JSON property `ownerUser`
736
+ # @return [Google::Apis::ChatV1::User]
737
+ attr_accessor :owner_user
738
+
730
739
  def initialize(**args)
731
740
  update!(**args)
732
741
  end
@@ -735,6 +744,7 @@ module Google
735
744
  def update!(**args)
736
745
  @card = args[:card] if args.key?(:card)
737
746
  @card_id = args[:card_id] if args.key?(:card_id)
747
+ @owner_user = args[:owner_user] if args.key?(:owner_user)
738
748
  end
739
749
  end
740
750
 
@@ -835,6 +845,78 @@ module Google
835
845
  end
836
846
  end
837
847
 
848
+ # Citations are inline references that can provide users more detailed
849
+ # information about the inline reference. Corresponding inline citations should
850
+ # be present in the message text in a markup format of ``text``. Citations are
851
+ # only supported when the message's `markup_syntax` is set to `MARKDOWN`.
852
+ # Unreferenced citations in `Elements.citations` (those without a matching ``
853
+ # tag in the message text) are ignored and do not cause the message to be
854
+ # rejected.
855
+ class Citation
856
+ include Google::Apis::Core::Hashable
857
+
858
+ # Optional. A list of sources that are relevant to the citation. Sources are
859
+ # displayed in the citation hover card.
860
+ # Corresponds to the JSON property `citedSources`
861
+ # @return [Array<Google::Apis::ChatV1::CitedSource>]
862
+ attr_accessor :cited_sources
863
+
864
+ # Required. The ID of the citation. This ID is defined by the app creating the
865
+ # citation and must match the `data-id` attribute of the `` tag in the message
866
+ # text. Must contain only ASCII letters and numbers, and less than 63 characters.
867
+ # Corresponds to the JSON property `id`
868
+ # @return [String]
869
+ attr_accessor :id
870
+
871
+ def initialize(**args)
872
+ update!(**args)
873
+ end
874
+
875
+ # Update properties of this object
876
+ def update!(**args)
877
+ @cited_sources = args[:cited_sources] if args.key?(:cited_sources)
878
+ @id = args[:id] if args.key?(:id)
879
+ end
880
+ end
881
+
882
+ # A reference to a source of information.
883
+ class CitedSource
884
+ include Google::Apis::Core::Hashable
885
+
886
+ # A footer for a source, used for attribution.
887
+ # Corresponds to the JSON property `footer`
888
+ # @return [Google::Apis::ChatV1::Footer]
889
+ attr_accessor :footer
890
+
891
+ # A snippet object representing an excerpt from a larger corpus.
892
+ # Corresponds to the JSON property `snippet`
893
+ # @return [Google::Apis::ChatV1::Snippet]
894
+ attr_accessor :snippet
895
+
896
+ # Required. The plaintext title of the `CitedSource`. Does not support markdown
897
+ # format.
898
+ # Corresponds to the JSON property `title`
899
+ # @return [String]
900
+ attr_accessor :title
901
+
902
+ # Required. The URI pointing to the resource referenced by this `CitedSource`.
903
+ # Corresponds to the JSON property `uri`
904
+ # @return [String]
905
+ attr_accessor :uri
906
+
907
+ def initialize(**args)
908
+ update!(**args)
909
+ end
910
+
911
+ # Update properties of this object
912
+ def update!(**args)
913
+ @footer = args[:footer] if args.key?(:footer)
914
+ @snippet = args[:snippet] if args.key?(:snippet)
915
+ @title = args[:title] if args.key?(:title)
916
+ @uri = args[:uri] if args.key?(:uri)
917
+ end
918
+ end
919
+
838
920
  # Represents a color in the RGBA color space. This representation is designed
839
921
  # for simplicity of conversion to and from color representations in various
840
922
  # languages over compactness. For example, the fields of this representation can
@@ -940,36 +1022,47 @@ module Google
940
1022
  include Google::Apis::Core::Hashable
941
1023
 
942
1024
  # A map containing the current values of the widgets in the displayed card. The
943
- # map keys are the string IDs assigned with each widget. The structure of the
944
- # map value object is dependent on the widget type: **Note**: The following
945
- # examples are formatted for Apps Script's V8 runtime. If you're using Rhino
946
- # runtime, you must add `[""]` after the value. For example, instead of `e.
947
- # commonEventObject.formInputs.employeeName.stringInputs.value[0]`, format the
948
- # event object as `e.commonEventObject.formInputs.employeeName[""].stringInputs.
949
- # value[0]`. To learn more about runtimes in Apps Script, see the [V8 Runtime
950
- # Overview](https://developers.google.com/apps-script/guides/v8-runtime). *
951
- # Single-valued widgets (for example, a text box): a list of strings (only one
952
- # element). **Example**: for a text input widget with `employeeName` as its ID,
953
- # access the text input value with: `e.commonEventObject.formInputs.employeeName.
954
- # stringInputs.value[0]`. * Multi-valued widgets (for example, checkbox groups):
955
- # a list of strings. **Example**: for a multi-value widget with `participants`
956
- # as its ID, access the value array with: `e.commonEventObject.formInputs.
957
- # participants.stringInputs.value`. * **A date-time picker**: a [`DateTimeInput
958
- # object`](https://developers.google.com/workspace/add-ons/concepts/event-
959
- # objects#date-time-input). **Example**: For a picker with an ID of `myDTPicker`,
960
- # access the [`DateTimeInput`](https://developers.google.com/workspace/add-ons/
961
- # concepts/event-objects#date-time-input) object using `e.commonEventObject.
962
- # formInputs.myDTPicker.dateTimeInput`. * **A date-only picker**: a [`DateInput
963
- # object`](https://developers.google.com/workspace/add-ons/concepts/event-
964
- # objects#date-input). **Example**: For a picker with an ID of `myDatePicker`,
965
- # access the [`DateInput`](https://developers.google.com/workspace/add-ons/
966
- # concepts/event-objects#date-input) object using `e.commonEventObject.
967
- # formInputs.myDatePicker.dateInput`. * **A time-only picker**: a [`TimeInput
968
- # object`](https://developers.google.com/workspace/add-ons/concepts/event-
969
- # objects#time-input). **Example**: For a picker with an ID of `myTimePicker`,
970
- # access the [`TimeInput`](https://developers.google.com/workspace/add-ons/
971
- # concepts/event-objects#time-input) object using `e.commonEventObject.
972
- # formInputs.myTimePicker.timeInput`.
1025
+ # map keys are the string `name` values assigned to each input widget (such as `
1026
+ # TextInput.name`, `SelectionInput.name`, `DateTimePicker.name`, or `
1027
+ # DecoratedText.SwitchControl.name`). The structure of the map value object is
1028
+ # dependent on the widget type: **Note**: The following examples are formatted
1029
+ # for Apps Script's V8 runtime. If you're using Rhino runtime, you must add `[""]
1030
+ # ` after the value. For example, instead of `e.commonEventObject.formInputs.
1031
+ # employeeName.stringInputs.value[0]`, format the event object as `e.
1032
+ # commonEventObject.formInputs.employeeName[""].stringInputs.value[0]`. To learn
1033
+ # more about runtimes in Apps Script, see the [V8 Runtime Overview](https://
1034
+ # developers.google.com/apps-script/guides/v8-runtime). * Single-valued widgets (
1035
+ # for example, a `TextInput` widget, or a `SelectionInput` widget of type `
1036
+ # DROPDOWN` or `RADIO_BUTTON`): a `StringInputs` object containing a single-
1037
+ # element list (or an empty list if no selection is made). **Example**: for a
1038
+ # text input widget with `employeeName` as its `name`, access the text input
1039
+ # value with: `e.commonEventObject.formInputs.employeeName.stringInputs.value[0]`
1040
+ # . * Multi-valued widgets (for example, a `SelectionInput` widget of type `
1041
+ # CHECK_BOX`, `SWITCH`, or `MULTI_SELECT`): a `StringInputs` object containing
1042
+ # the list of selected item `value` strings. **Example**: for a multi-value
1043
+ # widget with `participants` as its `name`, access the value array with: `e.
1044
+ # commonEventObject.formInputs.participants.stringInputs.value`. * **A `
1045
+ # DecoratedText.SwitchControl` widget**: a `StringInputs` object. When `selected`
1046
+ # is `true`, `stringInputs.value` contains the switch's `value` field (or `""`
1047
+ # if `value` was not specified; if multiple switches share the same `name`, each
1048
+ # selected switch's `value` is included in the list). When `selected` is `false`,
1049
+ # the switch's `value` is omitted from `stringInputs.value`. * **A date-time
1050
+ # picker (`DateTimePickerType.DATE_AND_TIME`)**: a [`DateTimeInput object`](
1051
+ # https://developers.google.com/workspace/add-ons/concepts/event-objects#date-
1052
+ # time-input). **Example**: For a picker with a `name` of `myDTPicker`, access
1053
+ # the [`DateTimeInput`](https://developers.google.com/workspace/add-ons/concepts/
1054
+ # event-objects#date-time-input) object using `e.commonEventObject.formInputs.
1055
+ # myDTPicker.dateTimeInput`. * **A date-only picker (`DateTimePickerType.
1056
+ # DATE_ONLY`)**: a [`DateInput object`](https://developers.google.com/workspace/
1057
+ # add-ons/concepts/event-objects#date-input). **Example**: For a picker with a `
1058
+ # name` of `myDatePicker`, access the [`DateInput`](https://developers.google.
1059
+ # com/workspace/add-ons/concepts/event-objects#date-input) object using `e.
1060
+ # commonEventObject.formInputs.myDatePicker.dateInput`. * **A time-only picker (`
1061
+ # DateTimePickerType.TIME_ONLY`)**: a [`TimeInput object`](https://developers.
1062
+ # google.com/workspace/add-ons/concepts/event-objects#time-input). **Example**:
1063
+ # For a picker with a `name` of `myTimePicker`, access the [`TimeInput`](https://
1064
+ # developers.google.com/workspace/add-ons/concepts/event-objects#time-input)
1065
+ # object using `e.commonEventObject.formInputs.myTimePicker.timeInput`.
973
1066
  # Corresponds to the JSON property `formInputs`
974
1067
  # @return [Hash<String,Google::Apis::ChatV1::Inputs>]
975
1068
  attr_accessor :form_inputs
@@ -1582,6 +1675,60 @@ module Google
1582
1675
  end
1583
1676
  end
1584
1677
 
1678
+ # Elements are additional message components, including inline `citations` (
1679
+ # where each citation is associated with a specific portion of the message text)
1680
+ # and `cited_sources` (which are general references used to generate the
1681
+ # response and are not directly linked to specific segments of the text). Both `
1682
+ # citations` and `cited_sources` can be provided as input when creating or
1683
+ # updating a message and are populated on output when reading a message.
1684
+ class Elements
1685
+ include Google::Apis::Core::Hashable
1686
+
1687
+ # Optional. A list of inline citations referenced within the message text (via ``
1688
+ # tags) that render as interactive hover cards.
1689
+ # Corresponds to the JSON property `citations`
1690
+ # @return [Array<Google::Apis::ChatV1::Citation>]
1691
+ attr_accessor :citations
1692
+
1693
+ # Optional. A list of sources to be displayed under the message as footer links.
1694
+ # These are not referenced inline. For inline references, use `citations`.
1695
+ # Corresponds to the JSON property `citedSources`
1696
+ # @return [Array<Google::Apis::ChatV1::CitedSource>]
1697
+ attr_accessor :cited_sources
1698
+
1699
+ def initialize(**args)
1700
+ update!(**args)
1701
+ end
1702
+
1703
+ # Update properties of this object
1704
+ def update!(**args)
1705
+ @citations = args[:citations] if args.key?(:citations)
1706
+ @cited_sources = args[:cited_sources] if args.key?(:cited_sources)
1707
+ end
1708
+ end
1709
+
1710
+ # An object encapsulating different ways of representing an image. Currently
1711
+ # supported representations: * An image fetched from a URI. Additional
1712
+ # representations might be supported in the future.
1713
+ class ElementsImage
1714
+ include Google::Apis::Core::Hashable
1715
+
1716
+ # Required. The URI of the image. Must be a publicly accessible URI so that Chat
1717
+ # can fetch and display it.
1718
+ # Corresponds to the JSON property `imageUri`
1719
+ # @return [String]
1720
+ attr_accessor :image_uri
1721
+
1722
+ def initialize(**args)
1723
+ update!(**args)
1724
+ end
1725
+
1726
+ # Update properties of this object
1727
+ def update!(**args)
1728
+ @image_uri = args[:image_uri] if args.key?(:image_uri)
1729
+ end
1730
+ end
1731
+
1585
1732
  # An emoji that is used as a reaction to a message.
1586
1733
  class Emoji
1587
1734
  include Google::Apis::Core::Hashable
@@ -1675,6 +1822,26 @@ module Google
1675
1822
  end
1676
1823
  end
1677
1824
 
1825
+ # A footer for a source, used for attribution.
1826
+ class Footer
1827
+ include Google::Apis::Core::Hashable
1828
+
1829
+ # Optional. The plaintext to display in the footer. Does not support markdown
1830
+ # format.
1831
+ # Corresponds to the JSON property `text`
1832
+ # @return [String]
1833
+ attr_accessor :text
1834
+
1835
+ def initialize(**args)
1836
+ update!(**args)
1837
+ end
1838
+
1839
+ # Update properties of this object
1840
+ def update!(**args)
1841
+ @text = args[:text] if args.key?(:text)
1842
+ end
1843
+ end
1844
+
1678
1845
  # A form action describes the behavior when the form is submitted. For example,
1679
1846
  # you can invoke Apps Script to handle the form.
1680
1847
  class FormAction
@@ -2105,14 +2272,14 @@ module Google
2105
2272
  class GoogleAppsCardV1Card
2106
2273
  include Google::Apis::Core::Hashable
2107
2274
 
2108
- # The card's actions. Actions are added to the card's toolbar menu. [Google
2109
- # Workspace add-ons](https://developers.google.com/workspace/add-ons): For
2110
- # example, the following JSON constructs a card action menu with `Settings` and `
2111
- # Send Feedback` options: ``` "card_actions": [ ` "actionLabel": "Settings", "
2112
- # onClick": ` "action": ` "functionName": "goToView", "parameters": [ ` "key": "
2113
- # viewType", "value": "SETTING" ` ], "loadIndicator": "LoadIndicator.SPINNER" ` `
2114
- # `, ` "actionLabel": "Send Feedback", "onClick": ` "openLink": ` "url": "https:
2115
- # //example.com/feedback" ` ` ` ] ```
2275
+ # The card's actions. Actions are added to the card's toolbar menu. Supports up
2276
+ # to 10 `CardAction` items. [Google Workspace add-ons](https://developers.google.
2277
+ # com/workspace/add-ons): For example, the following JSON constructs a card
2278
+ # action menu with `Settings` and `Send Feedback` options: ``` "card_actions": [
2279
+ # ` "actionLabel": "Settings", "onClick": ` "action": ` "functionName": "
2280
+ # goToView", "parameters": [ ` "key": "viewType", "value": "SETTING" ` ], "
2281
+ # loadIndicator": "LoadIndicator.SPINNER" ` ` `, ` "actionLabel": "Send Feedback"
2282
+ # , "onClick": ` "openLink": ` "url": "https://example.com/feedback" ` ` ` ] ```
2116
2283
  # Corresponds to the JSON property `cardActions`
2117
2284
  # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1CardAction>]
2118
2285
  attr_accessor :card_actions
@@ -2319,15 +2486,14 @@ module Google
2319
2486
  end
2320
2487
  end
2321
2488
 
2322
- # A carousel, also known as a slider, rotates and displays a list of widgets in
2323
- # a slideshow format, with buttons navigating to the previous or next widget.
2324
- # For example, this is a JSON representation of a carousel that contains three
2325
- # text paragraph widgets. ``` ` "carouselCards": [ ` "widgets": [ ` "
2326
- # textParagraph": ` "text": "First text paragraph in carousel", ` ` ] `, ` "
2327
- # widgets": [ ` "textParagraph": ` "text": "Second text paragraph in carousel", `
2328
- # ` ] `, ` "widgets": [ ` "textParagraph": ` "text": "Third text paragraph in
2329
- # carousel", ` ` ] ` ] ` ``` [Google Chat apps](https://developers.google.com/
2330
- # workspace/chat):
2489
+ # Rotates and displays a list of carousel cards in a slideshow format, with
2490
+ # buttons navigating to the previous or next card. For example, this is a JSON
2491
+ # representation of a carousel that contains three text paragraph widgets. ``` `
2492
+ # "carouselCards": [ ` "widgets": [ ` "textParagraph": ` "text": "First text
2493
+ # paragraph in carousel" ` ` ] `, ` "widgets": [ ` "textParagraph": ` "text": "
2494
+ # Second text paragraph in carousel" ` ` ] `, ` "widgets": [ ` "textParagraph": `
2495
+ # "text": "Third text paragraph in carousel" ` ` ] ` ] ` ``` [Google Chat apps](
2496
+ # https://developers.google.com/workspace/chat):
2331
2497
  class GoogleAppsCardV1Carousel
2332
2498
  include Google::Apis::Core::Hashable
2333
2499
 
@@ -2394,8 +2560,8 @@ module Google
2394
2560
  attr_accessor :disabled
2395
2561
  alias_method :disabled?, :disabled
2396
2562
 
2397
- # Whether the chip is in an active state and responds to user actions. Defaults
2398
- # to `true`. Deprecated. Use `disabled` instead.
2563
+ # Deprecated: Use `disabled` instead. Whether the chip is in an active state and
2564
+ # responds to user actions.
2399
2565
  # Corresponds to the JSON property `enabled`
2400
2566
  # @return [Boolean]
2401
2567
  attr_accessor :enabled
@@ -2720,7 +2886,9 @@ module Google
2720
2886
 
2721
2887
  # The number representing the time zone offset from UTC, in minutes. If set, the
2722
2888
  # `value_ms_epoch` is displayed in the specified time zone. If unset, the value
2723
- # defaults to the user's time zone setting.
2889
+ # defaults to the user's time zone setting. Note: This field is in minutes,
2890
+ # whereas user interaction event payloads typically provide time zone offsets in
2891
+ # milliseconds (divide by `60000` to convert).
2724
2892
  # Corresponds to the JSON property `timezoneOffsetDate`
2725
2893
  # @return [Fixnum]
2726
2894
  attr_accessor :timezone_offset_date
@@ -3690,7 +3858,8 @@ module Google
3690
3858
  # @return [Fixnum]
3691
3859
  attr_accessor :uncollapsible_widgets_count
3692
3860
 
3693
- # All the widgets in the section. Must contain at least one widget.
3861
+ # All the widgets in the section. Must contain at least one widget. A card
3862
+ # supports up to 100 widgets across all sections.
3694
3863
  # Corresponds to the JSON property `widgets`
3695
3864
  # @return [Array<Google::Apis::ChatV1::GoogleAppsCardV1Widget>]
3696
3865
  attr_accessor :widgets
@@ -3950,9 +4119,10 @@ module Google
3950
4119
  # @return [String]
3951
4120
  attr_accessor :control_type
3952
4121
 
3953
- # The name by which the switch widget is identified in a form input event. For
3954
- # details about working with form inputs, see [Receive form data](https://
3955
- # developers.google.com/workspace/chat/read-form-data).
4122
+ # The name by which the switch widget is identified in a form input event (as
4123
+ # the key in `CommonEventObject.form_inputs`). For details about working with
4124
+ # form inputs, see [Receive form data](https://developers.google.com/workspace/
4125
+ # chat/read-form-data).
3956
4126
  # Corresponds to the JSON property `name`
3957
4127
  # @return [String]
3958
4128
  attr_accessor :name
@@ -3965,14 +4135,18 @@ module Google
3965
4135
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Action]
3966
4136
  attr_accessor :on_change_action
3967
4137
 
3968
- # When `true`, the switch is selected.
4138
+ # When `true`, the switch is selected, and its `value` is included in `
4139
+ # CommonEventObject.form_inputs[name].string_inputs.value`.
3969
4140
  # Corresponds to the JSON property `selected`
3970
4141
  # @return [Boolean]
3971
4142
  attr_accessor :selected
3972
4143
  alias_method :selected?, :selected
3973
4144
 
3974
- # The value entered by a user, returned as part of a form input event. For
3975
- # details about working with form inputs, see [Receive form data](https://
4145
+ # The value returned in `CommonEventObject.form_inputs[name].string_inputs` when
4146
+ # the switch is selected (`selected` is `true`). If `selected` is `true` and `
4147
+ # value` is unset, an empty string (`""`) is returned in `string_inputs.value`.
4148
+ # When `selected` is `false`, this value is omitted from `string_inputs.value`.
4149
+ # For details about working with form inputs, see [Receive form data](https://
3976
4150
  # developers.google.com/workspace/chat/read-form-data).
3977
4151
  # Corresponds to the JSON property `value`
3978
4152
  # @return [String]
@@ -4244,15 +4418,14 @@ module Google
4244
4418
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1ButtonList]
4245
4419
  attr_accessor :button_list
4246
4420
 
4247
- # A carousel, also known as a slider, rotates and displays a list of widgets in
4248
- # a slideshow format, with buttons navigating to the previous or next widget.
4249
- # For example, this is a JSON representation of a carousel that contains three
4250
- # text paragraph widgets. ``` ` "carouselCards": [ ` "widgets": [ ` "
4251
- # textParagraph": ` "text": "First text paragraph in carousel", ` ` ] `, ` "
4252
- # widgets": [ ` "textParagraph": ` "text": "Second text paragraph in carousel", `
4253
- # ` ] `, ` "widgets": [ ` "textParagraph": ` "text": "Third text paragraph in
4254
- # carousel", ` ` ] ` ] ` ``` [Google Chat apps](https://developers.google.com/
4255
- # workspace/chat):
4421
+ # Rotates and displays a list of carousel cards in a slideshow format, with
4422
+ # buttons navigating to the previous or next card. For example, this is a JSON
4423
+ # representation of a carousel that contains three text paragraph widgets. ``` `
4424
+ # "carouselCards": [ ` "widgets": [ ` "textParagraph": ` "text": "First text
4425
+ # paragraph in carousel" ` ` ] `, ` "widgets": [ ` "textParagraph": ` "text": "
4426
+ # Second text paragraph in carousel" ` ` ] `, ` "widgets": [ ` "textParagraph": `
4427
+ # "text": "Third text paragraph in carousel" ` ` ] ` ] ` ``` [Google Chat apps](
4428
+ # https://developers.google.com/workspace/chat):
4256
4429
  # Corresponds to the JSON property `carousel`
4257
4430
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Carousel]
4258
4431
  attr_accessor :carousel
@@ -5554,6 +5727,16 @@ module Google
5554
5727
  # @return [Google::Apis::ChatV1::DeletionMetadata]
5555
5728
  attr_accessor :deletion_metadata
5556
5729
 
5730
+ # Elements are additional message components, including inline `citations` (
5731
+ # where each citation is associated with a specific portion of the message text)
5732
+ # and `cited_sources` (which are general references used to generate the
5733
+ # response and are not directly linked to specific segments of the text). Both `
5734
+ # citations` and `cited_sources` can be provided as input when creating or
5735
+ # updating a message and are populated on output when reading a message.
5736
+ # Corresponds to the JSON property `elements`
5737
+ # @return [Google::Apis::ChatV1::Elements]
5738
+ attr_accessor :elements
5739
+
5557
5740
  # Output only. The list of emoji reaction summaries on the message.
5558
5741
  # Corresponds to the JSON property `emojiReactionSummaries`
5559
5742
  # @return [Array<Google::Apis::ChatV1::EmojiReactionSummary>]
@@ -5706,6 +5889,7 @@ module Google
5706
5889
  @create_time = args[:create_time] if args.key?(:create_time)
5707
5890
  @delete_time = args[:delete_time] if args.key?(:delete_time)
5708
5891
  @deletion_metadata = args[:deletion_metadata] if args.key?(:deletion_metadata)
5892
+ @elements = args[:elements] if args.key?(:elements)
5709
5893
  @emoji_reaction_summaries = args[:emoji_reaction_summaries] if args.key?(:emoji_reaction_summaries)
5710
5894
  @fallback_text = args[:fallback_text] if args.key?(:fallback_text)
5711
5895
  @formatted_text = args[:formatted_text] if args.key?(:formatted_text)
@@ -6367,6 +6551,41 @@ module Google
6367
6551
  end
6368
6552
  end
6369
6553
 
6554
+ # Request message for ReplaceMessageCards API method.
6555
+ class ReplaceMessageCardsRequest
6556
+ include Google::Apis::Core::Hashable
6557
+
6558
+ # Optional. An array of [cards](https://developers.google.com/workspace/chat/api/
6559
+ # reference/rest/v1/cards) to be included in the message. These cards will
6560
+ # replace the existing cards of the message. If empty, the original cards
6561
+ # included in the message will be cleared.
6562
+ # Corresponds to the JSON property `cardsV2`
6563
+ # @return [Array<Google::Apis::ChatV1::CardWithId>]
6564
+ attr_accessor :cards_v2
6565
+
6566
+ def initialize(**args)
6567
+ update!(**args)
6568
+ end
6569
+
6570
+ # Update properties of this object
6571
+ def update!(**args)
6572
+ @cards_v2 = args[:cards_v2] if args.key?(:cards_v2)
6573
+ end
6574
+ end
6575
+
6576
+ # Response message for ReplaceMessageCards API.
6577
+ class ReplaceMessageCardsResponse
6578
+ include Google::Apis::Core::Hashable
6579
+
6580
+ def initialize(**args)
6581
+ update!(**args)
6582
+ end
6583
+
6584
+ # Update properties of this object
6585
+ def update!(**args)
6586
+ end
6587
+ end
6588
+
6370
6589
  # A rich link to a resource. Rich links can be associated with the plain-text
6371
6590
  # body of the message or represent chips that link to Google Workspace resources
6372
6591
  # like Google Docs or Sheets with `start_index` and `length` of 0.
@@ -6898,6 +7117,38 @@ module Google
6898
7117
  end
6899
7118
  end
6900
7119
 
7120
+ # A snippet object representing an excerpt from a larger corpus.
7121
+ class Snippet
7122
+ include Google::Apis::Core::Hashable
7123
+
7124
+ # An object encapsulating different ways of representing an image. Currently
7125
+ # supported representations: * An image fetched from a URI. Additional
7126
+ # representations might be supported in the future.
7127
+ # Corresponds to the JSON property `imagePreview`
7128
+ # @return [Google::Apis::ChatV1::ElementsImage]
7129
+ attr_accessor :image_preview
7130
+
7131
+ # Optional. A short plaintext excerpt directly from the corpus that is rendered
7132
+ # in the citation hover card or source preview. When footer sources are
7133
+ # automatically populated from inline `citations` (because `Elements.
7134
+ # cited_sources` is not set), snippets are omitted from the deduplicated footer
7135
+ # sources. Does not support markdown format, and must not exceed 1,000
7136
+ # characters.
7137
+ # Corresponds to the JSON property `text`
7138
+ # @return [String]
7139
+ attr_accessor :text
7140
+
7141
+ def initialize(**args)
7142
+ update!(**args)
7143
+ end
7144
+
7145
+ # Update properties of this object
7146
+ def update!(**args)
7147
+ @image_preview = args[:image_preview] if args.key?(:image_preview)
7148
+ @text = args[:text] if args.key?(:text)
7149
+ end
7150
+ end
7151
+
6901
7152
  # A space in Google Chat. Spaces are conversations between two or more users or
6902
7153
  # 1:1 messages between a user and a Chat app.
6903
7154
  class Space
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module ChatV1
18
18
  # Version of the google-apis-chat_v1 gem
19
- GEM_VERSION = "0.157.0"
19
+ GEM_VERSION = "0.159.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.19.0"
22
+ GENERATOR_VERSION = "0.19.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20260927"
25
+ REVISION = "20261026"
26
26
  end
27
27
  end
28
28
  end
@@ -160,6 +160,18 @@ module Google
160
160
  include Google::Apis::Core::JsonObjectSupport
161
161
  end
162
162
 
163
+ class Citation
164
+ class Representation < Google::Apis::Core::JsonRepresentation; end
165
+
166
+ include Google::Apis::Core::JsonObjectSupport
167
+ end
168
+
169
+ class CitedSource
170
+ class Representation < Google::Apis::Core::JsonRepresentation; end
171
+
172
+ include Google::Apis::Core::JsonObjectSupport
173
+ end
174
+
163
175
  class Color
164
176
  class Representation < Google::Apis::Core::JsonRepresentation; end
165
177
 
@@ -262,6 +274,18 @@ module Google
262
274
  include Google::Apis::Core::JsonObjectSupport
263
275
  end
264
276
 
277
+ class Elements
278
+ class Representation < Google::Apis::Core::JsonRepresentation; end
279
+
280
+ include Google::Apis::Core::JsonObjectSupport
281
+ end
282
+
283
+ class ElementsImage
284
+ class Representation < Google::Apis::Core::JsonRepresentation; end
285
+
286
+ include Google::Apis::Core::JsonObjectSupport
287
+ end
288
+
265
289
  class Emoji
266
290
  class Representation < Google::Apis::Core::JsonRepresentation; end
267
291
 
@@ -286,6 +310,12 @@ module Google
286
310
  include Google::Apis::Core::JsonObjectSupport
287
311
  end
288
312
 
313
+ class Footer
314
+ class Representation < Google::Apis::Core::JsonRepresentation; end
315
+
316
+ include Google::Apis::Core::JsonObjectSupport
317
+ end
318
+
289
319
  class FormAction
290
320
  class Representation < Google::Apis::Core::JsonRepresentation; end
291
321
 
@@ -928,6 +958,18 @@ module Google
928
958
  include Google::Apis::Core::JsonObjectSupport
929
959
  end
930
960
 
961
+ class ReplaceMessageCardsRequest
962
+ class Representation < Google::Apis::Core::JsonRepresentation; end
963
+
964
+ include Google::Apis::Core::JsonObjectSupport
965
+ end
966
+
967
+ class ReplaceMessageCardsResponse
968
+ class Representation < Google::Apis::Core::JsonRepresentation; end
969
+
970
+ include Google::Apis::Core::JsonObjectSupport
971
+ end
972
+
931
973
  class RichLinkMetadata
932
974
  class Representation < Google::Apis::Core::JsonRepresentation; end
933
975
 
@@ -1000,6 +1042,12 @@ module Google
1000
1042
  include Google::Apis::Core::JsonObjectSupport
1001
1043
  end
1002
1044
 
1045
+ class Snippet
1046
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1047
+
1048
+ include Google::Apis::Core::JsonObjectSupport
1049
+ end
1050
+
1003
1051
  class Space
1004
1052
  class Representation < Google::Apis::Core::JsonRepresentation; end
1005
1053
 
@@ -1335,6 +1383,8 @@ module Google
1335
1383
  property :card, as: 'card', class: Google::Apis::ChatV1::GoogleAppsCardV1Card, decorator: Google::Apis::ChatV1::GoogleAppsCardV1Card::Representation
1336
1384
 
1337
1385
  property :card_id, as: 'cardId'
1386
+ property :owner_user, as: 'ownerUser', class: Google::Apis::ChatV1::User, decorator: Google::Apis::ChatV1::User::Representation
1387
+
1338
1388
  end
1339
1389
  end
1340
1390
 
@@ -1365,6 +1415,27 @@ module Google
1365
1415
  end
1366
1416
  end
1367
1417
 
1418
+ class Citation
1419
+ # @private
1420
+ class Representation < Google::Apis::Core::JsonRepresentation
1421
+ collection :cited_sources, as: 'citedSources', class: Google::Apis::ChatV1::CitedSource, decorator: Google::Apis::ChatV1::CitedSource::Representation
1422
+
1423
+ property :id, as: 'id'
1424
+ end
1425
+ end
1426
+
1427
+ class CitedSource
1428
+ # @private
1429
+ class Representation < Google::Apis::Core::JsonRepresentation
1430
+ property :footer, as: 'footer', class: Google::Apis::ChatV1::Footer, decorator: Google::Apis::ChatV1::Footer::Representation
1431
+
1432
+ property :snippet, as: 'snippet', class: Google::Apis::ChatV1::Snippet, decorator: Google::Apis::ChatV1::Snippet::Representation
1433
+
1434
+ property :title, as: 'title'
1435
+ property :uri, as: 'uri'
1436
+ end
1437
+ end
1438
+
1368
1439
  class Color
1369
1440
  # @private
1370
1441
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1534,6 +1605,23 @@ module Google
1534
1605
  end
1535
1606
  end
1536
1607
 
1608
+ class Elements
1609
+ # @private
1610
+ class Representation < Google::Apis::Core::JsonRepresentation
1611
+ collection :citations, as: 'citations', class: Google::Apis::ChatV1::Citation, decorator: Google::Apis::ChatV1::Citation::Representation
1612
+
1613
+ collection :cited_sources, as: 'citedSources', class: Google::Apis::ChatV1::CitedSource, decorator: Google::Apis::ChatV1::CitedSource::Representation
1614
+
1615
+ end
1616
+ end
1617
+
1618
+ class ElementsImage
1619
+ # @private
1620
+ class Representation < Google::Apis::Core::JsonRepresentation
1621
+ property :image_uri, as: 'imageUri'
1622
+ end
1623
+ end
1624
+
1537
1625
  class Emoji
1538
1626
  # @private
1539
1627
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1567,6 +1655,13 @@ module Google
1567
1655
  end
1568
1656
  end
1569
1657
 
1658
+ class Footer
1659
+ # @private
1660
+ class Representation < Google::Apis::Core::JsonRepresentation
1661
+ property :text, as: 'text'
1662
+ end
1663
+ end
1664
+
1570
1665
  class FormAction
1571
1666
  # @private
1572
1667
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2497,6 +2592,8 @@ module Google
2497
2592
  property :delete_time, as: 'deleteTime'
2498
2593
  property :deletion_metadata, as: 'deletionMetadata', class: Google::Apis::ChatV1::DeletionMetadata, decorator: Google::Apis::ChatV1::DeletionMetadata::Representation
2499
2594
 
2595
+ property :elements, as: 'elements', class: Google::Apis::ChatV1::Elements, decorator: Google::Apis::ChatV1::Elements::Representation
2596
+
2500
2597
  collection :emoji_reaction_summaries, as: 'emojiReactionSummaries', class: Google::Apis::ChatV1::EmojiReactionSummary, decorator: Google::Apis::ChatV1::EmojiReactionSummary::Representation
2501
2598
 
2502
2599
  property :fallback_text, as: 'fallbackText'
@@ -2738,6 +2835,20 @@ module Google
2738
2835
  end
2739
2836
  end
2740
2837
 
2838
+ class ReplaceMessageCardsRequest
2839
+ # @private
2840
+ class Representation < Google::Apis::Core::JsonRepresentation
2841
+ collection :cards_v2, as: 'cardsV2', class: Google::Apis::ChatV1::CardWithId, decorator: Google::Apis::ChatV1::CardWithId::Representation
2842
+
2843
+ end
2844
+ end
2845
+
2846
+ class ReplaceMessageCardsResponse
2847
+ # @private
2848
+ class Representation < Google::Apis::Core::JsonRepresentation
2849
+ end
2850
+ end
2851
+
2741
2852
  class RichLinkMetadata
2742
2853
  # @private
2743
2854
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2860,6 +2971,15 @@ module Google
2860
2971
  end
2861
2972
  end
2862
2973
 
2974
+ class Snippet
2975
+ # @private
2976
+ class Representation < Google::Apis::Core::JsonRepresentation
2977
+ property :image_preview, as: 'imagePreview', class: Google::Apis::ChatV1::ElementsImage, decorator: Google::Apis::ChatV1::ElementsImage::Representation
2978
+
2979
+ property :text, as: 'text'
2980
+ end
2981
+ end
2982
+
2863
2983
  class Space
2864
2984
  # @private
2865
2985
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1917,6 +1917,47 @@ module Google
1917
1917
  execute_or_queue_command(command, &block)
1918
1918
  end
1919
1919
 
1920
+ # Replaces the cards included in a message. A Chat app can only replace cards on
1921
+ # a human-created message if the message already contains cards, and the cards
1922
+ # were created by the app. If the app replaces the cards with an empty list, the
1923
+ # cards are removed. After removing the cards, the app cannot add cards back to
1924
+ # the message. Requires [app authentication](https://developers.google.com/
1925
+ # workspace/chat/authenticate-authorize-chat-app) with the [authorization scope](
1926
+ # https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-
1927
+ # scopes): - `https://www.googleapis.com/auth/chat.bot`
1928
+ # @param [String] name
1929
+ # Required. The resource name of the message. Format: `spaces/`space`/messages/`
1930
+ # message``
1931
+ # @param [Google::Apis::ChatV1::ReplaceMessageCardsRequest] replace_message_cards_request_object
1932
+ # @param [String] fields
1933
+ # Selector specifying which fields to include in a partial response.
1934
+ # @param [String] quota_user
1935
+ # Available to use for quota purposes for server-side applications. Can be any
1936
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1937
+ # @param [Google::Apis::RequestOptions] options
1938
+ # Request-specific options
1939
+ #
1940
+ # @yield [result, err] Result & error if block supplied
1941
+ # @yieldparam result [Google::Apis::ChatV1::ReplaceMessageCardsResponse] parsed result object
1942
+ # @yieldparam err [StandardError] error object if request failed
1943
+ #
1944
+ # @return [Google::Apis::ChatV1::ReplaceMessageCardsResponse]
1945
+ #
1946
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1947
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1948
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1949
+ def replace_space_message_cards(name, replace_message_cards_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1950
+ command = make_simple_command(:post, 'v1/{+name}:replaceCards', options)
1951
+ command.request_representation = Google::Apis::ChatV1::ReplaceMessageCardsRequest::Representation
1952
+ command.request_object = replace_message_cards_request_object
1953
+ command.response_representation = Google::Apis::ChatV1::ReplaceMessageCardsResponse::Representation
1954
+ command.response_class = Google::Apis::ChatV1::ReplaceMessageCardsResponse
1955
+ command.params['name'] = name unless name.nil?
1956
+ command.query['fields'] = fields unless fields.nil?
1957
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1958
+ execute_or_queue_command(command, &block)
1959
+ end
1960
+
1920
1961
  # Searches for messages in Google Chat that the calling user has access to.
1921
1962
  # Returns a list of messages matching the search criteria. To search across all
1922
1963
  # spaces the user has access to, set `parent` to `spaces/-`. Using any other
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-chat_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.157.0
4
+ version: 0.159.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.157.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.159.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
62
62
  rdoc_options: []
63
63
  require_paths: