google-apis-chat_v1 0.59.0 → 0.60.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: 3f0c085e9fded726368064485fa8bce08f612cf2681a364bf184e8eae7df50f4
4
- data.tar.gz: e91f5ceb313d46a7f031e761a3a0e41d56edc84a98fd659d45afdf76f580cf0f
3
+ metadata.gz: 5c64f5a711895ad5ea19ebb0c4814d29dca1c4db5e930174ef46368c28e519f3
4
+ data.tar.gz: 584b21b133f1df431c8ae75b095602765075f59e1c525b821af37d483cb3926c
5
5
  SHA512:
6
- metadata.gz: d00ca6ad4e86a3e89034fb9c377c2b66fa5542ed11a957033333c2efcb8adbd29560eddd6f0901899b217a82a30fe8855c6a944286343c9f3488141560d6a127
7
- data.tar.gz: edda8bb14c31a62cdddb07f3d75600a69c3472d7b8876475581d3b03fe205a5794c4986fdecba5c5cce0ecf2ae52749fc4535ac73fa835fa081c3b2ce9818e27
6
+ metadata.gz: 33592115b385acb7138200f0f9797630e93fad422c84cc860d3562a095ce5b2e9cfc852046bea1b0809775340b88ef4765afaa3e4db27ca2f3b362a3667c68be
7
+ data.tar.gz: fb7e8448ecdbe96fb503f163e8ad3e3b42a44fba44285c8ad732a9be6d038ff93762b5e63bcc508c7953d6f16d858eb4d081accd7c2e383d6bed2f68c8dad654
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-chat_v1
2
2
 
3
+ ### v0.60.0 (2023-06-04)
4
+
5
+ * Regenerated from discovery document revision 20230530
6
+
3
7
  ### v0.59.0 (2023-05-21)
4
8
 
5
9
  * Regenerated from discovery document revision 20230516
@@ -233,8 +233,7 @@ module Google
233
233
 
234
234
  # Opaque token containing a reference to an uploaded attachment. Treated by
235
235
  # clients as an opaque string and used to create or update Chat messages with
236
- # attachments. [Developer Preview](https://developers.google.com/workspace/
237
- # preview).
236
+ # attachments.
238
237
  # Corresponds to the JSON property `attachmentUploadToken`
239
238
  # @return [String]
240
239
  attr_accessor :attachment_upload_token
@@ -634,8 +633,7 @@ module Google
634
633
  end
635
634
  end
636
635
 
637
- # Represents a custom emoji. [Developer Preview](https://developers.google.com/
638
- # workspace/preview).
636
+ # Represents a custom emoji.
639
637
  class CustomEmoji
640
638
  include Google::Apis::Core::Hashable
641
639
 
@@ -707,7 +705,7 @@ module Google
707
705
  end
708
706
 
709
707
  # Information about a deleted message. A message is deleted when `delete_time`
710
- # is set. [Developer Preview](https://developers.google.com/workspace/preview).
708
+ # is set.
711
709
  class DeletionMetadata
712
710
  include Google::Apis::Core::Hashable
713
711
 
@@ -917,13 +915,11 @@ module Google
917
915
  end
918
916
  end
919
917
 
920
- # An emoji that is used as a reaction to a message. [Developer Preview](https://
921
- # developers.google.com/workspace/preview).
918
+ # An emoji that is used as a reaction to a message.
922
919
  class Emoji
923
920
  include Google::Apis::Core::Hashable
924
921
 
925
- # Represents a custom emoji. [Developer Preview](https://developers.google.com/
926
- # workspace/preview).
922
+ # Represents a custom emoji.
927
923
  # Corresponds to the JSON property `customEmoji`
928
924
  # @return [Google::Apis::ChatV1::CustomEmoji]
929
925
  attr_accessor :custom_emoji
@@ -944,13 +940,11 @@ module Google
944
940
  end
945
941
  end
946
942
 
947
- # The number of people who reacted to a message with a specific emoji. [
948
- # Developer Preview](https://developers.google.com/workspace/preview).
943
+ # The number of people who reacted to a message with a specific emoji.
949
944
  class EmojiReactionSummary
950
945
  include Google::Apis::Core::Hashable
951
946
 
952
- # An emoji that is used as a reaction to a message. [Developer Preview](https://
953
- # developers.google.com/workspace/preview).
947
+ # An emoji that is used as a reaction to a message.
954
948
  # Corresponds to the JSON property `emoji`
955
949
  # @return [Google::Apis::ChatV1::Emoji]
956
950
  attr_accessor :emoji
@@ -1667,7 +1661,7 @@ module Google
1667
1661
  class GoogleAppsCardV1DecoratedText
1668
1662
  include Google::Apis::Core::Hashable
1669
1663
 
1670
- # The text that appears below `text`. Always truncates.
1664
+ # The text that appears below `text`. Always wraps.
1671
1665
  # Corresponds to the JSON property `bottomLabel`
1672
1666
  # @return [String]
1673
1667
  attr_accessor :bottom_label
@@ -3174,8 +3168,15 @@ module Google
3174
3168
  # A custom name for a Chat message assigned at creation. Must start with `client-
3175
3169
  # ` and contain only lowercase letters, numbers, and hyphens up to 63 characters
3176
3170
  # in length. Specify this field to get, update, or delete the message with the
3177
- # specified value. For example usage, see [Name a created message](https://
3178
- # developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).
3171
+ # specified value. Assigning a custom name lets a Chat app recall the message
3172
+ # without saving the message `name` from the [response body](/chat/api/reference/
3173
+ # rest/v1/spaces.messages/get#response-body) returned when creating the message.
3174
+ # Assigning a custom name doesn't replace the generated `name` field, the
3175
+ # message's resource name. Instead, it sets the custom name as the `
3176
+ # clientAssignedMessageId` field, which you can reference while processing later
3177
+ # operations, like updating or deleting the message. For example usage, see [
3178
+ # Name a created message](https://developers.google.com/chat/api/guides/crudl/
3179
+ # messages#name_a_created_message).
3179
3180
  # Corresponds to the JSON property `clientAssignedMessageId`
