google-apis-chat_v1 0.103.0 → 0.105.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9299c746df7364f6dac6b8ce99ca758b252e9dbd8cd5cdebc137ccd53183df52
4
- data.tar.gz: f60c2cc0f9cd13a95ccc5986a5da0761e04ca979097646744f45193ce6858bc0
3
+ metadata.gz: ee0b2d365042551e92ecf3215fe654b2c332c282760a95da6ed5abd151146e81
4
+ data.tar.gz: e25069ba9772bbf7aac4b544733d2ec7d00f58f275de6fe0c42d598ad45fe1c5
5
5
  SHA512:
6
- metadata.gz: 293d49333586d6f87b88475c0cd53d31c7d10cce7aa3d5ee0696e7b09de350956c9bd591716b3e37e9ade78cc883b1afc8dffc1ef435f1ff117ab24c8390ee42
7
- data.tar.gz: 9da5a760b2ecabde3cc6c24b2e0080b4e5698007a45fc6b0a4a30435ad4b534388a18ced701b7542c4a92bd0a464ae060326fa7bb18092c1651f47d9dc8d3f41
6
+ metadata.gz: 4d92d50cad3249a4c46a6b3df9921b4c123dcb3d1462198c5e30b7e0a52403c71cdf2c5ad462dc9d21c8c8665e33e65ec270bdfa4dd5fbde820604b962cf6d00
7
+ data.tar.gz: 2d7acdd82c3193f6e6b9802263929a5de35ccd5d692c42cb3bfdd9004cfbcee9afffeec96e121419b0503ee48037962f85dc33d5d23eefd23d0687ea30066934
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-chat_v1
2
2
 
3
+ ### v0.105.0 (2024-09-22)
4
+
5
+ * Regenerated from discovery document revision 20240912
6
+
7
+ ### v0.104.0 (2024-09-15)
8
+
9
+ * Regenerated from discovery document revision 20240908
10
+
3
11
  ### v0.103.0 (2024-09-01)
4
12
 
5
13
  * Regenerated from discovery document revision 20240825
@@ -590,6 +590,39 @@ module Google
590
590
  end
591
591
  end
592
592
 
593
+ # Data for Chat space links.
594
+ class ChatSpaceLinkData
595
+ include Google::Apis::Core::Hashable
596
+
597
+ # The message of the linked Chat space resource. Format: `spaces/`space`/
598
+ # messages/`message``
599
+ # Corresponds to the JSON property `message`
600
+ # @return [String]
601
+ attr_accessor :message
602
+
603
+ # The space of the linked Chat space resource. Format: `spaces/`space``
604
+ # Corresponds to the JSON property `space`
605
+ # @return [String]
606
+ attr_accessor :space
607
+
608
+ # The thread of the linked Chat space resource. Format: `spaces/`space`/threads/`
609
+ # thread``
610
+ # Corresponds to the JSON property `thread`
611
+ # @return [String]
612
+ attr_accessor :thread
613
+
614
+ def initialize(**args)
615
+ update!(**args)
616
+ end
617
+
618
+ # Update properties of this object
619
+ def update!(**args)
620
+ @message = args[:message] if args.key?(:message)
621
+ @space = args[:space] if args.key?(:space)
622
+ @thread = args[:thread] if args.key?(:thread)
623
+ end
624
+ end
625
+
593
626
  # Represents a color in the RGBA color space. This representation is designed
594
627
  # for simplicity of conversion to and from color representations in various
595
628
  # languages over compactness. For example, the fields of this representation can
@@ -1593,7 +1626,7 @@ module Google
1593
1626
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1CardHeader]
1594
1627
  attr_accessor :peek_card_header
1595
1628
 
1596
- # The divider style between sections.
1629
+ # The divider style between the header, sections and footer.
1597
1630
  # Corresponds to the JSON property `sectionDividerStyle`
1598
1631
  # @return [String]
1599
1632
  attr_accessor :section_divider_style
@@ -1800,9 +1833,12 @@ module Google
1800
1833
  # screen width is less than or equal to 480 pixels. * On iOS devices, the second
1801
1834
  # column wraps if the screen width is less than or equal to 300 pt. * On Android
1802
1835
  # devices, the second column wraps if the screen width is less than or equal to
