google-apis-chat_v1 0.106.0 → 0.108.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: 7a6974a9563fa880389e3ba51d72ef0abf787f0df66e8eadf6b4d7636adf84c6
4
- data.tar.gz: d1afdf4f0bc5b773a5a3d975a9a0afcf5f80990d0588639afc73f70636bd8dfb
3
+ metadata.gz: b3b10a9560d99c1c4f2e55cf71b2b46c25c4f660e03a17189c45cbc60812f20f
4
+ data.tar.gz: b199d92704e5e04ea1173a057c8e5b874d41051a368ad77ccdece5a2306f5c2a
5
5
  SHA512:
6
- metadata.gz: df8ec3e21a26f4411060e40e14dcf427e9948f376f5221dd48c975d4cbb869bbe3523967152cdce7e8d94541fd8621be747e765c7dc7be269bd17c5df2ab03a6
7
- data.tar.gz: 7ba8fca0b908e486ed7407b86fb6884b9b1ae501fd3c982635156d24c11c60c148fc9f9a72f88ead4c9804819d52be14f43ef7cfb3ed672504eb629fa2798b26
6
+ metadata.gz: bca48dbf825a068b3e40fee6863867f608cea46c67f28279841f15088a821754c3140466449637e1bd021914a3c6f85e4d83f964cd4a43bc48d9d55b9a5c430b
7
+ data.tar.gz: fd9a4b78f7842545660e1bf408976734e11c0f11929a4eb69c38208b6c2828f87db5d12c99be2b541d00266393097b8427cf5b2e34cd2f8bb4b138ab1f1201da
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-chat_v1
2
2
 
3
+ ### v0.108.0 (2024-10-13)
4
+
5
+ * Regenerated from discovery document revision 20241008
6
+
7
+ ### v0.107.0 (2024-10-06)
8
+
9
+ * Regenerated from discovery document revision 20241001
10
+
3
11
  ### v0.106.0 (2024-09-29)
4
12
 
5
13
  * Regenerated from discovery document revision 20240919
@@ -39,9 +39,17 @@ module Google
39
39
  # Make a space discoverable to a target audience](https://developers.google.com/
40
40
  # workspace/chat/space-target-audience). Format: `audiences/`audience`` To use
41
41
  # the default target audience for the Google Workspace organization, set to `
42
- # audiences/default`. This field is not populated when using the `chat.bot`
43
- # scope with [app authentication](https://developers.google.com/workspace/chat/
44
- # authenticate-authorize-chat-app).
42
+ # audiences/default`. Reading the target audience supports: - [User
43
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
44
+ # authorize-chat-user) - [App authentication](https://developers.google.com/
45
+ # workspace/chat/authenticate-authorize-chat-app) with [administrator approval](
46
+ # https://support.google.com/a?p=chat-app-auth) with the `chat.app.spaces` scope
47
+ # in [Developer Preview](https://developers.google.com/workspace/preview). This
48
+ # field is not populated when using the `chat.bot` scope with [app
49
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
50
+ # authorize-chat-app). Setting the target audience requires [user authentication]
51
+ # (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
52
+ # .
45
53
  # Corresponds to the JSON property `audience`
46
54
  # @return [String]
47
55
  attr_accessor :audience
@@ -3565,7 +3573,9 @@ module Google
3565
3573
  # @return [String]
3566
3574
  attr_accessor :next_page_token
3567
3575
 
3568
- # Results are returned in chronological order (oldest event first).
3576
+ # Results are returned in chronological order (oldest event first). Note: The `
3577
+ # permissionSettings` field is not returned in the Space object for list
3578
+ # requests.
3569
3579
  # Corresponds to the JSON property `spaceEvents`
3570
3580
  # @return [Array<Google::Apis::ChatV1::SpaceEvent>]
3571
3581
  attr_accessor :space_events
@@ -3591,7 +3601,8 @@ module Google
3591
3601
  # @return [String]
3592
3602
  attr_accessor :next_page_token
3593
3603
 
3594
- # List of spaces in the requested (or first) page.
3604
+ # List of spaces in the requested (or first) page. Note: The `permissionSettings`
3605
+ # field is not returned in the Space object for list requests.
3595
3606
  # Corresponds to the JSON property `spaces`
3596
3607
  # @return [Array<Google::Apis::ChatV1::Space>]
3597
3608
  attr_accessor :spaces
@@ -4269,6 +4280,97 @@ module Google
4269
4280
  end
4270
4281
  end
4271
4282
 