3180
3181
  # @return [String]
3181
3182
  attr_accessor :client_assigned_message_id
@@ -3185,21 +3186,19 @@ module Google
3185
3186
  # @return [String]
3186
3187
  attr_accessor :create_time
3187
3188
 
3188
- # Output only. The time at which the message was deleted in Google Chat server.
3189
- # If the message is never deleted, this field is empty. [Developer Preview](
3190
- # https://developers.google.com/workspace/preview).
3189
+ # Output only. The time at which the message was deleted in Google Chat. If the
3190
+ # message is never deleted, this field is empty.
3191
3191
  # Corresponds to the JSON property `deleteTime`
3192
3192
  # @return [String]
3193
3193
  attr_accessor :delete_time
3194
3194
 
3195
3195
  # Information about a deleted message. A message is deleted when `delete_time`
3196
- # is set. [Developer Preview](https://developers.google.com/workspace/preview).
3196
+ # is set.
3197
3197
  # Corresponds to the JSON property `deletionMetadata`
3198
3198
  # @return [Google::Apis::ChatV1::DeletionMetadata]
3199
3199
  attr_accessor :deletion_metadata
3200
3200
 
3201
- # Output only. The list of emoji reaction summaries on the message. [Developer
3202
- # Preview](https://developers.google.com/workspace/preview).
3201
+ # Output only. The list of emoji reaction summaries on the message.
3203
3202
  # Corresponds to the JSON property `emojiReactionSummaries`
3204
3203
  # @return [Array<Google::Apis::ChatV1::EmojiReactionSummary>]
3205
3204
  attr_accessor :emoji_reaction_summaries
@@ -3341,13 +3340,11 @@ module Google
3341
3340
  end
3342
3341
  end
3343
3342
 
3344
- # A reaction to a message. [Developer Preview](https://developers.google.com/
3345
- # workspace/preview).
3343
+ # A reaction to a message.
3346
3344
  class Reaction
3347
3345
  include Google::Apis::Core::Hashable
3348
3346
 
3349
- # An emoji that is used as a reaction to a message. [Developer Preview](https://
3350
- # developers.google.com/workspace/preview).
3347
+ # An emoji that is used as a reaction to a message.
3351
3348
  # Corresponds to the JSON property `emoji`
3352
3349
  # @return [Google::Apis::ChatV1::Emoji]
3353
3350
  attr_accessor :emoji
@@ -3407,7 +3404,7 @@ module Google
3407
3404
  end
3408
3405
  end
3409
3406
 
3410
- # [Developer Preview](https://developers.google.com/workspace/preview).
3407
+ #
3411
3408
  class SetUpSpaceRequest
3412
3409
  include Google::Apis::Core::Hashable
3413
3410
 
@@ -3555,8 +3552,7 @@ module Google
3555
3552
  # @return [Google::Apis::ChatV1::SpaceDetails]
3556
3553
  attr_accessor :space_details
3557
3554
 
3558
- # The message history state for messages and threads in this space. [Developer
3559
- # Preview](https://developers.google.com/workspace/preview).
3555
+ # The message history state for messages and threads in this space.
3560
3556
  # Corresponds to the JSON property `spaceHistoryState`
3561
3557
  # @return [String]
3562
3558
  attr_accessor :space_history_state
@@ -3566,9 +3562,8 @@ module Google
3566
3562
  # @return [String]
3567
3563
  attr_accessor :space_threading_state
3568
3564
 
3569
- # The type of space. Required when creating or updating a space. Output only for
3570
- # other usage. [Developer Preview](https://developers.google.com/workspace/
3571
- # preview).
3565
+ # The type of space. Required when creating a space or updating the space type
3566
+ # of a space. Output only for other usage.
3572
3567
  # Corresponds to the JSON property `spaceType`
3573
3568
  # @return [String]
3574
3569
  attr_accessor :space_type
@@ -3580,8 +3575,7 @@ module Google
3580
3575
  attr_accessor :threaded
3581
3576
  alias_method :threaded?, :threaded
3582
3577
 
3583
- # Output only. Deprecated: Use `singleUserBotDm` or `spaceType` (developer
3584
- # preview) instead. The type of a space.
3578
+ # Output only. Deprecated: Use `space_type` instead. The type of a space.
3585
3579
  # Corresponds to the JSON property `type`
3586
3580
  # @return [String]
3587
3581
  attr_accessor :type
@@ -3826,7 +3820,7 @@ module Google
3826
3820
  end
3827
3821
  end
3828
3822
 
3829
- # [Developer Preview](https://developers.google.com/workspace/preview).
3823
+ #
3830
3824
  class UploadAttachmentRequest
3831
3825
  include Google::Apis::Core::Hashable
3832
3826
 
@@ -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.59.0"
19
+ GEM_VERSION = "0.60.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.12.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20230516"
25
+ REVISION = "20230530"
26
26
  end
27
27
  end
28
28
  end
@@ -88,12 +88,14 @@ module Google
88
88
  execute_or_queue_command(command, &block)
89
89
  end
90
90
 
91
- # [Developer Preview](https://developers.google.com/workspace/preview): Uploads
92
- # an attachment. Requires user [authentication](https://developers.google.com/
93
- # chat/api/guides/auth/users). You can upload attachments up to 200 MB. Certain
94
- # file types aren't supported. For details, see [File types blocked by Google
95
- # Chat](https://support.google.com/chat/answer/7651457?&co=GENIE.Platform%
96
- # 3DDesktop#File%20types%20blocked%20in%20Google%20Chat).
91
+ # Uploads an attachment. For an example, see [Upload media as a file attachment](
92
+ # https://developers.google.com/chat/api/guides/v1/media-and-attachments/upload).
93
+ # Requires user [authentication](https://developers.google.com/chat/api/guides/
94
+ # auth/users) and the `chat.messages` or `chat.messages.create` authorization
95
+ # scope. You can upload attachments up to 200 MB. Certain file types aren't
96
+ # supported. For details, see [File types blocked by Google Chat](https://
97
+ # support.google.com/chat/answer/7651457?&co=GENIE.Platform%3DDesktop#File%
98
+ # 20types%20blocked%20in%20Google%20Chat).
97
99
  # @param [String] parent