1803
- # 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget.
1804
- # [Google Workspace Add-ons and Chat apps](https://developers.google.com/
1805
- # workspace/extend):
1836
+ # 320 dp. To include more than two columns, or to use rows, use the `Grid`
1837
+ # widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/
1838
+ # workspace/extend): The add-on UIs that support columns include: * The dialog
1839
+ # displayed when users open the add-on from an email draft. * The dialog
1840
+ # displayed when users open the add-on from the **Add attachment** menu in a
1841
+ # Google Calendar event.
1806
1842
  class GoogleAppsCardV1Columns
1807
1843
  include Google::Apis::Core::Hashable
1808
1844
 
@@ -2969,9 +3005,12 @@ module Google
2969
3005
  # screen width is less than or equal to 480 pixels. * On iOS devices, the second
2970
3006
  # column wraps if the screen width is less than or equal to 300 pt. * On Android
2971
3007
  # devices, the second column wraps if the screen width is less than or equal to
2972
- # 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget.
2973
- # [Google Workspace Add-ons and Chat apps](https://developers.google.com/
2974
- # workspace/extend):
3008
+ # 320 dp. To include more than two columns, or to use rows, use the `Grid`
3009
+ # widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/
3010
+ # workspace/extend): The add-on UIs that support columns include: * The dialog
3011
+ # displayed when users open the add-on from an email draft. * The dialog
3012
+ # displayed when users open the add-on from the **Add attachment** menu in a
3013
+ # Google Calendar event.
2975
3014
  # Corresponds to the JSON property `columns`
2976
3015
  # @return [Google::Apis::ChatV1::GoogleAppsCardV1Columns]
2977
3016
  attr_accessor :columns
@@ -3732,7 +3771,6 @@ module Google
3732
3771
  end
3733
3772
  end
3734
3773
 
3735
- # [Developer Preview](https://developers.google.com/workspace/preview).
3736
3774
  # Represents the count of memberships of a space, grouped into categories.
3737
3775
  class MembershipCount
3738
3776
  include Google::Apis::Core::Hashable
@@ -4375,6 +4413,11 @@ module Google
4375
4413
  class RichLinkMetadata
4376
4414
  include Google::Apis::Core::Hashable
4377
4415
 
4416
+ # Data for Chat space links.
4417
+ # Corresponds to the JSON property `chatSpaceLinkData`
4418
+ # @return [Google::Apis::ChatV1::ChatSpaceLinkData]
4419
+ attr_accessor :chat_space_link_data
4420
+
4378
4421
  # Data for Google Drive links.
4379
4422
  # Corresponds to the JSON property `driveLinkData`
4380
4423
  # @return [Google::Apis::ChatV1::DriveLinkData]
@@ -4396,6 +4439,7 @@ module Google
4396
4439
 
4397
4440
  # Update properties of this object
4398
4441
  def update!(**args)
4442
+ @chat_space_link_data = args[:chat_space_link_data] if args.key?(:chat_space_link_data)
4399
4443
  @drive_link_data = args[:drive_link_data] if args.key?(:drive_link_data)
4400
4444
  @rich_link_type = args[:rich_link_type] if args.key?(:rich_link_type)
4401
4445
  @uri = args[:uri] if args.key?(:uri)
@@ -4637,11 +4681,12 @@ module Google
4637
4681
  attr_accessor :create_time
4638
4682
 
4639
4683
  # The space's display name. Required when [creating a space](https://developers.
4640
- # google.com/workspace/chat/api/reference/rest/v1/spaces/create). If you receive
4641
- # the error message `ALREADY_EXISTS` when creating a space or updating the `
4642
- # displayName`, try a different `displayName`. An existing space within the
4643
- # Google Workspace organization might already use this display name. For direct
4644
- # messages, this field might be empty. Supports up to 128 characters.
4684
+ # google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `
4685
+ # spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when
4686
+ # creating a space or updating the `displayName`, try a different `displayName`.
4687
+ # An existing space within the Google Workspace organization might already use
4688
+ # this display name. For direct messages, this field might be empty. Supports up
4689
+ # to 128 characters.
4645
4690
  # Corresponds to the JSON property `displayName`
4646
4691
  # @return [String]
4647
4692
  attr_accessor :display_name
@@ -4665,13 +4710,11 @@ module Google
4665
4710
  attr_accessor :import_mode
4666
4711
  alias_method :import_mode?, :import_mode
4667
4712
 