4283
+ # Represents a space permission setting.
4284
+ class PermissionSetting
4285
+ include Google::Apis::Core::Hashable
4286
+
4287
+ # Whether spaces managers have this permission.
4288
+ # Corresponds to the JSON property `managersAllowed`
4289
+ # @return [Boolean]
4290
+ attr_accessor :managers_allowed
4291
+ alias_method :managers_allowed?, :managers_allowed
4292
+
4293
+ # Whether non-manager members have this permission.
4294
+ # Corresponds to the JSON property `membersAllowed`
4295
+ # @return [Boolean]
4296
+ attr_accessor :members_allowed
4297
+ alias_method :members_allowed?, :members_allowed
4298
+
4299
+ def initialize(**args)
4300
+ update!(**args)
4301
+ end
4302
+
4303
+ # Update properties of this object
4304
+ def update!(**args)
4305
+ @managers_allowed = args[:managers_allowed] if args.key?(:managers_allowed)
4306
+ @members_allowed = args[:members_allowed] if args.key?(:members_allowed)
4307
+ end
4308
+ end
4309
+
4310
+ # [Permission settings](https://support.google.com/chat/answer/13340792) that
4311
+ # you can specify when updating an existing named space. To set permission
4312
+ # settings when creating a space, specify the `PredefinedPermissionSettings`
4313
+ # field in your request.
4314
+ class PermissionSettings
4315
+ include Google::Apis::Core::Hashable
4316
+
4317
+ # Represents a space permission setting.
4318
+ # Corresponds to the JSON property `manageApps`
4319
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4320
+ attr_accessor :manage_apps
4321
+
4322
+ # Represents a space permission setting.
4323
+ # Corresponds to the JSON property `manageMembersAndGroups`
4324
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4325
+ attr_accessor :manage_members_and_groups
4326
+
4327
+ # Represents a space permission setting.
4328
+ # Corresponds to the JSON property `manageWebhooks`
4329
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4330
+ attr_accessor :manage_webhooks
4331
+
4332
+ # Represents a space permission setting.
4333
+ # Corresponds to the JSON property `modifySpaceDetails`
4334
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4335
+ attr_accessor :modify_space_details
4336
+
4337
+ # Represents a space permission setting.
4338
+ # Corresponds to the JSON property `postMessages`
4339
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4340
+ attr_accessor :post_messages
4341
+
4342
+ # Represents a space permission setting.
4343
+ # Corresponds to the JSON property `replyMessages`
4344
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4345
+ attr_accessor :reply_messages
4346
+
4347
+ # Represents a space permission setting.
4348
+ # Corresponds to the JSON property `toggleHistory`
4349
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4350
+ attr_accessor :toggle_history
4351
+
4352
+ # Represents a space permission setting.
4353
+ # Corresponds to the JSON property `useAtMentionAll`
4354
+ # @return [Google::Apis::ChatV1::PermissionSetting]
4355
+ attr_accessor :use_at_mention_all
4356
+
4357
+ def initialize(**args)
4358
+ update!(**args)
4359
+ end
4360
+
4361
+ # Update properties of this object
4362
+ def update!(**args)
4363
+ @manage_apps = args[:manage_apps] if args.key?(:manage_apps)
4364
+ @manage_members_and_groups = args[:manage_members_and_groups] if args.key?(:manage_members_and_groups)
4365
+ @manage_webhooks = args[:manage_webhooks] if args.key?(:manage_webhooks)
4366
+ @modify_space_details = args[:modify_space_details] if args.key?(:modify_space_details)
4367
+ @post_messages = args[:post_messages] if args.key?(:post_messages)
4368
+ @reply_messages = args[:reply_messages] if args.key?(:reply_messages)
4369
+ @toggle_history = args[:toggle_history] if args.key?(:toggle_history)
4370
+ @use_at_mention_all = args[:use_at_mention_all] if args.key?(:use_at_mention_all)
4371
+ end
4372
+ end
4373
+
4272
4374
  # Information about a quoted message.
4273
4375
  class QuotedMessageMetadata
4274
4376
  include Google::Apis::Core::Hashable
@@ -4706,7 +4808,9 @@ module Google
4706
4808
 
4707
4809
  # Optional. Whether this space is created in `Import Mode` as part of a data
4708
4810
  # migration into Google Workspace. While spaces are being imported, they aren't
4709
- # visible to users until the import is complete.
4811
+ # visible to users until the import is complete. Creating a space in `Import
4812
+ # Mode`requires [user authentication](https://developers.google.com/workspace/
4813
+ # chat/authenticate-authorize-chat-user).
4710
4814
  # Corresponds to the JSON property `importMode`
4711
4815
  # @return [Boolean]
4712
4816
  attr_accessor :import_mode
@@ -4732,6 +4836,22 @@ module Google
4732
4836
  # @return [String]
4733
4837
  attr_accessor :name
4734
4838
 
4839
+ # [Permission settings](https://support.google.com/chat/answer/13340792) that
4840
+ # you can specify when updating an existing named space. To set permission
4841
+ # settings when creating a space, specify the `PredefinedPermissionSettings`
4842
+ # field in your request.
4843
+ # Corresponds to the JSON property `permissionSettings`
4844
+ # @return [Google::Apis::ChatV1::PermissionSettings]
4845
+ attr_accessor :permission_settings
4846
+
4847
+ # Optional. Input only. Predefined space permission settings, input only when
4848
+ # creating a space. If the field is not set, a collaboration space is created.
4849
+ # After you create the space, settings are populated in the `PermissionSettings`
4850
+ # field.
4851
+ # Corresponds to the JSON property `predefinedPermissionSettings`
4852
+ # @return [String]
4853
+ attr_accessor :predefined_permission_settings
4854
+
4735
4855
  # Optional. Whether the space is a DM between a Chat app and a single human.
4736
4856
  # Corresponds to the JSON property `singleUserBotDm`
4737
4857
  # @return [Boolean]
@@ -4791,6 +4911,8 @@ module Google
4791
4911
  @last_active_time = args[:last_active_time] if args.key?(:last_active_time)
4792
4912
  @membership_count = args[:membership_count] if args.key?(:membership_count)
4793
4913
  @name = args[:name] if args.key?(:name)