98
100
  # Required. Resource name of the Chat space in which the attachment is uploaded.
99
101
  # Format "spaces/`space`".
@@ -137,10 +139,11 @@ module Google
137
139
  execute_or_queue_command(command, &block)
138
140
  end
139
141
 
140
- # [Developer Preview](https://developers.google.com/workspace/preview): Creates
141
- # a named space. Spaces grouped by topics or that have guest access aren't
142
- # supported. Requires [user authentication](https://developers.google.com/chat/
143
- # api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
142
+ # Creates a named space. Spaces grouped by topics or that have guest access aren'
143
+ # t supported. For an example, see [Create a space](https://developers.google.
144
+ # com/chat/api/guides/v1/spaces/create). Requires [user authentication](https://
145
+ # developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create`
146
+ # or `chat.spaces` scope.
144
147
  # @param [Google::Apis::ChatV1::Space] space_object
145
148
  # @param [String] request_id
146
149
  # Optional. A unique identifier for this request. A random UUID is recommended.
@@ -176,12 +179,12 @@ module Google
176
179
  execute_or_queue_command(command, &block)
177
180
  end
178
181
 
179
- # [Developer Preview](https://developers.google.com/workspace/preview): Deletes
180
- # a named space. Always performs a cascading delete, which means that the space'
181
- # s child resourceslike messages posted in the space and memberships in the
182
- # space—are also deleted. Requires [user authentication](https://developers.
183
- # google.com/chat/api/guides/auth/users) from a user who has permission to
184
- # delete the space, and the `chat.delete` scope.
182
+ # Deletes a named space. Always performs a cascading delete, which means that
183
+ # the space's child resources—like messages posted in the space and memberships
184
+ # in the spaceare also deleted. For an example, see [Delete a space](https://
185
+ # developers.google.com/chat/api/guides/v1/spaces/delete). Requires [user
186
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) from
187
+ # a user who has permission to delete the space, and the `chat.delete` scope.
185
188
  # @param [String] name
186
189
  # Required. Resource name of the space to delete. Format: `spaces/`space``
187
190
  # @param [String] fields
@@ -211,16 +214,17 @@ module Google
211
214
  execute_or_queue_command(command, &block)
212
215
  end
213
216
 
