google-apis-chat_v1 0.106.0 → 0.108.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: 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