4668
- # Output only. Timestamp of the last message in the space. [Developer Preview](
4669
- # https://developers.google.com/workspace/preview).
4713
+ # Output only. Timestamp of the last message in the space.
4670
4714
  # Corresponds to the JSON property `lastActiveTime`
4671
4715
  # @return [String]
4672
4716
  attr_accessor :last_active_time
4673
4717
 
4674
- # [Developer Preview](https://developers.google.com/workspace/preview).
4675
4718
  # Represents the count of memberships of a space, grouped into categories.
4676
4719
  # Corresponds to the JSON property `membershipCount`
4677
4720
  # @return [Google::Apis::ChatV1::MembershipCount]
@@ -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.103.0"
19
+ GEM_VERSION = "0.105.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.15.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20240825"
25
+ REVISION = "20240912"
26
26
  end
27
27
  end
28
28
  end
@@ -118,6 +118,12 @@ module Google
118
118
  include Google::Apis::Core::JsonObjectSupport
119
119
  end
120
120
 
121
+ class ChatSpaceLinkData
122
+ class Representation < Google::Apis::Core::JsonRepresentation; end
123
+
124
+ include Google::Apis::Core::JsonObjectSupport
125
+ end
126
+
121
127
  class Color
122
128
  class Representation < Google::Apis::Core::JsonRepresentation; end
123
129
 
@@ -967,6 +973,15 @@ module Google
967
973
  end
968
974
  end
969
975
 
976
+ class ChatSpaceLinkData
977
+ # @private
978
+ class Representation < Google::Apis::Core::JsonRepresentation
979
+ property :message, as: 'message'
980
+ property :space, as: 'space'
981
+ property :thread, as: 'thread'
982
+ end
983
+ end
984
+
970
985
  class Color
971
986
  # @private
972
987
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1901,6 +1916,8 @@ module Google
1901
1916
  class RichLinkMetadata
1902
1917
  # @private
1903
1918
  class Representation < Google::Apis::Core::JsonRepresentation
1919
+ property :chat_space_link_data, as: 'chatSpaceLinkData', class: Google::Apis::ChatV1::ChatSpaceLinkData, decorator: Google::Apis::ChatV1::ChatSpaceLinkData::Representation
1920
+
1904
1921
  property :drive_link_data, as: 'driveLinkData', class: Google::Apis::ChatV1::DriveLinkData, decorator: Google::Apis::ChatV1::DriveLinkData::Representation
1905
1922
 
1906
1923
  property :rich_link_type, as: 'richLinkType'
@@ -177,12 +177,15 @@ module Google
177
177
  execute_or_queue_command(command, &block)
178
178
  end
179
179
 
180
- # Creates a named space. Spaces grouped by topics aren't supported. For an
181
- # example, see [Create a space](https://developers.google.com/workspace/chat/
182
- # create-spaces). If you receive the error message `ALREADY_EXISTS` when
183
- # creating a space, try a different `displayName`. An existing space within the
184
- # Google Workspace organization might already use this display name. Requires [
185
- # user authentication](https://developers.google.com/workspace/chat/authenticate-
180
+ # Creates a space with no members. Can be used to create a named space. Spaces
181
+ # grouped by topics aren't supported. For an example, see [Create a space](https:
182
+ # //developers.google.com/workspace/chat/create-spaces). If you receive the
183
+ # error message `ALREADY_EXISTS` when creating a space, try a different `
184
+ # displayName`. An existing space within the Google Workspace organization might
185
+ # already use this display name. If you're a member of the [Developer Preview
186
+ # program](https://developers.google.com/workspace/preview), you can create a
187
+ # group chat in import mode using `spaceType.GROUP_CHAT`. Requires [user
188
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
186
189
  # authorize-chat-user).
187
190
  # @param [Google::Apis::ChatV1::Space] space_object
188
191
  # @param [String] request_id
@@ -228,8 +231,7 @@ module Google
228
231
  # @param [String] name
229
232
  # Required. Resource name of the space to delete. Format: `spaces/`space``
230
233
  # @param [Boolean] use_admin_access
231
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
232
- # true`, the method runs using the user's Google Workspace administrator
234
+ # When `true`, the method runs using the user's Google Workspace administrator
233
235
  # privileges. The calling user must be a Google Workspace administrator with the
234
236
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
235
237
  # answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://
@@ -321,8 +323,7 @@ module Google
321
323
  # Required. Resource name of the space, in the form `spaces/`space``. Format: `