214
- # [Developer Preview](https://developers.google.com/workspace/preview): Returns
215
- # the existing direct message with the specified user. With [user authentication]
216
- # (https://developers.google.com/chat/api/guides/auth/users), returns the direct
217
- # message space between the specified user and the authenticated user. With [
217
+ # Returns the existing direct message with the specified user. If no direct
218
+ # message space is found, returns a `404 NOT_FOUND` error. For an example, see [
219
+ # Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [
220
+ # user authentication](https://developers.google.com/chat/api/guides/auth/users),
221
+ # returns the direct message space between the specified user and the
222
+ # authenticated user. With [service account authentication](https://developers.
223
+ # google.com/chat/api/guides/auth/service-accounts), returns the direct message
224
+ # space between the specified user and the calling Chat app. Requires [user
225
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) or [
218
226
  # service account authentication](https://developers.google.com/chat/api/guides/
219
- # auth/service-accounts), returns the direct message space between the specified
220
- # user and the calling Chat app. If no direct message space is found, returns a `
221
- # 404 NOT_FOUND` error. Requires [user authentication](https://developers.google.
222
- # com/chat/api/guides/auth/users) or [service account authentication](https://
223
- # developers.google.com/chat/api/guides/auth/service-accounts).
227
+ # auth/service-accounts).
224
228
  # @param [String] name
225
229
  # Required. Resource name of the user to find direct message with. Format: `
226
230
  # users/`user``, where ``user`` is either the ``person_id`` for the [person](
@@ -256,14 +260,14 @@ module Google
256
260
  execute_or_queue_command(command, &block)
257
261
  end
258
262
 
259
- # Returns a space. Requires [authentication](https://developers.google.com/chat/
260
- # api/guides/auth). Fully supports [service account authentication](https://
261
- # developers.google.com/chat/api/guides/auth/service-accounts). Supports [user
262
- # authentication](https://developers.google.com/chat/api/guides/auth/users) as
263
- # part of the [Google Workspace Developer Preview Program](https://developers.
264
- # google.com/workspace/preview), which grants early access to certain features. [
265
- # User authentication](https://developers.google.com/chat/api/guides/auth/users)
266
- # requires the `chat.spaces` or `chat.spaces.readonly` authorization scope.
263
+ # Returns details about a space. For an example, see [Get a space](https://
264
+ # developers.google.com/chat/api/guides/v1/spaces/get). Requires [authentication]
265
+ # (https://developers.google.com/chat/api/guides/auth). Fully supports [service
266
+ # account authentication](https://developers.google.com/chat/api/guides/auth/
267
+ # service-accounts) and [user authentication](https://developers.google.com/chat/
268
+ # api/guides/auth/users). [User authentication](https://developers.google.com/
269
+ # chat/api/guides/auth/users) requires the `chat.spaces` or `chat.spaces.
270
+ # readonly` authorization scope.
267
271
  # @param [String] name
268
272
  # Required. Resource name of the space, in the form "spaces/*". Format: `spaces/`
269
273
  # space``
@@ -294,15 +298,14 @@ module Google
294
298
  execute_or_queue_command(command, &block)
295
299
  end
296
300
 
297
- # Lists spaces the caller is a member of. Requires [authentication](https://
298
- # developers.google.com/chat/api/guides/auth). Fully supports [service account
299
- # authentication](https://developers.google.com/chat/api/guides/auth/service-
300
- # accounts). Supports [user authentication](https://developers.google.com/chat/
301
- # api/guides/auth/users) as part of the [Google Workspace Developer Preview
302
- # Program](https://developers.google.com/workspace/preview), which grants early
303
- # access to certain features. [User authentication](https://developers.google.
304
- # com/chat/api/guides/auth/users) requires the `chat.spaces` or `chat.spaces.
305
- # readonly` authorization scope. Lists spaces visible to the caller or
301
+ # Lists spaces the caller is a member of. Group chats and DMs aren't listed
302
+ # until the first message is sent. For an example, see [List spaces](https://
303
+ # developers.google.com/chat/api/guides/v1/spaces/list). Requires [
304
+ # authentication](https://developers.google.com/chat/api/guides/auth). Fully
305
+ # supports [service account authentication](https://developers.google.com/chat/
306
+ # api/guides/auth/service-accounts) and [user authentication](https://developers.
307
+ # google.com/chat/api/guides/auth/users) requires the `chat.spaces` or `chat.
308
+ # spaces.readonly` authorization scope. Lists spaces visible to the caller or
306
309
  # authenticated user. Group chats and DMs aren't listed until the first message
307
310
  # is sent.
308
311
  # @param [String] filter
@@ -318,8 +321,7 @@ module Google
318
321
  # service account authentication](https://developers.google.com/chat/api/guides/
319
322
  # auth/service-accounts), this field is ignored and the query always returns all
320
323
  # spaces. But the Chat API still validates the query syntax with service
321
- # accounts, so invalid queries are still rejected. [Developer Preview](https://
322
- # developers.google.com/workspace/preview).
324
+ # accounts, so invalid queries are still rejected.
323
325
  # @param [Fixnum] page_size
324
326
  # Optional. The maximum number of spaces to return. The service might return
325
327
  # fewer than this value. If unspecified, at most 100 spaces are returned. The
@@ -359,9 +361,10 @@ module Google
359
361
  execute_or_queue_command(command, &block)
360
362
  end
361
363
 
362
- # [Developer Preview](https://developers.google.com/workspace/preview): Updates
363
- # a space. Requires [user authentication](https://developers.google.com/chat/api/
364
- # guides/auth/users) and the `chat.spaces` scope.
364
+ # Updates a space. For an example, see [Update a space](https://developers.
365
+ # google.com/chat/api/guides/v1/spaces/update). Requires [user authentication](
366
+ # https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces`
367
+ # scope.
365
368
  # @param [String] name
366
369
  # Resource name of the space. Format: `spaces/`space``
367
370
  # @param [Google::Apis::ChatV1::Space] space_object
@@ -413,31 +416,32 @@ module Google
413
416
  execute_or_queue_command(command, &block)
414
417
  end
415
418
 
416
- # [Developer Preview](https://developers.google.com/workspace/preview): Creates
417
- # a space and adds specified users to it. The calling user is automatically
418
- # added to the space, and shouldn't be specified as a membership in the request.
419
- # To specify the human members to add, add memberships with the appropriate `
420
- # member.name` in the `SetUpSpaceRequest`. To add a human user, use `users/`user`
421
- # `, where ``user`` is either the ``person_id`` for the [person](https://
422
- # developers.google.com/people/api/rest/v1/people) from the People API, or the `
423
- # id` for the [user](https://developers.google.com/admin-sdk/directory/reference/
424
- # rest/v1/users) in the Admin SDK Directory API. For example, if the People API `
425
- # Person` `resourceName` is `people/123456789`, you can add the user to the
426
- # space by including a membership with `users/123456789` as the `member.name`.
427
- # For a space or group chat, if the caller blocks or is blocked by some members,
428
- # then those members aren't added to the created space. To create a direct
429
- # message (DM) between the calling user and another human user, specify exactly
430
- # one membership to represent the human user. If one user blocks the other, the
431
- # request fails and the DM isn't created. To create a DM between the calling
432
- # user and the calling app, set `Space.singleUserBotDm` to true and don't
433
- # specify any memberships. You can only use this method to add app memberships
434
- # to DMs. To add the calling app as a member of other space types, use [create
435
- # membership](https://developers.google.com/chat/api/reference/rest/v1/spaces.
436
- # members/create) If a DM already exists between two users, even when one user
437
- # blocks the other at the time a request is made, then the existing DM is
438
- # returned. Spaces with threaded replies or guest access aren't supported.
439
- # Requires [user authentication](https://developers.google.com/chat/api/guides/
440
- # auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
419
+ # Creates a space and adds specified users to it. The calling user is
420
+ # automatically added to the space, and shouldn't be specified as a membership
421
+ # in the request. For an example, see [Set up a space](https://developers.google.
422
+ # com/chat/api/guides/v1/spaces/set-up). To specify the human members to add,
423
+ # add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`.
424
+ # To add a human user, use `users/`user``, where ``user`` is either the ``
425
+ # person_id`` for the [person](https://developers.google.com/people/api/rest/v1/
426
+ # people) from the People API, or the `id` for the [user](https://developers.
427
+ # google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK
428
+ # Directory API. For example, if the People API `Person` `resourceName` is `
429
+ # people/123456789`, you can add the user to the space by including a membership
430
+ # with `users/123456789` as the `member.name`. For a space or group chat, if the
431
+ # caller blocks or is blocked by some members, then those members aren't added
432
+ # to the created space. To create a direct message (DM) between the calling user
433
+ # and another human user, specify exactly one membership to represent the human
434
+ # user. If one user blocks the other, the request fails and the DM isn't created.
435
+ # To create a DM between the calling user and the calling app, set `Space.
436
+ # singleUserBotDm` to `true` and don't specify any memberships. You can only use
437
+ # this method to set up a DM with the calling app. To add the calling app as a
438
+ # member of a space or an existing DM between two human users, see [create a
439
+ # membership](https://developers.google.com/chat/api/guides/v1/members/create).
440
+ # If a DM already exists between two users, even when one user blocks the other
441
+ # at the time a request is made, then the existing DM is returned. Spaces with
442
+ # threaded replies or guest access aren't supported. Requires [user
443
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) and
444
+ # the `chat.spaces.create` or `chat.spaces` scope.
441
445
  # @param [Google::Apis::ChatV1::SetUpSpaceRequest] set_up_space_request_object