4914
+ @permission_settings = args[:permission_settings] if args.key?(:permission_settings)
4915
+ @predefined_permission_settings = args[:predefined_permission_settings] if args.key?(:predefined_permission_settings)
4794
4916
  @single_user_bot_dm = args[:single_user_bot_dm] if args.key?(:single_user_bot_dm)
4795
4917
  @space_details = args[:space_details] if args.key?(:space_details)
4796
4918
  @space_history_state = args[:space_history_state] if args.key?(:space_history_state)
@@ -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.106.0"
19
+ GEM_VERSION = "0.108.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 = "20240919"
25
+ REVISION = "20241008"
26
26
  end
27
27
  end
28
28
  end
@@ -610,6 +610,18 @@ module Google
610
610
  include Google::Apis::Core::JsonObjectSupport
611
611
  end
612
612
 
613
+ class PermissionSetting
614
+ class Representation < Google::Apis::Core::JsonRepresentation; end
615
+
616
+ include Google::Apis::Core::JsonObjectSupport
617
+ end
618
+
619
+ class PermissionSettings
620
+ class Representation < Google::Apis::Core::JsonRepresentation; end
621
+
622
+ include Google::Apis::Core::JsonObjectSupport
623
+ end
624
+
613
625
  class QuotedMessageMetadata
614
626
  class Representation < Google::Apis::Core::JsonRepresentation; end
615
627
 
@@ -1862,6 +1874,36 @@ module Google
1862
1874
  end
1863
1875
  end
1864
1876
 
1877
+ class PermissionSetting
1878
+ # @private
1879
+ class Representation < Google::Apis::Core::JsonRepresentation
1880
+ property :managers_allowed, as: 'managersAllowed'
1881
+ property :members_allowed, as: 'membersAllowed'
1882
+ end
1883
+ end
1884
+
1885
+ class PermissionSettings
1886
+ # @private
1887
+ class Representation < Google::Apis::Core::JsonRepresentation
1888
+ property :manage_apps, as: 'manageApps', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1889
+
1890
+ property :manage_members_and_groups, as: 'manageMembersAndGroups', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1891
+
1892
+ property :manage_webhooks, as: 'manageWebhooks', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1893
+
1894
+ property :modify_space_details, as: 'modifySpaceDetails', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1895
+
1896
+ property :post_messages, as: 'postMessages', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1897
+
1898
+ property :reply_messages, as: 'replyMessages', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1899
+
1900
+ property :toggle_history, as: 'toggleHistory', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1901
+
1902
+ property :use_at_mention_all, as: 'useAtMentionAll', class: Google::Apis::ChatV1::PermissionSetting, decorator: Google::Apis::ChatV1::PermissionSetting::Representation
1903
+
1904
+ end
1905
+ end
1906
+
1865
1907
  class QuotedMessageMetadata
1866
1908
  # @private
1867
1909
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1996,6 +2038,9 @@ module Google
1996
2038
  property :membership_count, as: 'membershipCount', class: Google::Apis::ChatV1::MembershipCount, decorator: Google::Apis::ChatV1::MembershipCount::Representation
1997
2039
 
1998
2040
  property :name, as: 'name'
2041
+ property :permission_settings, as: 'permissionSettings', class: Google::Apis::ChatV1::PermissionSettings, decorator: Google::Apis::ChatV1::PermissionSettings::Representation
2042
+
2043
+ property :predefined_permission_settings, as: 'predefinedPermissionSettings'
1999
2044
  property :single_user_bot_dm, as: 'singleUserBotDm'
2000
2045
  property :space_details, as: 'spaceDetails', class: Google::Apis::ChatV1::SpaceDetails, decorator: Google::Apis::ChatV1::SpaceDetails::Representation
2001
2046
 
@@ -141,8 +141,9 @@ module Google
141
141
  end
142
142
 
143
143
  # Completes the [import process](https://developers.google.com/workspace/chat/
144
- # import-data) for the specified space and makes it visible to users. Requires
145
- # app authentication and domain-wide delegation. For more information, see [
144
+ # import-data) for the specified space and makes it visible to users. Requires [
145
+ # app authentication](https://developers.google.com/workspace/chat/authenticate-
146
+ # authorize-chat-app) and domain-wide delegation. For more information, see [
146
147
  # Authorize Google Chat apps to import data](https://developers.google.com/
147
148
  # workspace/chat/authorize-import).
148
149
  # @param [String] name
@@ -184,9 +185,15 @@ module Google
184
185
  # displayName`. An existing space within the Google Workspace organization might
185
186
  # already use this display name. If you're a member of the [Developer Preview
186
187
  # 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-
189
- # authorize-chat-user).
188
+ # group chat in import mode using `spaceType.GROUP_CHAT`. Supports the following
189
+ # types of [authentication](https://developers.google.com/workspace/chat/
190
+ # authenticate-authorize): - [App authentication](https://developers.google.com/
191
+ # workspace/chat/authenticate-authorize-chat-app) with [administrator approval](
192
+ # https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://
193
+ # developers.google.com/workspace/preview) - [User authentication](https://
194
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-user) When
195
+ # authenticating as an app, the `space.customer` field must be set in the
196
+ # request.
190
197
  # @param [Google::Apis::ChatV1::Space] space_object
191
198
  # @param [String] request_id
192
199
  # Optional. A unique identifier for this request. A random UUID is recommended.