322
324
  # spaces/`space``
323
325
  # @param [Boolean] use_admin_access
324
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
325
- # true`, the method runs using the user's Google Workspace administrator
326
+ # When `true`, the method runs using the user's Google Workspace administrator
326
327
  # privileges. The calling user must be a Google Workspace administrator with the
327
328
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
328
329
  # answer/13369245). Requires the `chat.admin.spaces` or `chat.admin.spaces.
@@ -469,8 +470,7 @@ module Google
469
470
  # other non-permission settings field paths). `permission_settings` is not
470
471
  # supported with admin access.
471
472
  # @param [Boolean] use_admin_access
472
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
473
- # true`, the method runs using the user's Google Workspace administrator
473
+ # When `true`, the method runs using the user's Google Workspace administrator
474
474
  # privileges. The calling user must be a Google Workspace administrator with the
475
475
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
476
476
  # answer/13369245). Requires the `chat.admin.spaces` [OAuth 2.0 scope](https://
@@ -508,11 +508,11 @@ module Google
508
508
  execute_or_queue_command(command, &block)
509
509
  end
510
510
 
511
- # [Developer Preview](https://developers.google.com/workspace/preview). Returns
512
- # a list of spaces based on a user's search. Requires [user authentication](
513
- # https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
514
- # The user must be an administrator for the Google Workspace organization. In
515
- # the request, set `use_admin_access` to `true`.
511
+ # Returns a list of spaces in a Google Workspace organization based on an
512
+ # administrator's search. Requires [user authentication with administrator
513
+ # privileges](https://developers.google.com/workspace/chat/authenticate-
514
+ # authorize-chat-user#admin-privileges). In the request, set `use_admin_access`
515
+ # to `true`.
516
516
  # @param [String] order_by
517
517
  # Optional. How the list of spaces is ordered. Supported attributes to order by
518
518
  # are: - `membership_count.joined_direct_human_user_count` — Denotes the count
@@ -692,8 +692,7 @@ module Google
692
692
  # Format: spaces/`space`
693
693
  # @param [Google::Apis::ChatV1::Membership] membership_object
694
694
  # @param [Boolean] use_admin_access
695
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
696
- # true`, the method runs using the user's Google Workspace administrator
695
+ # When `true`, the method runs using the user's Google Workspace administrator
697
696
  # privileges. The calling user must be a Google Workspace administrator with the
698
697
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
699
698
  # answer/13369245). Requires the `chat.admin.memberships` [OAuth 2.0 scope](
@@ -746,8 +745,7 @@ module Google
746
745
  # spaces/`space`/members/app` format. Format: `spaces/`space`/members/`member``
747
746
  # or `spaces/`space`/members/app`.
748
747
  # @param [Boolean] use_admin_access
749
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
750
- # true`, the method runs using the user's Google Workspace administrator
748
+ # When `true`, the method runs using the user's Google Workspace administrator
751
749
  # privileges. The calling user must be a Google Workspace administrator with the
752
750
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
753
751
  # answer/13369245). Requires the `chat.admin.memberships` [OAuth 2.0 scope](
@@ -800,8 +798,7 @@ module Google
800
798
  # example@gmail.com` where `example@gmail.com` is the email of the Google Chat
801
799
  # user.
802
800
  # @param [Boolean] use_admin_access
803
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
804
- # true`, the method runs using the user's Google Workspace administrator
801
+ # When `true`, the method runs using the user's Google Workspace administrator
805
802
  # privileges. The calling user must be a Google Workspace administrator with the
806
803
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
807
804
  # answer/13369245). Requires the `chat.admin.memberships` or `chat.admin.
@@ -857,16 +854,16 @@ module Google
857
854
  # spaces.members#membershiprole)) and type ([`member.type`](https://developers.
858
855
  # google.com/workspace/chat/api/reference/rest/v1/User#type)). To filter by role,
859
856
  # set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.