442
446
  # @param [String] fields
443
447
  # Selector specifying which fields to include in a partial response.
@@ -467,20 +471,25 @@ module Google
467
471
  execute_or_queue_command(command, &block)
468
472
  end
469
473
 
470
- # [Developer Preview](https://developers.google.com/workspace/preview): Creates
471
- # a human membership or app membership for the calling app. Creating memberships
472
- # for other apps isn't supported. Requires [user authentication](https://
473
- # developers.google.com/chat/api/guides/auth/users) and the `chat.memberships` (
474
- # for human membership) or `chat.memberships.app` (for app membership) scope. To
475
- # specify the member to add, set the `membership.member.name` in the `
476
- # CreateMembershipRequest`: - To add the calling app to the space, use `users/
477
- # app`. - To add a human user, use `users/`user``, where ``user`` is either the `
478
- # `person_id`` for the [person](https://developers.google.com/people/api/rest/v1/
479
- # people) from the People API, or the `id` for the [user](https://developers.
480
- # google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API.
481
- # For example, if the People API `Person` `resourceName` is `people/123456789`,
482
- # you can add the user to the space by setting the `membership.member.name` to `
483
- # users/123456789`.
474
+ # Creates a human membership or app membership for the calling app. Creating
475
+ # memberships for other apps isn't supported. For an example, see [ Create a
476
+ # membership](https://developers.google.com/chat/api/guides/v1/members/create).
477
+ # When creating a membership, if the specified member has their auto-accept
478
+ # policy turned off, then they're invited, and must accept the space invitation
479
+ # before joining. Otherwise, creating a membership adds the member directly to
480
+ # the specified space. Requires [user authentication](https://developers.google.
481
+ # com/chat/api/guides/auth/users) and the `chat.memberships` (for human
482
+ # membership) or `chat.memberships.app` (for app membership) scope. To specify
483
+ # the member to add, set the `membership.member.name` in the `
484
+ # CreateMembershipRequest`: - To add the calling app to a space or a direct
485
+ # message between two human users, use `users/app`. Unable to add other apps to
486
+ # the space. - To add a human user, use `users/`user``, where ``user`` is either
487
+ # the ``person_id`` for the [person](https://developers.google.com/people/api/
488
+ # rest/v1/people) from the People API, or the `id` for the [user](https://
489
+ # developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the
490
+ # Directory API. For example, if the People API `Person` `resourceName` is `
491
+ # people/123456789`, you can add the user to the space by setting the `
492
+ # membership.member.name` to `users/123456789`.
484
493
  # @param [String] parent
485
494
  # Required. The resource name of the space for which to create the membership.
486
495
  # Format: spaces/`space`
@@ -514,10 +523,10 @@ module Google
514
523
  execute_or_queue_command(command, &block)
515
524
  end
516
525
 
517
- # [Developer Preview](https://developers.google.com/workspace/preview): Deletes
518
- # a membership. Requires [user authentication](https://developers.google.com/
519
- # chat/api/guides/auth/users) and the `chat.memberships` or `chat.memberships.
520
- # app` authorization scope.
526
+ # Deletes a membership. For an example, see [Delete a membership](https://
527
+ # developers.google.com/chat/api/guides/v1/members/delete). Requires [user
528
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) and
529
+ # the `chat.memberships` or `chat.memberships.app` authorization scope.
521
530
  # @param [String] name
522
531
  # Required. Resource name of the membership to delete. Chat apps can delete
523
532
  # human users' or their own memberships. Chat apps can't delete other apps'
@@ -553,15 +562,14 @@ module Google
553
562
  execute_or_queue_command(command, &block)
554
563
  end
555
564
 
556
- # Returns a membership. Requires [authentication](https://developers.google.com/
557
- # chat/api/guides/auth/). Fully supports [service account authentication](https:/
558
- # /developers.google.com/chat/api/guides/auth/service-accounts). Supports [user
559
- # authentication](https://developers.google.com/chat/api/guides/auth/users) as
560
- # part of the [Google Workspace Developer Preview Program](https://developers.
561
- # google.com/workspace/preview), which grants early access to certain features. [
562
- # User authentication](https://developers.google.com/chat/api/guides/auth/users)
563
- # requires the `chat.memberships` or `chat.memberships.readonly` authorization
564
- # scope.
565
+ # Returns details about a membership. For an example, see [Get a membership](
566
+ # https://developers.google.com/chat/api/guides/v1/members/get). Requires [
567
+ # authentication](https://developers.google.com/chat/api/guides/auth). Fully
568
+ # supports [service account authentication](https://developers.google.com/chat/
569
+ # api/guides/auth/service-accounts) and [user authentication](https://developers.
570
+ # google.com/chat/api/guides/auth/users). [User authentication](https://
571
+ # developers.google.com/chat/api/guides/auth/users) requires the `chat.
572
+ # memberships` or `chat.memberships.readonly` authorization scope.
565
573
  # @param [String] name
566
574
  # Required. Resource name of the membership to retrieve. Format: `spaces/`space`/
567
575
  # members/`member``
@@ -592,15 +600,19 @@ module Google
592
600
  execute_or_queue_command(command, &block)
593
601
  end
