google-apis-chat_v1 0.59.0 → 0.60.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: 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: []