google-apis-chat_v1 0.46.0 → 0.48.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -53,8 +53,8 @@ module Google
53
53
  # Legacy path for creating message. Calling these will result in a BadRequest
54
54
  # response.
55
55
  # @param [String] parent
56
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
57
- # AAAAAAAAAAA
56
+ # Required. The resource name of the space in which to create a message. Format:
57
+ # spaces/`space`
58
58
  # @param [Google::Apis::ChatV1::Message] message_object
59
59
  # @param [String] message_id
60
60
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -63,14 +63,17 @@ module Google
63
63
  # message with the specified value. For example usage, see [Name a created
64
64
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
65
65
  # name_a_created_message).
66
+ # @param [String] message_reply_option
67
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
68
+ # supported in named spaces.
66
69
  # @param [String] request_id
67
70
  # Optional. A unique request ID for this message. Specifying an existing request
68
71
  # ID returns the message created with that ID instead of creating a new message.
69
72
  # @param [String] thread_key
70
- # Optional. Opaque thread identifier. To start or add to a thread, create a
71
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
72
- # has no effect.) The first message with a given `threadKey` starts a new thread.
73
- # Subsequent messages with the same `threadKey` post into the same thread.
73
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
74
+ # To start or add to a thread, create a message and specify a `threadKey` or the
75
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
76
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
74
77
  # @param [String] fields
75
78
  # Selector specifying which fields to include in a partial response.
76
79
  # @param [String] quota_user
@@ -88,7 +91,7 @@ module Google
88
91
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
89
92
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
90
93
  # @raise [Google::Apis::AuthorizationError] Authorization is required