594
602
 
595
- # Lists memberships in a space. Requires [authentication](https://developers.
596
- # google.com/chat/api/guides/auth/). Fully supports [service account
597
- # authentication](https://developers.google.com/chat/api/guides/auth/service-
598
- # accounts). Supports [user authentication](https://developers.google.com/chat/
599
- # api/guides/auth/users) as part of the [Google Workspace Developer Preview
600
- # Program](https://developers.google.com/workspace/preview), which grants early
601
- # access to certain features. [User authentication](https://developers.google.
602
- # com/chat/api/guides/auth/users) requires the `chat.memberships` or `chat.
603
- # memberships.readonly` authorization scope.
603
+ # Lists memberships in a space. For an example, see [List memberships](https://
604
+ # developers.google.com/chat/api/guides/v1/members/list). Listing memberships
605
+ # with [app authentication](https://developers.google.com/chat/api/guides/auth/
606
+ # service-accounts) lists memberships in spaces that the Chat app has access to,
607
+ # but excludes Chat app memberships, including its own. Listing memberships with
608
+ # [User authentication](https://developers.google.com/chat/api/guides/auth/users)
609
+ # lists memberships in spaces that the authenticated user has access to.
610
+ # Requires [authentication](https://developers.google.com/chat/api/guides/auth).
611
+ # Fully supports [service account authentication](https://developers.google.com/
612
+ # chat/api/guides/auth/service-accounts) and [user authentication](https://
613
+ # developers.google.com/chat/api/guides/auth/users). [User authentication](https:
614
+ # //developers.google.com/chat/api/guides/auth/users) requires the `chat.
615
+ # memberships` or `chat.memberships.readonly` authorization scope.
604
616
  # @param [String] parent
605
617
  # Required. The resource name of the space for which to fetch a membership list.
606
618
  # Format: spaces/`space`
@@ -665,19 +677,19 @@ module Google
665
677
  execute_or_queue_command(command, &block)
666
678
  end
667
679
 
668
- # Creates a message. For example usage, see [Create a message](https://
669
- # developers.google.com/chat/api/guides/crudl/messages#create_a_message).
670
- # Requires [authentication](https://developers.google.com/chat/api/guides/auth).
671
- # Fully supports [service account authentication](https://developers.google.com/
672
- # chat/api/guides/auth/service-accounts). Supports [user authentication](https://
673
- # developers.google.com/chat/api/guides/auth/users) as part of the [Google
674
- # Workspace Developer Preview Program](https://developers.google.com/workspace/
675
- # preview), which grants early access to certain features. [User authentication](
676
- # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
677
- # messages` or `chat.messages.create` authorization scope. Because Chat provides
678
- # authentication for [webhooks](https://developers.google.com/chat/how-tos/
679
- # webhooks) as part of the URL that's generated when a webhook is registered,
680
- # webhooks can create messages without a service account or user authentication.
680
+ # Creates a message. For an example, see [Create a message](https://developers.
681
+ # google.com/chat/api/guides/crudl/messages#create_a_message). Requires [
682
+ # authentication](https://developers.google.com/chat/api/guides/auth). Creating
683
+ # a text message supports both [user authentication](https://developers.google.
684
+ # com/chat/api/guides/auth/users) and [app authentication] (https://developers.
685
+ # google.com/chat/api/guides/auth/service-accounts). [User authentication](https:
686
+ # //developers.google.com/chat/api/guides/auth/users) requires the `chat.
687
+ # messages` or `chat.messages.create` authorization scope. Creating a card
688
+ # message requires [app authentication] (https://developers.google.com/chat/api/
689
+ # guides/auth/service-accounts) Because Chat provides authentication for [
690
+ # webhooks](https://developers.google.com/chat/how-tos/webhooks) as part of the
691
+ # URL that's generated when a webhook is registered, webhooks can create
692
+ # messages without a service account or user authentication.
681
693
  # @param [String] parent
682
694
  # Required. The resource name of the space in which to create a message. Format:
683
695
  # `spaces/`space``
@@ -686,9 +698,15 @@ module Google
686
698
  # Optional. A custom name for a Chat message assigned at creation. Must start
687
699
  # with `client-` and contain only lowercase letters, numbers, and hyphens up to
688
700
  # 63 characters in length. Specify this field to get, update, or delete the
689
- # message with the specified value. For example usage, see [Name a created
690
- # message](https://developers.google.com/chat/api/guides/crudl/messages#
691
- # name_a_created_message).
701
+ # message with the specified value. Assigning a custom name lets a a Chat app
702
+ # recall the message without saving the message `name` from the [response body](/
703
+ # chat/api/reference/rest/v1/spaces.messages/get#response-body) returned when
704
+ # creating the message. Assigning a custom name doesn't replace the generated `
705
+ # name` field, the message's resource name. Instead, it sets the custom name as
706
+ # the `clientAssignedMessageId` field, which you can reference while processing
707
+ # later operations, like updating or deleting the message. For example usage,
708
+ # see [Name a created message](https://developers.google.com/chat/api/guides/
709
+ # crudl/messages#name_a_created_message).
692
710
  # @param [String] message_reply_option
693
711
  # Optional. Specifies whether a message starts a thread or replies to one. Only
694
712
  # supported in named spaces.
@@ -734,16 +752,13 @@ module Google
734
752
  execute_or_queue_command(command, &block)
735
753
  end
736
754
 