@@ -225,9 +232,15 @@ module Google
225
232
  # Deletes a named space. Always performs a cascading delete, which means that
226
233
  # the space's child resources—like messages posted in the space and memberships
227
234
  # in the space—are also deleted. For an example, see [Delete a space](https://
228
- # developers.google.com/workspace/chat/delete-spaces). Requires [user
229
- # authentication](https://developers.google.com/workspace/chat/authenticate-
230
- # authorize-chat-user) from a user who has permission to delete the space.
235
+ # developers.google.com/workspace/chat/delete-spaces). Supports the following
236
+ # types of [authentication](https://developers.google.com/workspace/chat/
237
+ # authenticate-authorize): - [App authentication](https://developers.google.com/
238
+ # workspace/chat/authenticate-authorize-chat-app) with [administrator approval](
239
+ # https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://
240
+ # developers.google.com/workspace/preview) - [User authentication](https://
241
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-user) You can
242
+ # authenticate and authorize this method with administrator privileges by
243
+ # setting the `use_admin_access` field in the request.
231
244
  # @param [String] name
232
245
  # Required. Resource name of the space to delete. Format: `spaces/`space``
233
246
  # @param [Boolean] use_admin_access
@@ -267,14 +280,16 @@ module Google
267
280
  # Returns the existing direct message with the specified user. If no direct
268
281
  # message space is found, returns a `404 NOT_FOUND` error. For an example, see [
269
282
  # Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [
270
- # user authentication](https://developers.google.com/workspace/chat/authenticate-
271
- # authorize-chat-user), returns the direct message space between the specified
272
- # user and the authenticated user. With [app authentication](https://developers.
273
- # google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct
274
- # message space between the specified user and the calling Chat app. Requires [
275
- # user authentication](https://developers.google.com/workspace/chat/authenticate-
276
- # authorize-chat-user) or [app authentication](https://developers.google.com/
277
- # workspace/chat/authenticate-authorize-chat-app).
283
+ # app authentication](https://developers.google.com/workspace/chat/authenticate-
284
+ # authorize-chat-app), returns the direct message space between the specified
285
+ # user and the calling Chat app. With [user authentication](https://developers.
286
+ # google.com/workspace/chat/authenticate-authorize-chat-user), returns the
287
+ # direct message space between the specified user and the authenticated user. //
288
+ # Supports the following types of [authentication](https://developers.google.com/
289
+ # workspace/chat/authenticate-authorize): - [App authentication](https://
290
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User
291
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
292
+ # authorize-chat-user)
278
293
  # @param [String] name
279
294
  # Required. Resource name of the user to find direct message with. Format: `
280
295
  # users/`user``, where ``user`` is either the `id` for the [person](https://
@@ -314,11 +329,13 @@ module Google
314
329
  end
315
330
 
316
331
  # Returns details about a space. For an example, see [Get details about a space](
317
- # https://developers.google.com/workspace/chat/get-spaces). Requires [
318
- # authentication](https://developers.google.com/workspace/chat/authenticate-
319
- # authorize). Supports [app authentication](https://developers.google.com/
320
- # workspace/chat/authenticate-authorize-chat-app) and [user authentication](
321
- # https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
332
+ # https://developers.google.com/workspace/chat/get-spaces). Supports the
333
+ # following types of [authentication](https://developers.google.com/workspace/
334
+ # chat/authenticate-authorize): - [App authentication](https://developers.google.
335
+ # com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](
336
+ # https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
337
+ # You can authenticate and authorize this method with administrator privileges
338
+ # by setting the `use_admin_access` field in the request.
322
339
  # @param [String] name
323
340
  # Required. Resource name of the space, in the form `spaces/`space``. Format: `
324
341
  # spaces/`space``
@@ -359,16 +376,14 @@ module Google
359
376
 
360
377
  # Lists spaces the caller is a member of. Group chats and DMs aren't listed
361
378
  # until the first message is sent. For an example, see [List spaces](https://
362
- # developers.google.com/workspace/chat/list-spaces). Requires [authentication](
363
- # https://developers.google.com/workspace/chat/authenticate-authorize). Supports
364
- # [app authentication](https://developers.google.com/workspace/chat/authenticate-
365
- # authorize-chat-app) and [user authentication](https://developers.google.com/
366
- # workspace/chat/authenticate-authorize-chat-user). Lists spaces visible to the
367
- # caller or authenticated user. Group chats and DMs aren't listed until the
368
- # first message is sent. To list all named spaces by Google Workspace
369
- # organization, use the [`spaces.search()`](https://developers.google.com/
370
- # workspace/chat/api/reference/rest/v1/spaces/search) method using Workspace
371
- # administrator privileges instead.
379
+ # developers.google.com/workspace/chat/list-spaces). Supports the following
380
+ # types of [authentication](https://developers.google.com/workspace/chat/
381
+ # authenticate-authorize): - [App authentication](https://developers.google.com/
382
+ # workspace/chat/authenticate-authorize-chat-app) - [User authentication](https:/
383
+ # /developers.google.com/workspace/chat/authenticate-authorize-chat-user) To
384
+ # list all named spaces by Google Workspace organization, use the [`spaces.
385
+ # search()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/
386
+ # spaces/search) method using Workspace administrator privileges instead.
372
387
  # @param [String] filter
373
388
  # Optional. A query filter. You can filter spaces by the space type ([`
374
389
  # space_type`](https://developers.google.com/workspace/chat/api/reference/rest/