860
- # type` to `HUMAN` or `BOT`. Developer Preview: You can also filter for `member.
861
- # type` using the `!=` operator. To filter by both role and type, use the `AND`
862
- # operator. To filter by either role or type, use the `OR` operator. Either `
863
- # member.type = "HUMAN"` or `member.type != "BOT"` is required when `
864
- # use_admin_access` is set to true. Other member type filters will be rejected.
865
- # For example, the following queries are valid: ``` role = "ROLE_MANAGER" OR
866
- # role = "ROLE_MEMBER" member.type = "HUMAN" AND role = "ROLE_MANAGER" member.
867
- # type != "BOT" ``` The following queries are invalid: ``` member.type = "HUMAN"
868
- # AND member.type = "BOT" role = "ROLE_MANAGER" AND role = "ROLE_MEMBER" ```
869
- # Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.
857
+ # type` to `HUMAN` or `BOT`. You can also filter for `member.type` using the `!=`
858
+ # operator. To filter by both role and type, use the `AND` operator. To filter
859
+ # by either role or type, use the `OR` operator. Either `member.type = "HUMAN"`
860
+ # or `member.type != "BOT"` is required when `use_admin_access` is set to true.
861
+ # Other member type filters will be rejected. For example, the following queries
862
+ # are valid: ``` role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "
863
+ # HUMAN" AND role = "ROLE_MANAGER" member.type != "BOT" ``` The following
864
+ # queries are invalid: ``` member.type = "HUMAN" AND member.type = "BOT" role = "
865
+ # ROLE_MANAGER" AND role = "ROLE_MEMBER" ``` Invalid queries are rejected by the
866
+ # server with an `INVALID_ARGUMENT` error.
870
867
  # @param [Fixnum] page_size
871
868
  # Optional. The maximum number of memberships to return. The service might
872
869
  # return fewer than this value. If unspecified, at most 100 memberships are
@@ -890,8 +887,7 @@ module Google
890
887
  # Currently requires [user authentication](https://developers.google.com/
891
888
  # workspace/chat/authenticate-authorize-chat-user).
892
889
  # @param [Boolean] use_admin_access
893
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
894
- # true`, the method runs using the user's Google Workspace administrator
890
+ # When `true`, the method runs using the user's Google Workspace administrator
895
891
  # privileges. The calling user must be a Google Workspace administrator with the
896
892
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
897
893
  # answer/13369245). Requires either the `chat.admin.memberships.readonly` or `
@@ -943,8 +939,7 @@ module Google
943
939
  # Required. The field paths to update. Separate multiple values with commas or
944
940
  # use `*` to update all field paths. Currently supported field paths: - `role`
945
941
  # @param [Boolean] use_admin_access
946
- # [Developer Preview](https://developers.google.com/workspace/preview). When `
947
- # true`, the method runs using the user's Google Workspace administrator
942
+ # When `true`, the method runs using the user's Google Workspace administrator
948
943
  # privileges. The calling user must be a Google Workspace administrator with the
949
944
  # [manage chat and spaces conversations privilege](https://support.google.com/a/
950
945
  # answer/13369245). Requires the `chat.admin.memberships` [OAuth 2.0 scope](
@@ -45,6 +45,18 @@ module Google
45
45
  # View display name, description, and other metadata for all Google Chat conversations owned by your organization
46
46
  AUTH_CHAT_ADMIN_SPACES_READONLY = 'https://www.googleapis.com/auth/chat.admin.spaces.readonly'
47
47
 
48
+ # On their own behalf, apps in Google Chat can delete conversations and spaces and remove access to associated files
49
+ AUTH_CHAT_APP_DELETE = 'https://www.googleapis.com/auth/chat.app.delete'
50
+
51
+ # On their own behalf, apps in Google Chat can see, add, update, and remove members from conversations and spaces
52
+ AUTH_CHAT_APP_MEMBERSHIPS = 'https://www.googleapis.com/auth/chat.app.memberships'
53
+
54
+ # On their own behalf, apps in Google Chat can create conversations and spaces and see or update their metadata (including history settings and access settings)
55
+ AUTH_CHAT_APP_SPACES = 'https://www.googleapis.com/auth/chat.app.spaces'
56
+
57
+ # On their own behalf, apps in Google Chat can create conversations and spaces
58
+ AUTH_CHAT_APP_SPACES_CREATE = 'https://www.googleapis.com/auth/chat.app.spaces.create'
59
+
48
60
  # Private Service: https://www.googleapis.com/auth/chat.bot
49
61
  AUTH_CHAT_BOT = 'https://www.googleapis.com/auth/chat.bot'
50
62
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-chat_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.103.0
4
+ version: 0.105.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-09-01 00:00:00.000000000 Z
11
+ date: 2024-09-22 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.103.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.105.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-chat_v1
63
63
  post_install_message:
64
64
  rdoc_options: []