737
- # Deletes a message. For example usage, see [Delete a message](https://
738
- # developers.google.com/chat/api/guides/crudl/messages#delete_a_message).
739
- # Requires [authentication](https://developers.google.com/chat/api/guides/auth).
740
- # Fully supports [service account authentication](https://developers.google.com/
741
- # chat/api/guides/auth/service-accounts). Supports [user authentication](https://
742
- # developers.google.com/chat/api/guides/auth/users) as part of the [Google
743
- # Workspace Developer Preview Program](https://developers.google.com/workspace/
744
- # preview), which grants early access to certain features. [User authentication](
745
- # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
746
- # messages` authorization scope.
755
+ # Deletes a message. For an example, see [Delete a message](https://developers.
756
+ # google.com/chat/api/guides/v1/messages/delete). Requires [authentication](
757
+ # https://developers.google.com/chat/api/guides/auth). Fully supports [service
758
+ # account authentication](https://developers.google.com/chat/api/guides/auth/
759
+ # service-accounts) and [user authentication](https://developers.google.com/chat/
760
+ # api/guides/auth/users). [User authentication](https://developers.google.com/
761
+ # chat/api/guides/auth/users) requires the `chat.messages` authorization scope.
747
762
  # @param [String] name
748
763
  # Required. Resource name of the message that you want to delete, in the form `
749
764
  # spaces/*/messages/*` Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.
@@ -782,17 +797,15 @@ module Google
782
797
  execute_or_queue_command(command, &block)
783
798
  end
784
799
 
785
- # Returns a message. For example usage, see [Read a message](https://developers.
786
- # google.com/chat/api/guides/crudl/messages#read_a_message). Requires [
800
+ # Returns details about a message. For an example, see [Read a message](https://
801
+ # developers.google.com/chat/api/guides/v1/messages/get). Requires [
787
802
  # authentication](https://developers.google.com/chat/api/guides/auth). Fully
788
- # supports [Service account authentication](https://developers.google.com/chat/
789
- # api/guides/auth/service-accounts). Supports [user authentication](https://
790
- # developers.google.com/chat/api/guides/auth/users) as part of the [Google
791
- # Workspace Developer Preview Program](https://developers.google.com/workspace/
792
- # preview), which grants early access to certain features. [User authentication](
793
- # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
794
- # messages` or `chat.messages.readonly` authorization scope. Note: Might return
795
- # a message from a blocked member or space.
803
+ # supports [service account authentication](https://developers.google.com/chat/
804
+ # api/guides/auth/service-accounts) and [user authentication](https://developers.
805
+ # google.com/chat/api/guides/auth/users). [User authentication](https://
806
+ # developers.google.com/chat/api/guides/auth/users) requires the `chat.messages`
807
+ # or `chat.messages.readonly` authorization scope. Note: Might return a message
808
+ # from a blocked member or space.
796
809
  # @param [String] name
797
810
  # Required. Resource name of the message to retrieve. Format: `spaces/`space`/
798
811
  # messages/`message`` If the message begins with `client-`, then it has a custom
@@ -827,9 +840,9 @@ module Google
827
840
  execute_or_queue_command(command, &block)
828
841
  end
829
842
 
830
- # [Developer Preview](https://developers.google.com/workspace/preview): Lists
831
- # messages in a space that the caller is a member of, including messages from
832
- # blocked members and spaces. Requires [user authentication](https://developers.
843
+ # Lists messages in a space that the caller is a member of, including messages
844
+ # from blocked members and spaces. For an example, see [List messages](/chat/api/
845
+ # guides/v1/messages/list). Requires [user authentication](https://developers.
833
846
  # google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.
834
847
  # messages.readonly` authorization scope. This method is only supported in
835
848
  # spaces that don't allow users from outside the Workspace organization to join.
@@ -905,16 +918,14 @@ module Google
905
918
  execute_or_queue_command(command, &block)
906
919
  end
907
920
 
908
- # Updates a message. There's a difference between `patch` and `update` methods.
909
- # The `patch` method uses a `patch` request while the `update` method uses a `
910
- # put` request. We recommend using the `patch` method. For example usage, see [
911
- # Update a message](https://developers.google.com/chat/api/guides/crudl/messages#
912
- # update_a_message). Requires [authentication](https://developers.google.com/
913
- # chat/api/guides/auth/). Fully supports [service account authentication](https:/
914
- # /developers.google.com/chat/api/guides/auth/service-accounts). Supports [user
915
- # authentication](https://developers.google.com/chat/api/guides/auth/users) as
916
- # part of the [Google Workspace Developer Preview Program](https://developers.
917
- # google.com/workspace/preview), which grants early access to certain features. [
921
+ # Updates a message. There's a difference between the `patch` and `update`
922
+ # methods. The `patch` method uses a `patch` request while the `update` method
923
+ # uses a `put` request. We recommend using the `patch` method. For an example,
924
+ # see [Update a message](https://developers.google.com/chat/api/guides/v1/
925
+ # messages/update). Requires [authentication](https://developers.google.com/chat/
926
+ # api/guides/auth). Fully supports [service account authentication](https://
927
+ # developers.google.com/chat/api/guides/auth/service-accounts) and [user
928
+ # authentication](https://developers.google.com/chat/api/guides/auth/users). [
918
929
  # User authentication](https://developers.google.com/chat/api/guides/auth/users)
919
930
  # requires the `chat.messages` authorization scope.
920
931
  # @param [String] name
@@ -929,7 +940,9 @@ module Google
929
940
  # @param [String] update_mask
930
941
  # Required. The field paths to update. Separate multiple values with commas.
931
942
  # Currently supported field paths: - `text` - `cards` (Requires [service account
932
- # authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2`
943
+ # authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (
944
+ # Requires [service account authentication](/chat/api/guides/auth/service-
945
+ # accounts).)
933
946
  # @param [String] fields
934
947
  # Selector specifying which fields to include in a partial response.
935
948
  # @param [String] quota_user
@@ -961,16 +974,14 @@ module Google
961
974
  execute_or_queue_command(command, &block)
962
975
  end
963
976
 