@@ -421,8 +436,15 @@ module Google
421
436
  # google.com/workspace/chat/update-spaces). If you're updating the `displayName`
422
437
  # field and receive the error message `ALREADY_EXISTS`, try a different display
423
438
  # name.. An existing space within the Google Workspace organization might
424
- # already use this display name. Requires [user authentication](https://
425
- # developers.google.com/workspace/chat/authenticate-authorize-chat-user).
439
+ # already use this display name. Supports the following types of [authentication]
440
+ # (https://developers.google.com/workspace/chat/authenticate-authorize): - [App
441
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
442
+ # authorize-chat-app) with [administrator approval](https://support.google.com/a?
443
+ # p=chat-app-auth) in [Developer Preview](https://developers.google.com/
444
+ # workspace/preview) - [User authentication](https://developers.google.com/
445
+ # workspace/chat/authenticate-authorize-chat-user) You can authenticate and
446
+ # authorize this method with administrator privileges by setting the `
447
+ # use_admin_access` field in the request.
426
448
  # @param [String] name
427
449
  # Resource name of the space. Format: `spaces/`space`` Where ``space``
428
450
  # represents the system-assigned ID for the space. You can obtain the space ID
@@ -433,23 +455,24 @@ module Google
433
455
  # @param [Google::Apis::ChatV1::Space] space_object
434
456
  # @param [String] update_mask
435
457
  # Required. The updated field paths, comma separated if there are multiple. You
436
- # can update the following fields for a space: - `space_details` - `display_name`
437
- # : Only supports updating the display name for spaces where `spaceType` field
438
- # is `SPACE`. If you receive the error message `ALREADY_EXISTS`, try a different
458
+ # can update the following fields for a space: `space_details`: Updates the
459
+ # space's description. Supports up to 150 characters. `display_name`: Only
460
+ # supports updating the display name for spaces where `spaceType` field is `
461
+ # SPACE`. If you receive the error message `ALREADY_EXISTS`, try a different
439
462
  # value. An existing space within the Google Workspace organization might
440
- # already use this display name. - `space_type`: Only supports changing a `
463
+ # already use this display name. `space_type`: Only supports changing a `
441
464
  # GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `
442
465
  # space_type` in the update mask and ensure that the specified space has a non-
443
466
  # empty display name and the `SPACE` space type. Including the `space_type` mask
444
467
  # and the `SPACE` type in the specified space when updating the display name is
445
468
  # optional if the existing space already has the `SPACE` type. Trying to update
446
469
  # the space type in other ways results in an invalid argument error. `space_type`
447
- # is not supported with admin access. - `space_history_state`: Updates [space
470
+ # is not supported with `useAdminAccess`. `space_history_state`: Updates [space
448
471
  # history settings](https://support.google.com/chat/answer/7664687) by turning
449
472
  # history on or off for the space. Only supported if history settings are
450
473
  # enabled for the Google Workspace organization. To update the space history
451
474
  # state, you must omit all other field masks in your request. `
452
- # space_history_state` is not supported with admin access. - `access_settings.
475
+ # space_history_state` is not supported with `useAdminAccess`. `access_settings.
453
476
  # audience`: Updates the [access setting](https://support.google.com/chat/answer/
454
477
  # 11971020) of who can discover the space, join the space, and preview the
455
478
  # messages in named space where `spaceType` field is `SPACE`. If the existing
@@ -460,15 +483,16 @@ module Google
460
483
  # import mode](https://developers.google.com/workspace/chat/import-data-overview)
461
484
  # . To learn more, see [Make a space discoverable to specific users](https://
462
485
  # developers.google.com/workspace/chat/space-target-audience). `access_settings.
463
- # audience` is not supported with admin access. - Developer Preview: Supports
464
- # changing the [permission settings](https://support.google.com/chat/answer/
465
- # 13340792) of a space, supported field paths include: `permission_settings.
466
- # manage_members_and_groups`, `permission_settings.modify_space_details`, `
467
- # permission_settings.toggle_history`, `permission_settings.use_at_mention_all`,
468
- # `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `
469
- # permission_settings.reply_messages` (Warning: mutually exclusive with all
470
- # other non-permission settings field paths). `permission_settings` is not
471
- # supported with admin access.
486
+ # audience` is not supported with `useAdminAccess`. `permission_settings`:
487
+ # Supports changing the [permission settings](https://support.google.com/chat/
488
+ # answer/13340792) of a space. When updating permission settings, you can only
489
+ # specify `permissionSettings` field masks; you cannot update other field masks
490
+ # at the same time. `permissionSettings` is not supported with `useAdminAccess`.
491
+ # The supported field masks include: - `permission_settings.
492
+ # manageMembersAndGroups` - `permission_settings.modifySpaceDetails` - `
493
+ # permission_settings.toggleHistory` - `permission_settings.useAtMentionAll` - `
494
+ # permission_settings.manageApps` - `permission_settings.manageWebhooks` - `
495
+ # permission_settings.replyMessages`
472
496
  # @param [Boolean] use_admin_access
473
497
  # When `true`, the method runs using the user's Google Workspace administrator
474
498
  # privileges. The calling user must be a Google Workspace administrator with the
@@ -680,13 +704,20 @@ module Google
680
704
  # membership, if the specified member has their auto-accept policy turned off,
681
705
  # then they're invited, and must accept the space invitation before joining.