91
- def messages_dm(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
94
+ def messages_dm(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
92
95
  command = make_simple_command(:post, 'v1/{+parent}/messages', options)
93
96
  command.request_representation = Google::Apis::ChatV1::Message::Representation
94
97
  command.request_object = message_object
@@ -96,6 +99,7 @@ module Google
96
99
  command.response_class = Google::Apis::ChatV1::Message
97
100
  command.params['parent'] = parent unless parent.nil?
98
101
  command.query['messageId'] = message_id unless message_id.nil?
102
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
99
103
  command.query['requestId'] = request_id unless request_id.nil?
100
104
  command.query['threadKey'] = thread_key unless thread_key.nil?
101
105
  command.query['fields'] = fields unless fields.nil?
@@ -106,8 +110,8 @@ module Google
106
110
  # Legacy path for creating message. Calling these will result in a BadRequest
107
111
  # response.
108
112
  # @param [String] parent
109
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
110
- # AAAAAAAAAAA
113
+ # Required. The resource name of the space in which to create a message. Format:
114
+ # spaces/`space`
111
115
  # @param [Google::Apis::ChatV1::Message] message_object
112
116
  # @param [String] message_id
113
117
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -116,14 +120,17 @@ module Google
116
120
  # message with the specified value. For example usage, see [Name a created
117
121
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
118
122
  # name_a_created_message).
123
+ # @param [String] message_reply_option
124
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
125
+ # supported in named spaces.
119
126
  # @param [String] request_id
120
127
  # Optional. A unique request ID for this message. Specifying an existing request
121
128
  # ID returns the message created with that ID instead of creating a new message.
122
129
  # @param [String] thread_key
123
- # Optional. Opaque thread identifier. To start or add to a thread, create a
124
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
125
- # has no effect.) The first message with a given `threadKey` starts a new thread.
126
- # Subsequent messages with the same `threadKey` post into the same thread.
130
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
131
+ # To start or add to a thread, create a message and specify a `threadKey` or the
132
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
133
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
127
134
  # @param [String] fields
128
135
  # Selector specifying which fields to include in a partial response.
129
136
  # @param [String] quota_user
@@ -141,7 +148,7 @@ module Google
141
148
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
142
149
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
143
150
  # @raise [Google::Apis::AuthorizationError] Authorization is required
144
- def webhooks_dm(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
151
+ def webhooks_dm(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
145
152
  command = make_simple_command(:post, 'v1/{+parent}/webhooks', options)
146
153
  command.request_representation = Google::Apis::ChatV1::Message::Representation
147
154
  command.request_object = message_object
@@ -149,6 +156,7 @@ module Google
149
156
  command.response_class = Google::Apis::ChatV1::Message
150
157
  command.params['parent'] = parent unless parent.nil?
151
158
  command.query['messageId'] = message_id unless message_id.nil?
159
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
152
160
  command.query['requestId'] = request_id unless request_id.nil?
153
161
  command.query['threadKey'] = thread_key unless thread_key.nil?
154
162
  command.query['fields'] = fields unless fields.nil?
@@ -159,8 +167,8 @@ module Google
159
167
  # Legacy path for creating message. Calling these will result in a BadRequest
160
168
  # response.
161
169
  # @param [String] parent
162
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
163
- # AAAAAAAAAAA
170
+ # Required. The resource name of the space in which to create a message. Format:
171
+ # spaces/`space`
164
172
  # @param [Google::Apis::ChatV1::Message] message_object
165
173
  # @param [String] message_id
166
174
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -169,14 +177,17 @@ module Google
169
177
  # message with the specified value. For example usage, see [Name a created
170
178
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
171
179
  # name_a_created_message).
180
+ # @param [String] message_reply_option
181
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
182
+ # supported in named spaces.
172
183
  # @param [String] request_id
173
184
  # Optional. A unique request ID for this message. Specifying an existing request
174
185
  # ID returns the message created with that ID instead of creating a new message.
175
186
  # @param [String] thread_key
176
- # Optional. Opaque thread identifier. To start or add to a thread, create a
177
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
178
- # has no effect.) The first message with a given `threadKey` starts a new thread.
179
- # Subsequent messages with the same `threadKey` post into the same thread.
187
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
188
+ # To start or add to a thread, create a message and specify a `threadKey` or the
189
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
190
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
180
191
  # @param [String] fields
181
192
  # Selector specifying which fields to include in a partial response.
182
193
  # @param [String] quota_user
@@ -194,7 +205,7 @@ module Google
194
205
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
195
206
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
196
207
  # @raise [Google::Apis::AuthorizationError] Authorization is required
197
- def messages_dm_conversation(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
208
+ def messages_dm_conversation(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
198
209
  command = make_simple_command(:post, 'v1/{+parent}/messages', options)
199
210
  command.request_representation = Google::Apis::ChatV1::Message::Representation
200
211
  command.request_object = message_object
@@ -202,6 +213,7 @@ module Google
202
213
  command.response_class = Google::Apis::ChatV1::Message
203
214
  command.params['parent'] = parent unless parent.nil?
204
215
  command.query['messageId'] = message_id unless message_id.nil?
216
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
205
217
  command.query['requestId'] = request_id unless request_id.nil?
206
218
  command.query['threadKey'] = thread_key unless thread_key.nil?
207
219
  command.query['fields'] = fields unless fields.nil?
@@ -250,8 +262,8 @@ module Google
250
262
  # Legacy path for creating message. Calling these will result in a BadRequest
251
263
  # response.
252
264
  # @param [String] parent
253
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
254
- # AAAAAAAAAAA
265
+ # Required. The resource name of the space in which to create a message. Format:
266
+ # spaces/`space`
255
267
  # @param [Google::Apis::ChatV1::Message] message_object
256
268
  # @param [String] message_id
257
269
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -260,14 +272,17 @@ module Google
260
272
  # message with the specified value. For example usage, see [Name a created
261
273
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
262
274
  # name_a_created_message).
275
+ # @param [String] message_reply_option
276
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
277
+ # supported in named spaces.
263
278
  # @param [String] request_id
264
279
  # Optional. A unique request ID for this message. Specifying an existing request
265
280
  # ID returns the message created with that ID instead of creating a new message.
266
281
  # @param [String] thread_key
267
- # Optional. Opaque thread identifier. To start or add to a thread, create a
268
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
269
- # has no effect.) The first message with a given `threadKey` starts a new thread.
270
- # Subsequent messages with the same `threadKey` post into the same thread.
282
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
283
+ # To start or add to a thread, create a message and specify a `threadKey` or the
284
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
285
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
271
286
  # @param [String] fields
272
287
  # Selector specifying which fields to include in a partial response.
273
288
  # @param [String] quota_user
@@ -285,7 +300,7 @@ module Google
285
300
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
286
301
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
287
302
  # @raise [Google::Apis::AuthorizationError] Authorization is required
288
- def messages_room(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
303
+ def messages_room(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
289
304
  command = make_simple_command(:post, 'v1/{+parent}/messages', options)
290
305
  command.request_representation = Google::Apis::ChatV1::Message::Representation
291
306
  command.request_object = message_object
@@ -293,6 +308,7 @@ module Google
293
308
  command.response_class = Google::Apis::ChatV1::Message
294
309
  command.params['parent'] = parent unless parent.nil?
295
310
  command.query['messageId'] = message_id unless message_id.nil?
311
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
296
312
  command.query['requestId'] = request_id unless request_id.nil?
297
313
  command.query['threadKey'] = thread_key unless thread_key.nil?
298
314
  command.query['fields'] = fields unless fields.nil?
@@ -303,8 +319,8 @@ module Google
303
319
  # Legacy path for creating message. Calling these will result in a BadRequest
304
320
  # response.
305
321
  # @param [String] parent
306
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
307
- # AAAAAAAAAAA
322
+ # Required. The resource name of the space in which to create a message. Format:
323
+ # spaces/`space`
308
324
  # @param [Google::Apis::ChatV1::Message] message_object
309
325
  # @param [String] message_id
310
326
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -313,14 +329,17 @@ module Google
313
329
  # message with the specified value. For example usage, see [Name a created
314
330
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
315
331
  # name_a_created_message).
332
+ # @param [String] message_reply_option
333
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
334
+ # supported in named spaces.
316
335
  # @param [String] request_id
317
336
  # Optional. A unique request ID for this message. Specifying an existing request
318
337
  # ID returns the message created with that ID instead of creating a new message.
319
338
  # @param [String] thread_key
320
- # Optional. Opaque thread identifier. To start or add to a thread, create a
321
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
322
- # has no effect.) The first message with a given `threadKey` starts a new thread.
323
- # Subsequent messages with the same `threadKey` post into the same thread.
339
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
340
+ # To start or add to a thread, create a message and specify a `threadKey` or the
341
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
342
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
324
343
  # @param [String] fields
325
344
  # Selector specifying which fields to include in a partial response.
326
345
  # @param [String] quota_user
@@ -338,7 +357,7 @@ module Google
338
357
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
339
358
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
340
359
  # @raise [Google::Apis::AuthorizationError] Authorization is required
341
- def webhooks_room(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
360
+ def webhooks_room(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
342
361
  command = make_simple_command(:post, 'v1/{+parent}/webhooks', options)
343
362
  command.request_representation = Google::Apis::ChatV1::Message::Representation
344
363
  command.request_object = message_object
@@ -346,6 +365,7 @@ module Google
346
365
  command.response_class = Google::Apis::ChatV1::Message
347
366
  command.params['parent'] = parent unless parent.nil?
348
367
  command.query['messageId'] = message_id unless message_id.nil?
368
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
349
369
  command.query['requestId'] = request_id unless request_id.nil?
350
370
  command.query['threadKey'] = thread_key unless thread_key.nil?
351
371
  command.query['fields'] = fields unless fields.nil?
@@ -356,8 +376,8 @@ module Google
356
376
  # Legacy path for creating message. Calling these will result in a BadRequest
357
377
  # response.
358
378
  # @param [String] parent
359
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
360
- # AAAAAAAAAAA
379
+ # Required. The resource name of the space in which to create a message. Format:
380
+ # spaces/`space`
361
381
  # @param [Google::Apis::ChatV1::Message] message_object
362
382
  # @param [String] message_id
363
383
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -366,14 +386,17 @@ module Google
366
386
  # message with the specified value. For example usage, see [Name a created
367
387
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
368
388
  # name_a_created_message).
389
+ # @param [String] message_reply_option
390
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
391
+ # supported in named spaces.
369
392
  # @param [String] request_id
370
393
  # Optional. A unique request ID for this message. Specifying an existing request
371
394
  # ID returns the message created with that ID instead of creating a new message.
372
395
  # @param [String] thread_key
373
- # Optional. Opaque thread identifier. To start or add to a thread, create a
374
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
375
- # has no effect.) The first message with a given `threadKey` starts a new thread.
376
- # Subsequent messages with the same `threadKey` post into the same thread.
396
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
397
+ # To start or add to a thread, create a message and specify a `threadKey` or the
398
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
399
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
377
400
  # @param [String] fields
378
401
  # Selector specifying which fields to include in a partial response.
379
402
  # @param [String] quota_user
@@ -391,7 +414,7 @@ module Google
391
414
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
392
415
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
393
416
  # @raise [Google::Apis::AuthorizationError] Authorization is required
394
- def messages_room_conversation(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
417
+ def messages_room_conversation(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
395
418
  command = make_simple_command(:post, 'v1/{+parent}/messages', options)
396
419
  command.request_representation = Google::Apis::ChatV1::Message::Representation
397
420
  command.request_object = message_object
@@ -399,6 +422,7 @@ module Google
399
422
  command.response_class = Google::Apis::ChatV1::Message
400
423
  command.params['parent'] = parent unless parent.nil?
401
424
  command.query['messageId'] = message_id unless message_id.nil?
425
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
402
426
  command.query['requestId'] = request_id unless request_id.nil?
403
427
  command.query['threadKey'] = thread_key unless thread_key.nil?
404
428
  command.query['fields'] = fields unless fields.nil?
@@ -406,8 +430,14 @@ module Google
406
430
  execute_or_queue_command(command, &block)
407
431
  end
408
432
 
409
- # Returns a space. Requires [service account authentication](https://developers.
410
- # google.com/chat/api/guides/auth/service-accounts).
433
+ # Returns a space. Requires [authentication](https://developers.google.com/chat/
434
+ # api/guides/auth). Fully supports [service account authentication](https://
435
+ # developers.google.com/chat/api/guides/auth/service-accounts). Supports [user
436
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) as
437
+ # part of the [Google Workspace Developer Preview Program](https://developers.
438
+ # google.com/workspace/preview), which grants early access to certain features. [
439
+ # User authentication](https://developers.google.com/chat/api/guides/auth/users)
440
+ # requires the `chat.spaces` or `chat.spaces.readonly` authorization scope.
411
441
  # @param [String] name
412
442
  # Required. Resource name of the space, in the form "spaces/*". Format: spaces/`
413
443
  # space`
@@ -438,14 +468,27 @@ module Google
438
468
  execute_or_queue_command(command, &block)
439
469
  end
440
470
 
441
- # Lists spaces the caller is a member of. Requires [service account
471
+ # Lists spaces the caller is a member of. Requires [authentication](https://
472
+ # developers.google.com/chat/api/guides/auth). Fully supports [service account
442
473
  # authentication](https://developers.google.com/chat/api/guides/auth/service-
443
- # accounts).
474
+ # accounts). Supports [user authentication](https://developers.google.com/chat/
475
+ # api/guides/auth/users) as part of the [Google Workspace Developer Preview
476
+ # Program](https://developers.google.com/workspace/preview), which grants early
477
+ # access to certain features. [User authentication](https://developers.google.
478
+ # com/chat/api/guides/auth/users) requires the `chat.spaces` or `chat.spaces.
479
+ # readonly` authorization scope. Lists spaces visible to the caller or
480
+ # authenticated user. Group chats and DMs aren't listed until the first message
481
+ # is sent.
444
482
  # @param [Fixnum] page_size
445
- # Optional. Requested page size. The value is capped at 1000. Server may return
446
- # fewer results than requested. If unspecified, server will default to 100.
483
+ # Optional. The maximum number of spaces to return. The service may return fewer
484
+ # than this value. If unspecified, at most 100 spaces are returned. The maximum
485
+ # value is 1000; values above 1000 are coerced to 1000. Negative values return
486
+ # an INVALID_ARGUMENT error.
447
487
  # @param [String] page_token
448
- # Optional. A token identifying a page of results the server should return.
488
+ # Optional. A page token, received from a previous list spaces call. Provide
489
+ # this to retrieve the subsequent page. When paginating, the filter value should
490
+ # match the call that provided the page token. Passing a different value may
491
+ # lead to unexpected results.
449
492
  # @param [String] fields
450
493
  # Selector specifying which fields to include in a partial response.
451
494
  # @param [String] quota_user
@@ -477,8 +520,8 @@ module Google
477
520
  # Legacy path for creating message. Calling these will result in a BadRequest
478
521
  # response.
479
522
  # @param [String] parent
480
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
481
- # AAAAAAAAAAA
523
+ # Required. The resource name of the space in which to create a message. Format:
524
+ # spaces/`space`
482
525
  # @param [Google::Apis::ChatV1::Message] message_object
483
526
  # @param [String] message_id
484
527
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -487,14 +530,17 @@ module Google
487
530
  # message with the specified value. For example usage, see [Name a created
488
531
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
489
532
  # name_a_created_message).
533
+ # @param [String] message_reply_option
534
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
535
+ # supported in named spaces.
490
536
  # @param [String] request_id
491
537
  # Optional. A unique request ID for this message. Specifying an existing request
492
538
  # ID returns the message created with that ID instead of creating a new message.
493
539
  # @param [String] thread_key
494
- # Optional. Opaque thread identifier. To start or add to a thread, create a
495
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
496
- # has no effect.) The first message with a given `threadKey` starts a new thread.
497
- # Subsequent messages with the same `threadKey` post into the same thread.
540
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
541
+ # To start or add to a thread, create a message and specify a `threadKey` or the
542
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
543
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
498
544
  # @param [String] fields
499
545
  # Selector specifying which fields to include in a partial response.
500
546
  # @param [String] quota_user
@@ -512,7 +558,7 @@ module Google
512
558
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
513
559
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
514
560
  # @raise [Google::Apis::AuthorizationError] Authorization is required
515
- def webhooks_space(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
561
+ def webhooks_space(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
516
562
  command = make_simple_command(:post, 'v1/{+parent}/webhooks', options)
517
563
  command.request_representation = Google::Apis::ChatV1::Message::Representation
518
564
  command.request_object = message_object
@@ -520,6 +566,7 @@ module Google
520
566
  command.response_class = Google::Apis::ChatV1::Message
521
567
  command.params['parent'] = parent unless parent.nil?
522
568
  command.query['messageId'] = message_id unless message_id.nil?
569
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
523
570
  command.query['requestId'] = request_id unless request_id.nil?
524
571
  command.query['threadKey'] = thread_key unless thread_key.nil?
525
572
  command.query['fields'] = fields unless fields.nil?
@@ -527,8 +574,16 @@ module Google
527
574
  execute_or_queue_command(command, &block)
528
575
  end
529
576
 
530
- # Returns a membership. Requires [service account authentication](https://
531
- # developers.google.com/chat/api/guides/auth/service-accounts).
577
+ # [Developer Preview](https://developers.google.com/workspace/preview): Returns
578
+ # a membership. Requires [authentication](https://developers.google.com/chat/api/
579
+ # guides/auth/). Fully supports [service account authentication](https://
580
+ # developers.google.com/chat/api/guides/auth/service-accounts). Supports [user
581
+ # authentication](https://developers.google.com/chat/api/guides/auth/users) as
582
+ # part of the [Google Workspace Developer Preview Program](https://developers.
583
+ # google.com/workspace/preview), which grants early access to certain features. [
584
+ # User authentication](https://developers.google.com/chat/api/guides/auth/users)
585
+ # requires the `chat.memberships` or `chat.memberships.readonly` authorization
586
+ # scope.
532
587
  # @param [String] name
533
588
  # Required. Resource name of the membership to retrieve. Format: spaces/`space`/
534
589
  # members/`member`
@@ -559,17 +614,29 @@ module Google
559
614
  execute_or_queue_command(command, &block)
560
615
  end
561
616
 
562
- # Lists human memberships in a space for joined members. Requires [service
563
- # account authentication](https://developers.google.com/chat/api/guides/auth/
564
- # service-accounts).
617
+ # [Developer Preview](https://developers.google.com/workspace/preview): Lists
618
+ # memberships in a space. Requires [authentication](https://developers.google.
619
+ # com/chat/api/guides/auth/). Fully supports [service account authentication](
620
+ # https://developers.google.com/chat/api/guides/auth/service-accounts). Supports
621
+ # [user authentication](https://developers.google.com/chat/api/guides/auth/users)
622
+ # as part of the [Google Workspace Developer Preview Program](https://
623
+ # developers.google.com/workspace/preview), which grants early access to certain
624
+ # features. [User authentication](https://developers.google.com/chat/api/guides/
625
+ # auth/users) requires the `chat.memberships` or `chat.memberships.readonly`
626
+ # authorization scope.
565
627
  # @param [String] parent
566
628
  # Required. The resource name of the space for which to fetch a membership list.
567
629
  # Format: spaces/`space`
568
630
  # @param [Fixnum] page_size
569
- # Requested page size. The value is capped at 1000. Server may return fewer
570
- # results than requested. If unspecified, server will default to 100.
631
+ # The maximum number of memberships to return. The service may return fewer than
632
+ # this value. If unspecified, at most 100 memberships are returned. The maximum
633
+ # value is 1000; values above 1000 are coerced to 1000. Negative values return
634
+ # an INVALID_ARGUMENT error.
571
635
  # @param [String] page_token
572
- # A token identifying a page of results the server should return.
636
+ # A page token, received from a previous list memberships call. Provide this to
637
+ # retrieve the subsequent page. When paginating, all other parameters provided
638
+ # should match the call that provided the page token. Passing different values
639
+ # to the other parameters may lead to unexpected results.
573
640
  # @param [String] fields
574
641
  # Selector specifying which fields to include in a partial response.
575
642
  # @param [String] quota_user
@@ -599,11 +666,22 @@ module Google
599
666
  execute_or_queue_command(command, &block)
600
667
  end
601
668
 
602
- # Creates a message. Requires [service account authentication](https://
603
- # developers.google.com/chat/api/guides/auth/service-accounts).
669
+ # Creates a message. For example usage, see [Create a message](https://
670
+ # developers.google.com/chat/api/guides/crudl/messages#create_a_message).
671
+ # Requires [authentication](https://developers.google.com/chat/api/guides/auth).
672
+ # Fully supports [service account authentication](https://developers.google.com/
673
+ # chat/api/guides/auth/service-accounts). Supports [user authentication](https://
674
+ # developers.google.com/chat/api/guides/auth/users) as part of the [Google
675
+ # Workspace Developer Preview Program](https://developers.google.com/workspace/
676
+ # preview), which grants early access to certain features. [User authentication](
677
+ # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
678
+ # messages` or `chat.messages.create` authorization scope. Because Chat provides
679
+ # authentication for [webhooks](https://developers.google.com/chat/how-tos/
680
+ # webhooks) as part of the URL that's generated when a webhook is registered,
681
+ # webhooks can create messages without a service account or user authentication.
604
682
  # @param [String] parent
605
- # Required. Space resource name, in the form "spaces/*". Example: spaces/
606
- # AAAAAAAAAAA
683
+ # Required. The resource name of the space in which to create a message. Format:
684
+ # spaces/`space`
607
685
  # @param [Google::Apis::ChatV1::Message] message_object
608
686
  # @param [String] message_id
609
687
  # Optional. A custom name for a Chat message assigned at creation. Must start
@@ -612,14 +690,17 @@ module Google
612
690
  # message with the specified value. For example usage, see [Name a created
613
691
  # message](https://developers.google.com/chat/api/guides/crudl/messages#
614
692
  # name_a_created_message).
693
+ # @param [String] message_reply_option
694
+ # Optional. Specifies whether a message starts a thread or replies to one. Only
695
+ # supported in named spaces.
615
696
  # @param [String] request_id
616
697
  # Optional. A unique request ID for this message. Specifying an existing request
617
698
  # ID returns the message created with that ID instead of creating a new message.
618
699
  # @param [String] thread_key
619
- # Optional. Opaque thread identifier. To start or add to a thread, create a
620
- # message and specify a `threadKey` instead of thread.name. (Setting thread.name
621
- # has no effect.) The first message with a given `threadKey` starts a new thread.
622
- # Subsequent messages with the same `threadKey` post into the same thread.
700
+ # Optional. Deprecated: Use thread.thread_key instead. Opaque thread identifier.
701
+ # To start or add to a thread, create a message and specify a `threadKey` or the
702
+ # thread.name. For example usage, see [Start or reply to a message thread](/chat/
703
+ # api/guides/crudl/messages#start_or_reply_to_a_message_thread).
623
704
  # @param [String] fields
624
705
  # Selector specifying which fields to include in a partial response.
625
706
  # @param [String] quota_user
@@ -637,7 +718,7 @@ module Google
637
718
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
638
719
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
639
720
  # @raise [Google::Apis::AuthorizationError] Authorization is required
640
- def create_space_message(parent, message_object = nil, message_id: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
721
+ def create_space_message(parent, message_object = nil, message_id: nil, message_reply_option: nil, request_id: nil, thread_key: nil, fields: nil, quota_user: nil, options: nil, &block)
641
722
  command = make_simple_command(:post, 'v1/{+parent}/messages', options)
642
723
  command.request_representation = Google::Apis::ChatV1::Message::Representation
643
724
  command.request_object = message_object
@@ -645,6 +726,7 @@ module Google
645
726
  command.response_class = Google::Apis::ChatV1::Message
646
727
  command.params['parent'] = parent unless parent.nil?
647
728
  command.query['messageId'] = message_id unless message_id.nil?
729
+ command.query['messageReplyOption'] = message_reply_option unless message_reply_option.nil?
648
730
  command.query['requestId'] = request_id unless request_id.nil?
649
731
  command.query['threadKey'] = thread_key unless thread_key.nil?
650
732
  command.query['fields'] = fields unless fields.nil?
@@ -652,8 +734,16 @@ module Google
652
734
  execute_or_queue_command(command, &block)
653
735
  end
654
736
 
655
- # Deletes a message. Requires [service account authentication](https://
656
- # developers.google.com/chat/api/guides/auth/service-accounts).
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.
657
747
  # @param [String] name
658
748
  # Required. Resource name of the message to be deleted, in the form "spaces/*/
659
749
  # messages/*" Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB
@@ -684,8 +774,17 @@ module Google
684
774
  execute_or_queue_command(command, &block)
685
775
  end
686
776
 
687
- # Returns a message. Requires [service account authentication](https://
688
- # developers.google.com/chat/api/guides/auth/service-accounts).
777
+ # Returns a message. For example usage, see [Read a message](https://developers.
778
+ # google.com/chat/api/guides/crudl/messages#read_a_message). Requires [
779
+ # authentication](https://developers.google.com/chat/api/guides/auth). Fully
780
+ # supports [Service account authentication](https://developers.google.com/chat/
781
+ # api/guides/auth/service-accounts). Supports [user authentication](https://
782
+ # developers.google.com/chat/api/guides/auth/users) as part of the [Google
783
+ # Workspace Developer Preview Program](https://developers.google.com/workspace/
784
+ # preview), which grants early access to certain features. [User authentication](
785
+ # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
786
+ # messages` or `chat.messages.readonly` authorization scope. Note: Might return
787
+ # a message from a blocked member or space.
689
788
  # @param [String] name
690
789
  # Required. Resource name of the message to retrieve. Format: spaces/`space`/
691
790
  # messages/`message` If the message begins with `client-`, then it has a custom
@@ -720,8 +819,70 @@ module Google
720
819
  execute_or_queue_command(command, &block)
721
820
  end
722
821
 
723
- # Updates a message. Requires [service account authentication](https://
724
- # developers.google.com/chat/api/guides/auth/service-accounts).
822
+ # Updates a message. For example usage, see [Update a message](https://
823
+ # developers.google.com/chat/api/guides/crudl/messages#update_a_message).
824
+ # Requires [authentication](https://developers.google.com/chat/api/guides/auth/).
825
+ # Fully supports [service account authentication](https://developers.google.com/
826
+ # chat/api/guides/auth/service-accounts). Supports [user authentication](https://
827
+ # developers.google.com/chat/api/guides/auth/users) as part of the [Google
828
+ # Workspace Developer Preview Program](https://developers.google.com/workspace/
829
+ # preview), which grants early access to certain features. [User authentication](
830
+ # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
831
+ # messages` authorization scope.
832
+ # @param [String] name
833
+ # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/
834
+ # messages/BBBBBBBBBBB.BBBBBBBBBBB`
835
+ # @param [Google::Apis::ChatV1::Message] message_object
836
+ # @param [Boolean] allow_missing
837
+ # Optional. If `true` and the message is not found, a new message is created and
838
+ # `updateMask` is ignored. The specified message ID must be [client-assigned](
839
+ # https://developers.google.com/chat/api/guides/crudl/messages#
840
+ # name_a_created_message) or the request fails.
841
+ # @param [String] update_mask
842
+ # Required. The field paths to update. Separate multiple values with commas.
843
+ # Currently supported field paths: - text - cards (Requires [service account
844
+ # authentication](/chat/api/guides/auth/service-accounts).) - cards_v2
845
+ # @param [String] fields
846
+ # Selector specifying which fields to include in a partial response.
847
+ # @param [String] quota_user
848
+ # Available to use for quota purposes for server-side applications. Can be any
849
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
850
+ # @param [Google::Apis::RequestOptions] options
851
+ # Request-specific options
852
+ #
853
+ # @yield [result, err] Result & error if block supplied
854
+ # @yieldparam result [Google::Apis::ChatV1::Message] parsed result object
855
+ # @yieldparam err [StandardError] error object if request failed
856
+ #
857
+ # @return [Google::Apis::ChatV1::Message]
858
+ #
859
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
860
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
861
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
862
+ def patch_space_message(name, message_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
863
+ command = make_simple_command(:patch, 'v1/{+name}', options)
864
+ command.request_representation = Google::Apis::ChatV1::Message::Representation
865
+ command.request_object = message_object
866
+ command.response_representation = Google::Apis::ChatV1::Message::Representation
867
+ command.response_class = Google::Apis::ChatV1::Message
868
+ command.params['name'] = name unless name.nil?
869
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
870
+ command.query['updateMask'] = update_mask unless update_mask.nil?
871
+ command.query['fields'] = fields unless fields.nil?
872
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
873
+ execute_or_queue_command(command, &block)
874
+ end
875
+
876
+ # Updates a message. For example usage, see [Update a message](https://
877
+ # developers.google.com/chat/api/guides/crudl/messages#update_a_message).
878
+ # Requires [authentication](https://developers.google.com/chat/api/guides/auth/).
879
+ # Fully supports [service account authentication](https://developers.google.com/
880
+ # chat/api/guides/auth/service-accounts). Supports [user authentication](https://
881
+ # developers.google.com/chat/api/guides/auth/users) as part of the [Google
882
+ # Workspace Developer Preview Program](https://developers.google.com/workspace/
883
+ # preview), which grants early access to certain features. [User authentication](
884
+ # https://developers.google.com/chat/api/guides/auth/users) requires the `chat.
885
+ # messages` authorization scope.
725
886
  # @param [String] name
726
887
  # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/
727
888
  # messages/BBBBBBBBBBB.BBBBBBBBBBB`