964
- # Updates a message. There's a difference between `patch` and `update` methods.
965
- # The `patch` method uses a `patch` request while the `update` method uses a `
966
- # put` request. We recommend using the `patch` method. For example usage, see [
967
- # Update a message](https://developers.google.com/chat/api/guides/crudl/messages#
968
- # update_a_message). Requires [authentication](https://developers.google.com/
969
- # chat/api/guides/auth/). Fully supports [service account authentication](https:/
970
- # /developers.google.com/chat/api/guides/auth/service-accounts). Supports [user
971
- # authentication](https://developers.google.com/chat/api/guides/auth/users) as
972
- # part of the [Google Workspace Developer Preview Program](https://developers.
973
- # google.com/workspace/preview), which grants early access to certain features. [
977
+ # Updates a message. There's a difference between the `patch` and `update`
978
+ # methods. The `patch` method uses a `patch` request while the `update` method
979
+ # uses a `put` request. We recommend using the `patch` method. For an example,
980
+ # see [Update a message](https://developers.google.com/chat/api/guides/v1/
981
+ # messages/update). Requires [authentication](https://developers.google.com/chat/
982
+ # api/guides/auth). Fully supports [service account authentication](https://
983
+ # developers.google.com/chat/api/guides/auth/service-accounts) and [user
984
+ # authentication](https://developers.google.com/chat/api/guides/auth/users). [
974
985
  # User authentication](https://developers.google.com/chat/api/guides/auth/users)
975
986
  # requires the `chat.messages` authorization scope.
976
987
  # @param [String] name
@@ -985,7 +996,9 @@ module Google
985
996
  # @param [String] update_mask
986
997
  # Required. The field paths to update. Separate multiple values with commas.
987
998
  # Currently supported field paths: - `text` - `cards` (Requires [service account
988
- # authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2`
999
+ # authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (
1000
+ # Requires [service account authentication](/chat/api/guides/auth/service-
1001
+ # accounts).)
989
1002
  # @param [String] fields
990
1003
  # Selector specifying which fields to include in a partial response.
991
1004
  # @param [String] quota_user
@@ -1019,8 +1032,10 @@ module Google
1019
1032
 
1020
1033
  # Gets the metadata of a message attachment. The attachment data is fetched
1021
1034
  # using the [media API](https://developers.google.com/chat/api/reference/rest/v1/
1022
- # media/download). Requires [service account authentication](https://developers.
1023
- # google.com/chat/api/guides/auth/service-accounts).
1035
+ # media/download). For an example, see [Get a message attachment](https://
1036
+ # developers.google.com/chat/api/guides/v1/media-and-attachments/get). Requires [
1037
+ # service account authentication](https://developers.google.com/chat/api/guides/
1038
+ # auth/service-accounts).
1024
1039
  # @param [String] name
1025
1040
  # Required. Resource name of the attachment, in the form `spaces/*/messages/*/
1026
1041
  # attachments/*`.
@@ -1051,11 +1066,11 @@ module Google
1051
1066
  execute_or_queue_command(command, &block)
1052
1067
  end
1053
1068
 
1054
- # [Developer Preview](https://developers.google.com/workspace/preview): Creates
1055
- # a reaction and adds it to a message. Requires [user authentication](https://
1056
- # developers.google.com/chat/api/guides/auth/users) and the `chat.messages`, `
1057
- # chat.messages.reactions`, or `chat.messages.reactions.create` scope. Only
1058
- # unicode emoji are supported.
1069
+ # Creates a reaction and adds it to a message. For an example, see [Create a
1070
+ # reaction](https://developers.google.com/chat/api/guides/v1/reactions/create).
1071
+ # Requires [user authentication](https://developers.google.com/chat/api/guides/
1072
+ # auth/users) and the `chat.messages`, `chat.messages.reactions`, or `chat.
1073
+ # messages.reactions.create` scope. Only unicode emoji are supported.
1059
1074
  # @param [String] parent
1060
1075
  # Required. The message where the reaction is created. Format: `spaces/`space`/
1061
1076
  # messages/`message``
@@ -1089,10 +1104,10 @@ module Google
1089
1104
  execute_or_queue_command(command, &block)
1090
1105
  end
1091
1106
 
1092
- # [Developer Preview](https://developers.google.com/workspace/preview): Deletes
1093
- # a reaction to a message. Requires [user authentication](https://developers.
1094
- # google.com/chat/api/guides/auth/users) and the `chat.messages` or `chat.
1095
- # messages.reactions` scope.
1107
+ # Deletes a reaction to a message. For an example, see [Delete a reaction](https:
1108
+ # //developers.google.com/chat/api/guides/v1/reactions/delete). Requires [user
1109
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) and
1110
+ # the `chat.messages` or `chat.messages.reactions` scope.
1096
1111
  # @param [String] name
1097
1112
  # Required. Name of the reaction to delete. Format: `spaces/`space`/messages/`
1098
1113
  # message`/reactions/`reaction``
@@ -1123,11 +1138,11 @@ module Google
1123
1138
  execute_or_queue_command(command, &block)
1124
1139
  end
1125
1140
 
1126
- # [Developer Preview](https://developers.google.com/workspace/preview): Lists
1127
- # reactions to a message. Requires [user authentication](https://developers.
1128
- # google.com/chat/api/guides/auth/users) and `chat.messages`, `chat.messages.
1129
- # readonly`, `chat.messages.reactions`, or `chat.messages.reactions.readonly`
1130
- # scope.
1141
+ # Lists reactions to a message. For an example, see [List reactions](https://
1142
+ # developers.google.com/chat/api/guides/v1/reactions/list). Requires [user
1143
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) and `
1144
+ # chat.messages`, `chat.messages.readonly`, `chat.messages.reactions`, or `chat.
1145
+ # messages.reactions.readonly` scope.
1131
1146
  # @param [String] parent
1132
1147
  # Required. The message users reacted to. Format: `spaces/`space`/messages/`
1133
1148
  # message``
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.59.0
4
+ version: 0.60.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: 2023-05-21 00:00:00.000000000 Z
11
+ date: 2023-06-04 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.59.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-chat_v1/v0.60.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: []