682
706
  # Otherwise, creating a membership adds the member directly to the specified
683
- # space. Requires [user authentication](https://developers.google.com/workspace/
684
- # chat/authenticate-authorize-chat-user). For example usage, see: - [Invite or
685
- # add a user to a space](https://developers.google.com/workspace/chat/create-
686
- # members#create-user-membership). - [Invite or add a Google Group to a space](
687
- # https://developers.google.com/workspace/chat/create-members#create-group-
688
- # membership). - [Add the Chat app to a space](https://developers.google.com/
689
- # workspace/chat/create-members#create-membership-calling-api).
707
+ # space. Supports the following types of [authentication](https://developers.
708
+ # google.com/workspace/chat/authenticate-authorize): - [App authentication](
709
+ # https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
710
+ # with [administrator approval](https://support.google.com/a?p=chat-app-auth) in
711
+ # [Developer Preview](https://developers.google.com/workspace/preview) - [User
712
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
713
+ # authorize-chat-user) You can authenticate and authorize this method with
714
+ # administrator privileges by setting the `use_admin_access` field in the
715
+ # request. For example usage, see: - [Invite or add a user to a space](https://
716
+ # developers.google.com/workspace/chat/create-members#create-user-membership). -
717
+ # [Invite or add a Google Group to a space](https://developers.google.com/
718
+ # workspace/chat/create-members#create-group-membership). - [Add the Chat app to
719
+ # a space](https://developers.google.com/workspace/chat/create-members#create-
720
+ # membership-calling-api).
690
721
  # @param [String] parent
691
722
  # Required. The resource name of the space for which to create the membership.
692
723
  # Format: spaces/`space`
@@ -732,8 +763,15 @@ module Google
732
763
 
733
764
  # Deletes a membership. For an example, see [Remove a user or a Google Chat app
734
765
  # from a space](https://developers.google.com/workspace/chat/delete-members).
735
- # Requires [user authentication](https://developers.google.com/workspace/chat/
736
- # authenticate-authorize-chat-user).
766
+ # Supports the following types of [authentication](https://developers.google.com/
767
+ # workspace/chat/authenticate-authorize): - [App authentication](https://
768
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [
769
+ # administrator approval](https://support.google.com/a?p=chat-app-auth) in [
770
+ # Developer Preview](https://developers.google.com/workspace/preview) - [User
771
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
772
+ # authorize-chat-user) You can authenticate and authorize this method with
773
+ # administrator privileges by setting the `use_admin_access` field in the
774
+ # request.
737
775
  # @param [String] name
738
776
  # Required. Resource name of the membership to delete. Chat apps can delete
739
777
  # human users' or their own memberships. Chat apps can't delete other apps'
@@ -782,21 +820,21 @@ module Google
782
820
 
783
821
  # Returns details about a membership. For an example, see [Get details about a
784
822
  # user's or Google Chat app's membership](https://developers.google.com/
785
- # workspace/chat/get-members). Requires [authentication](https://developers.
786
- # google.com/workspace/chat/authenticate-authorize). Supports [app
823
+ # workspace/chat/get-members). Supports the following types of [authentication](
824
+ # https://developers.google.com/workspace/chat/authenticate-authorize): - [App
787
825
  # authentication](https://developers.google.com/workspace/chat/authenticate-
788
- # authorize-chat-app) and [user authentication](https://developers.google.com/
789
- # workspace/chat/authenticate-authorize-chat-user).
826
+ # authorize-chat-app) - [User authentication](https://developers.google.com/
827
+ # workspace/chat/authenticate-authorize-chat-user) You can authenticate and
828
+ # authorize this method with administrator privileges by setting the `
829
+ # use_admin_access` field in the request.
790
830
  # @param [String] name
791
831
  # Required. Resource name of the membership to retrieve. To get the app's own
792
832
  # membership [by using user authentication](https://developers.google.com/
793
833
  # workspace/chat/authenticate-authorize-chat-user), you can optionally use `
794
834
  # spaces/`space`/members/app`. Format: `spaces/`space`/members/`member`` or `
795
- # spaces/`space`/members/app` When [authenticated as a user](https://developers.
796
- # google.com/workspace/chat/authenticate-authorize-chat-user), you can use the
797
- # user's email as an alias for ``member``. For example, `spaces/`space`/members/
798
- # example@gmail.com` where `example@gmail.com` is the email of the Google Chat
799
- # user.
835
+ # spaces/`space`/members/app` You can use the user's email as an alias for ``
836
+ # member``. For example, `spaces/`space`/members/example@gmail.com` where `
837
+ # example@gmail.com` is the email of the Google Chat user.
800
838
  # @param [Boolean] use_admin_access
801
839
  # When `true`, the method runs using the user's Google Workspace administrator
802
840
  # privileges. The calling user must be a Google Workspace administrator with the
@@ -840,11 +878,13 @@ module Google
840
878
  # that the Chat app has access to, but excludes Chat app memberships, including
841
879
  # its own. Listing memberships with [User authentication](https://developers.
842
880
  # google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships
843
- # in spaces that the authenticated user has access to. Requires [authentication](
844
- # https://developers.google.com/workspace/chat/authenticate-authorize). Supports
845
- # [app authentication](https://developers.google.com/workspace/chat/authenticate-
846
- # authorize-chat-app) and [user authentication](https://developers.google.com/
847
- # workspace/chat/authenticate-authorize-chat-user).
881
+ # in spaces that the authenticated user has access to. Supports the following
882
+ # types of [authentication](https://developers.google.com/workspace/chat/
883
+ # authenticate-authorize): - [App authentication](https://developers.google.com/
884
+ # workspace/chat/authenticate-authorize-chat-app) - [User authentication](https:/
885
+ # /developers.google.com/workspace/chat/authenticate-authorize-chat-user) You
886
+ # can authenticate and authorize this method with administrator privileges by
887
+ # setting the `use_admin_access` field in the request.
848
888
  # @param [String] parent
849
889
  # Required. The resource name of the space for which to fetch a membership list.
850
890
  # Format: spaces/`space`
@@ -928,9 +968,16 @@ module Google
928
968
  end
929
969
 
930
970
  # Updates a membership. For an example, see [Update a user's membership in a
931
- # space](https://developers.google.com/workspace/chat/update-members). Requires [
932
- # user authentication](https://developers.google.com/workspace/chat/authenticate-
933
- # authorize-chat-user).
971
+ # space](https://developers.google.com/workspace/chat/update-members). Supports
972
+ # the following types of [authentication](https://developers.google.com/
973
+ # workspace/chat/authenticate-authorize): - [App authentication](https://
974
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [
975
+ # administrator approval](https://support.google.com/a?p=chat-app-auth) in [
976
+ # Developer Preview](https://developers.google.com/workspace/preview) - [User
977
+ # authentication](https://developers.google.com/workspace/chat/authenticate-
978
+ # authorize-chat-user) You can authenticate and authorize this method with
979
+ # administrator privileges by setting the `use_admin_access` field in the
980
+ # request.
934
981
  # @param [String] name
935
982
  # Resource name of the membership, assigned by the server. Format: `spaces/`
936
983
  # space`/members/`member``
@@ -978,19 +1025,22 @@ module Google
978
1025
 
979
1026
  # Creates a message in a Google Chat space. For an example, see [Send a message](
980
1027
  # https://developers.google.com/workspace/chat/create-messages). The `create()`
981
- # method requires either user or app authentication. Chat attributes the message
982
- # sender differently depending on the type of authentication that you use in
983
- # your request. The following image shows how Chat attributes a message when you
984
- # use app authentication. Chat displays the Chat app as the message sender. The
985
- # content of the message can contain text (`text`), cards (`cardsV2`), and
986
- # accessory widgets (`accessoryWidgets`). ![Message sent with app authentication]
987
- # (https://developers.google.com/workspace/chat/images/message-app-auth.svg) The
988
- # following image shows how Chat attributes a message when you use user
989
- # authentication. Chat displays the user as the message sender and attributes
990
- # the Chat app to the message by displaying its name. The content of message can
991
- # only contain text (`text`). ![Message sent with user authentication](https://
992
- # developers.google.com/workspace/chat/images/message-user-auth.svg) The maximum
993
- # message size, including the message contents, is 32,000 bytes.
1028
+ # method requires either [user authentication](https://developers.google.com/
1029
+ # workspace/chat/authenticate-authorize-chat-user) or [app authentication](https:
1030
+ # //developers.google.com/workspace/chat/authorize-import). Chat attributes the
1031
+ # message sender differently depending on the type of authentication that you
1032
+ # use in your request. The following image shows how Chat attributes a message
1033
+ # when you use app authentication. Chat displays the Chat app as the message
1034
+ # sender. The content of the message can contain text (`text`), cards (`cardsV2`)
1035
+ # , and accessory widgets (`accessoryWidgets`). ![Message sent with app
1036
+ # authentication](https://developers.google.com/workspace/chat/images/message-
1037
+ # app-auth.svg) The following image shows how Chat attributes a message when you
1038
+ # use user authentication. Chat displays the user as the message sender and
1039
+ # attributes the Chat app to the message by displaying its name. The content of
1040
+ # message can only contain text (`text`). ![Message sent with user
1041
+ # authentication](https://developers.google.com/workspace/chat/images/message-
1042
+ # user-auth.svg) The maximum message size, including the message contents, is 32,
1043
+ # 000 bytes.
994
1044
  # @param [String] parent
995
1045
  # Required. The resource name of the space in which to create a message. Format:
996
1046
  # `spaces/`space``
@@ -1051,13 +1101,13 @@ module Google
1051
1101
  end
1052
1102
 
1053
1103
  # Deletes a message. For an example, see [Delete a message](https://developers.
1054
- # google.com/workspace/chat/delete-messages). Requires [authentication](https://
1055
- # developers.google.com/workspace/chat/authenticate-authorize). Supports [app
1104
+ # google.com/workspace/chat/delete-messages). Supports the following types of [
1056
1105
  # authentication](https://developers.google.com/workspace/chat/authenticate-
1057
- # authorize-chat-app) and [user authentication](https://developers.google.com/
1058
- # workspace/chat/authenticate-authorize-chat-user). When using app
1059
- # authentication, requests can only delete messages created by the calling Chat
1060
- # app.
1106
+ # authorize): - [App authentication](https://developers.google.com/workspace/
1107
+ # chat/authenticate-authorize-chat-app) - [User authentication](https://
1108
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-user) When
1109
+ # using app authentication, requests can only delete messages created by the
1110
+ # calling Chat app.
1061
1111
  # @param [String] name
1062
1112
  # Required. Resource name of the message. Format: `spaces/`space`/messages/`
1063
1113
  # message`` If you've set a custom ID for your message, you can use the value
@@ -1100,12 +1150,13 @@ module Google
1100
1150
  end
1101
1151
 
1102
1152
  # Returns details about a message. For an example, see [Get details about a
1103
- # message](https://developers.google.com/workspace/chat/get-messages). Requires [
1153
+ # message](https://developers.google.com/workspace/chat/get-messages). Supports
1154
+ # the following types of [authentication](https://developers.google.com/
1155
+ # workspace/chat/authenticate-authorize): - [App authentication](https://
1156
+ # developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User
1104
1157
  # authentication](https://developers.google.com/workspace/chat/authenticate-
1105
- # authorize). Supports [app authentication](https://developers.google.com/
1106
- # workspace/chat/authenticate-authorize-chat-app) and [user authentication](
1107
- # https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
1108
- # Note: Might return a message from a blocked member or space.
1158
+ # authorize-chat-user) Note: Might return a message from a blocked member or
1159
+ # space.
1109
1160
  # @param [String] name
1110
1161
  # Required. Resource name of the message. Format: `spaces/`space`/messages/`
1111
1162
  # message`` If you've set a custom ID for your message, you can use the value
@@ -1222,12 +1273,12 @@ module Google
1222
1273
  # methods. The `patch` method uses a `patch` request while the `update` method
1223
1274
  # uses a `put` request. We recommend using the `patch` method. For an example,
1224
1275
  # see [Update a message](https://developers.google.com/workspace/chat/update-
1225
- # messages). Requires [authentication](https://developers.google.com/workspace/
1226
- # chat/authenticate-authorize). Supports [app authentication](https://developers.
1227
- # google.com/workspace/chat/authenticate-authorize-chat-app) and [user
1228
- # authentication](https://developers.google.com/workspace/chat/authenticate-
1229
- # authorize-chat-user). When using app authentication, requests can only update
1230
- # messages created by the calling Chat app.
1276
+ # messages). Supports the following types of [authentication](https://developers.
1277
+ # google.com/workspace/chat/authenticate-authorize): - [App authentication](
1278
+ # https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -
1279
+ # [User authentication](https://developers.google.com/workspace/chat/
1280
+ # authenticate-authorize-chat-user) When using app authentication, requests can
1281
+ # only update messages created by the calling Chat app.
1231
1282
  # @param [String] name
1232
1283
  # Resource name of the message. Format: `spaces/`space`/messages/`message``
1233
1284
  # Where ``space`` is the ID of the space where the message is posted and ``
@@ -1286,12 +1337,12 @@ module Google
1286
1337
  # methods. The `patch` method uses a `patch` request while the `update` method
1287
1338
  # uses a `put` request. We recommend using the `patch` method. For an example,
1288
1339
  # see [Update a message](https://developers.google.com/workspace/chat/update-
1289
- # messages). Requires [authentication](https://developers.google.com/workspace/
1290
- # chat/authenticate-authorize). Supports [app authentication](https://developers.
1291
- # google.com/workspace/chat/authenticate-authorize-chat-app) and [user
1292
- # authentication](https://developers.google.com/workspace/chat/authenticate-
1293
- # authorize-chat-user). When using app authentication, requests can only update
1294
- # messages created by the calling Chat app.
1340
+ # messages). Supports the following types of [authentication](https://developers.
1341
+ # google.com/workspace/chat/authenticate-authorize): - [App authentication](
1342
+ # https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -
1343
+ # [User authentication](https://developers.google.com/workspace/chat/
1344
+ # authenticate-authorize-chat-user) When using app authentication, requests can
1345
+ # only update messages created by the calling Chat app.
1295
1346
  # @param [String] name
1296
1347
  # Resource name of the message. Format: `spaces/`space`/messages/`message``
1297
1348
  # Where ``space`` is the ID of the space where the message is posted and ``
@@ -1525,11 +1576,13 @@ module Google
1525
1576
  # SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the
1526
1577
  # resource that changed. For example, if you request an event about a new
1527
1578
  # message but the message was later updated, the server returns the updated `
1528
- # Message` resource in the event payload. Requires [user authentication](https://
1529
- # developers.google.com/workspace/chat/authenticate-authorize-chat-user). To get
1530
- # an event, the authenticated user must be a member of the space. For an example,
1531
- # see [Get details about an event from a Google Chat space](https://developers.
1532
- # google.com/workspace/chat/get-space-event).
1579
+ # Message` resource in the event payload. Note: The `permissionSettings` field
1580
+ # is not returned in the Space object of the Space event data for this request.
1581
+ # Requires [user authentication](https://developers.google.com/workspace/chat/
1582
+ # authenticate-authorize-chat-user). To get an event, the authenticated user
1583
+ # must be a member of the space. For an example, see [Get details about an event
1584
+ # from a Google Chat space](https://developers.google.com/workspace/chat/get-
1585
+ # space-event).
1533
1586
  # @param [String] name
1534
1587
  # Required. The resource name of the space event. Format: `spaces/`space`/
1535
1588
  # spaceEvents/`spaceEvent``
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.106.0
4
+ version: 0.108.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-29 00:00:00.000000000 Z
11
+ date: 2024-10-13 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.106.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.108.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: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.5.6
78
+ rubygems_version: 3.5.21
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Google Chat API V1