google-apis-chat_v1 0.89.0 → 0.91.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +8 -0
- data/lib/google/apis/chat_v1/classes.rb +586 -525
- data/lib/google/apis/chat_v1/gem_version.rb +2 -2
- data/lib/google/apis/chat_v1/service.rb +309 -243
- metadata +3 -3
@@ -91,12 +91,12 @@ module Google
|
|
91
91
|
end
|
92
92
|
|
93
93
|
# Uploads an attachment. For an example, see [Upload media as a file attachment](
|
94
|
-
# https://developers.google.com/chat/
|
95
|
-
# Requires user [authentication](https://developers.google.com/chat/
|
96
|
-
#
|
97
|
-
# t supported. For details, see [File types blocked by
|
98
|
-
# support.google.com/chat/answer/7651457?&co=GENIE.Platform%
|
99
|
-
# 20types%20blocked%20in%20Google%20Chat).
|
94
|
+
# https://developers.google.com/workspace/chat/upload-media-attachments).
|
95
|
+
# Requires user [authentication](https://developers.google.com/workspace/chat/
|
96
|
+
# authenticate-authorize-chat-user). You can upload attachments up to 200 MB.
|
97
|
+
# Certain file types aren't supported. For details, see [File types blocked by
|
98
|
+
# Google Chat](https://support.google.com/chat/answer/7651457?&co=GENIE.Platform%
|
99
|
+
# 3DDesktop#File%20types%20blocked%20in%20Google%20Chat).
|
100
100
|
# @param [String] parent
|
101
101
|
# Required. Resource name of the Chat space in which the attachment is uploaded.
|
102
102
|
# Format "spaces/`space`".
|
@@ -140,11 +140,11 @@ module Google
|
|
140
140
|
execute_or_queue_command(command, &block)
|
141
141
|
end
|
142
142
|
|
143
|
-
# Completes the [import process](https://developers.google.com/chat/
|
143
|
+
# Completes the [import process](https://developers.google.com/workspace/chat/
|
144
144
|
# import-data) for the specified space and makes it visible to users. Requires
|
145
145
|
# app authentication and domain-wide delegation. For more information, see [
|
146
|
-
# Authorize Google Chat apps to import data](https://developers.google.com/
|
147
|
-
#
|
146
|
+
# Authorize Google Chat apps to import data](https://developers.google.com/
|
147
|
+
# workspace/chat/authorize-import).
|
148
148
|
# @param [String] name
|
149
149
|
# Required. Resource name of the import mode space. Format: `spaces/`space``
|
150
150
|
# @param [Google::Apis::ChatV1::CompleteImportSpaceRequest] complete_import_space_request_object
|
@@ -178,11 +178,12 @@ module Google
|
|
178
178
|
end
|
179
179
|
|
180
180
|
# Creates a named space. Spaces grouped by topics aren't supported. For an
|
181
|
-
# example, see [Create a space](https://developers.google.com/chat/
|
182
|
-
# spaces
|
181
|
+
# example, see [Create a space](https://developers.google.com/workspace/chat/
|
182
|
+
# create-spaces). If you receive the error message `ALREADY_EXISTS` when
|
183
183
|
# creating a space, try a different `displayName`. An existing space within the
|
184
184
|
# Google Workspace organization might already use this display name. Requires [
|
185
|
-
# user authentication](https://developers.google.com/chat/
|
185
|
+
# user authentication](https://developers.google.com/workspace/chat/authenticate-
|
186
|
+
# authorize-chat-user).
|
186
187
|
# @param [Google::Apis::ChatV1::Space] space_object
|
187
188
|
# @param [String] request_id
|
188
189
|
# Optional. A unique identifier for this request. A random UUID is recommended.
|
@@ -221,9 +222,9 @@ module Google
|
|
221
222
|
# Deletes a named space. Always performs a cascading delete, which means that
|
222
223
|
# the space's child resources—like messages posted in the space and memberships
|
223
224
|
# in the space—are also deleted. For an example, see [Delete a space](https://
|
224
|
-
# developers.google.com/chat/
|
225
|
-
# authentication](https://developers.google.com/chat/
|
226
|
-
# a user who has permission to delete the space.
|
225
|
+
# developers.google.com/workspace/chat/delete-spaces). Requires [user
|
226
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
227
|
+
# authorize-chat-user) from a user who has permission to delete the space.
|
227
228
|
# @param [String] name
|
228
229
|
# Required. Resource name of the space to delete. Format: `spaces/`space``
|
229
230
|
# @param [String] fields
|
@@ -256,14 +257,14 @@ module Google
|
|
256
257
|
# Returns the existing direct message with the specified user. If no direct
|
257
258
|
# message space is found, returns a `404 NOT_FOUND` error. For an example, see [
|
258
259
|
# Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [
|
259
|
-
# user authentication](https://developers.google.com/chat/
|
260
|
-
# returns the direct message space between the specified
|
261
|
-
# authenticated user. With [app authentication](https://developers.
|
262
|
-
#
|
263
|
-
# between the specified user and the calling Chat app. Requires [
|
264
|
-
# authentication](https://developers.google.com/chat/
|
265
|
-
# app authentication](https://developers.google.com/
|
266
|
-
#
|
260
|
+
# user authentication](https://developers.google.com/workspace/chat/authenticate-
|
261
|
+
# authorize-chat-user), returns the direct message space between the specified
|
262
|
+
# user and the authenticated user. With [app authentication](https://developers.
|
263
|
+
# google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct
|
264
|
+
# message space between the specified user and the calling Chat app. Requires [
|
265
|
+
# user authentication](https://developers.google.com/workspace/chat/authenticate-
|
266
|
+
# authorize-chat-user) or [app authentication](https://developers.google.com/
|
267
|
+
# workspace/chat/authenticate-authorize-chat-app).
|
267
268
|
# @param [String] name
|
268
269
|
# Required. Resource name of the user to find direct message with. Format: `
|
269
270
|
# users/`user``, where ``user`` is either the `id` for the [person](https://
|
@@ -272,9 +273,9 @@ module Google
|
|
272
273
|
# rest/v1/users) in the Directory API. For example, if the People API profile ID
|
273
274
|
# is `123456789`, you can find a direct message with that person by using `users/
|
274
275
|
# 123456789` as the `name`. When [authenticated as a user](https://developers.
|
275
|
-
# google.com/chat/
|
276
|
-
#
|
277
|
-
# the email of the Google Chat user.
|
276
|
+
# google.com/workspace/chat/authenticate-authorize-chat-user), you can use the
|
277
|
+
# email as an alias for ``user``. For example, `users/example@gmail.com` where `
|
278
|
+
# example@gmail.com` is the email of the Google Chat user.
|
278
279
|
# @param [String] fields
|
279
280
|
# Selector specifying which fields to include in a partial response.
|
280
281
|
# @param [String] quota_user
|
@@ -302,12 +303,12 @@ module Google
|
|
302
303
|
execute_or_queue_command(command, &block)
|
303
304
|
end
|
304
305
|
|
305
|
-
# Returns details about a space. For an example, see [Get a space](
|
306
|
-
# developers.google.com/chat/
|
307
|
-
# (https://developers.google.com/chat/
|
308
|
-
# authentication](https://developers.google.com/
|
309
|
-
#
|
310
|
-
#
|
306
|
+
# Returns details about a space. For an example, see [Get details about a space](
|
307
|
+
# https://developers.google.com/workspace/chat/get-spaces). Requires [
|
308
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
309
|
+
# authorize). Supports [app authentication](https://developers.google.com/
|
310
|
+
# workspace/chat/authenticate-authorize-chat-app) and [user authentication](
|
311
|
+
# https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
|
311
312
|
# @param [String] name
|
312
313
|
# Required. Resource name of the space, in the form "spaces/*". Format: `spaces/`
|
313
314
|
# space``
|
@@ -340,21 +341,22 @@ module Google
|
|
340
341
|
|
341
342
|
# Lists spaces the caller is a member of. Group chats and DMs aren't listed
|
342
343
|
# until the first message is sent. For an example, see [List spaces](https://
|
343
|
-
# developers.google.com/chat/
|
344
|
-
#
|
345
|
-
# app authentication](https://developers.google.com/chat/
|
346
|
-
#
|
347
|
-
#
|
348
|
-
# Group chats and DMs aren't listed until the
|
344
|
+
# developers.google.com/workspace/chat/list-spaces). Requires [authentication](
|
345
|
+
# https://developers.google.com/workspace/chat/authenticate-authorize). Supports
|
346
|
+
# [app authentication](https://developers.google.com/workspace/chat/authenticate-
|
347
|
+
# authorize-chat-app) and [user authentication](https://developers.google.com/
|
348
|
+
# workspace/chat/authenticate-authorize-chat-user). Lists spaces visible to the
|
349
|
+
# caller or authenticated user. Group chats and DMs aren't listed until the
|
350
|
+
# first message is sent.
|
349
351
|
# @param [String] filter
|
350
352
|
# Optional. A query filter. You can filter spaces by the space type ([`
|
351
|
-
# space_type`](https://developers.google.com/chat/api/reference/rest/
|
352
|
-
# spacetype)). To filter by space type, you must specify valid enum
|
353
|
-
# as `SPACE` or `GROUP_CHAT` (the `space_type` can't be `
|
354
|
-
# . To query for multiple space types, use the `OR`
|
355
|
-
# following queries are valid: ``` space_type = "
|
356
|
-
# OR spaceType = "DIRECT_MESSAGE" ``` Invalid
|
357
|
-
# with an `INVALID_ARGUMENT` error.
|
353
|
+
# space_type`](https://developers.google.com/workspace/chat/api/reference/rest/
|
354
|
+
# v1/spaces#spacetype)). To filter by space type, you must specify valid enum
|
355
|
+
# value, such as `SPACE` or `GROUP_CHAT` (the `space_type` can't be `
|
356
|
+
# SPACE_TYPE_UNSPECIFIED`). To query for multiple space types, use the `OR`
|
357
|
+
# operator. For example, the following queries are valid: ``` space_type = "
|
358
|
+
# SPACE" spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE" ``` Invalid
|
359
|
+
# queries are rejected by the server with an `INVALID_ARGUMENT` error.
|
358
360
|
# @param [Fixnum] page_size
|
359
361
|
# Optional. The maximum number of spaces to return. The service might return
|
360
362
|
# fewer than this value. If unspecified, at most 100 spaces are returned. The
|
@@ -395,11 +397,11 @@ module Google
|
|
395
397
|
end
|
396
398
|
|
397
399
|
# Updates a space. For an example, see [Update a space](https://developers.
|
398
|
-
# google.com/chat/
|
399
|
-
#
|
400
|
-
#
|
401
|
-
#
|
402
|
-
#
|
400
|
+
# google.com/workspace/chat/update-spaces). If you're updating the `displayName`
|
401
|
+
# field and receive the error message `ALREADY_EXISTS`, try a different display
|
402
|
+
# name.. An existing space within the Google Workspace organization might
|
403
|
+
# already use this display name. Requires [user authentication](https://
|
404
|
+
# developers.google.com/workspace/chat/authenticate-authorize-chat-user).
|
403
405
|
# @param [String] name
|
404
406
|
# Resource name of the space. Format: `spaces/`space``
|
405
407
|
# @param [Google::Apis::ChatV1::Space] space_object
|
@@ -459,32 +461,32 @@ module Google
|
|
459
461
|
|
460
462
|
# Creates a space and adds specified users to it. The calling user is
|
461
463
|
# automatically added to the space, and shouldn't be specified as a membership
|
462
|
-
# in the request. For an example, see [Set up a space](
|
463
|
-
# com/chat/
|
464
|
-
# add memberships with the appropriate `member.name` in
|
465
|
-
# To add a human user, use `users/`user``, where ``user
|
466
|
-
# address for the user. For users in the same Workspace
|
467
|
-
# can also be the `id` for the person from the People API,
|
468
|
-
# user in the Directory API. For example, if the People API
|
469
|
-
# for `user@example.com` is `123456789`, you can add the user
|
470
|
-
# setting the `membership.member.name` to `users/user@example.
|
471
|
-
# 123456789`. For a space or group chat, if the caller blocks or
|
472
|
-
# some members, then those members aren't added to the created
|
473
|
-
# a direct message (DM) between the calling user and another
|
474
|
-
# exactly one membership to represent the human user. If one
|
475
|
-
# other, the request fails and the DM isn't created. To create a
|
476
|
-
# calling user and the calling app, set `Space.singleUserBotDm`
|
477
|
-
# don't specify any memberships. You can only use this method to
|
478
|
-
# with the calling app. To add the calling app as a member of a
|
479
|
-
# existing DM between two human users, see [
|
480
|
-
# developers.google.com/chat/
|
481
|
-
# exists between two users, even when one user blocks the other
|
482
|
-
# request is made, then the existing DM is returned. Spaces with
|
483
|
-
# replies aren't supported. If you receive the error message `
|
484
|
-
# when setting up a space, try a different `displayName`. An
|
485
|
-
# within the Google Workspace organization might already use this
|
486
|
-
# Requires [user authentication](https://developers.google.com/
|
487
|
-
#
|
464
|
+
# in the request. For an example, see [Set up a space with initial members](
|
465
|
+
# https://developers.google.com/workspace/chat/set-up-spaces). To specify the
|
466
|
+
# human members to add, add memberships with the appropriate `member.name` in
|
467
|
+
# the `SetUpSpaceRequest`. To add a human user, use `users/`user``, where ``user`
|
468
|
+
# ` can be the email address for the user. For users in the same Workspace
|
469
|
+
# organization ``user`` can also be the `id` for the person from the People API,
|
470
|
+
# or the `id` for the user in the Directory API. For example, if the People API
|
471
|
+
# Person profile ID for `user@example.com` is `123456789`, you can add the user
|
472
|
+
# to the space by setting the `membership.member.name` to `users/user@example.
|
473
|
+
# com` or `users/123456789`. For a space or group chat, if the caller blocks or
|
474
|
+
# is blocked by some members, then those members aren't added to the created
|
475
|
+
# space. To create a direct message (DM) between the calling user and another
|
476
|
+
# human user, specify exactly one membership to represent the human user. If one
|
477
|
+
# user blocks the other, the request fails and the DM isn't created. To create a
|
478
|
+
# DM between the calling user and the calling app, set `Space.singleUserBotDm`
|
479
|
+
# to `true` and don't specify any memberships. You can only use this method to
|
480
|
+
# set up a DM with the calling app. To add the calling app as a member of a
|
481
|
+
# space or an existing DM between two human users, see [Invite or add a user or
|
482
|
+
# app to a space](https://developers.google.com/workspace/chat/create-members).
|
483
|
+
# If a DM already exists between two users, even when one user blocks the other
|
484
|
+
# at the time a request is made, then the existing DM is returned. Spaces with
|
485
|
+
# threaded replies aren't supported. If you receive the error message `
|
486
|
+
# ALREADY_EXISTS` when setting up a space, try a different `displayName`. An
|
487
|
+
# existing space within the Google Workspace organization might already use this
|
488
|
+
# display name. Requires [user authentication](https://developers.google.com/
|
489
|
+
# workspace/chat/authenticate-authorize-chat-user).
|
488
490
|
# @param [Google::Apis::ChatV1::SetUpSpaceRequest] set_up_space_request_object
|
489
491
|
# @param [String] fields
|
490
492
|
# Selector specifying which fields to include in a partial response.
|
@@ -515,22 +517,23 @@ module Google
|
|
515
517
|
end
|
516
518
|
|
517
519
|
# Creates a human membership or app membership for the calling app. Creating
|
518
|
-
# memberships for other apps isn't supported. For an example, see [
|
519
|
-
#
|
520
|
-
# When creating a membership, if the specified
|
521
|
-
# policy turned off, then they're invited, and must
|
522
|
-
# before joining. Otherwise, creating a membership
|
523
|
-
# the specified space. Requires [user authentication]
|
524
|
-
# com/chat/
|
525
|
-
# membership.member.name` in the `
|
526
|
-
# app to a space or a direct
|
527
|
-
#
|
528
|
-
#
|
529
|
-
#
|
530
|
-
#
|
531
|
-
#
|
532
|
-
#
|
533
|
-
# user@example.com` or `
|
520
|
+
# memberships for other apps isn't supported. For an example, see [Invite or add
|
521
|
+
# a user or a Google Chat app to a space](https://developers.google.com/
|
522
|
+
# workspace/chat/create-members). When creating a membership, if the specified
|
523
|
+
# member has their auto-accept policy turned off, then they're invited, and must
|
524
|
+
# accept the space invitation before joining. Otherwise, creating a membership
|
525
|
+
# adds the member directly to the specified space. Requires [user authentication]
|
526
|
+
# (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
|
527
|
+
# . To specify the member to add, set the `membership.member.name` in the `
|
528
|
+
# CreateMembershipRequest`: - To add the calling app to a space or a direct
|
529
|
+
# message between two human users, use `users/app`. Unable to add other apps to
|
530
|
+
# the space. - To add a human user, use `users/`user``, where ``user`` can be
|
531
|
+
# the email address for the user. For users in the same Workspace organization ``
|
532
|
+
# user`` can also be the `id` for the person from the People API, or the `id`
|
533
|
+
# for the user in the Directory API. For example, if the People API Person
|
534
|
+
# profile ID for `user@example.com` is `123456789`, you can add the user to the
|
535
|
+
# space by setting the `membership.member.name` to `users/user@example.com` or `
|
536
|
+
# users/123456789`.
|
534
537
|
# @param [String] parent
|
535
538
|
# Required. The resource name of the space for which to create the membership.
|
536
539
|
# Format: spaces/`space`
|
@@ -564,9 +567,10 @@ module Google
|
|
564
567
|
execute_or_queue_command(command, &block)
|
565
568
|
end
|
566
569
|
|
567
|
-
# Deletes a membership. For an example, see [
|
568
|
-
# developers.google.com/chat/
|
569
|
-
# authentication](https://developers.google.com/chat/
|
570
|
+
# Deletes a membership. For an example, see [Remove a user or a Google Chat app
|
571
|
+
# from a space](https://developers.google.com/workspace/chat/delete-members).
|
572
|
+
# Requires [user authentication](https://developers.google.com/workspace/chat/
|
573
|
+
# authenticate-authorize-chat-user).
|
570
574
|
# @param [String] name
|
571
575
|
# Required. Resource name of the membership to delete. Chat apps can delete
|
572
576
|
# human users' or their own memberships. Chat apps can't delete other apps'
|
@@ -604,20 +608,23 @@ module Google
|
|
604
608
|
execute_or_queue_command(command, &block)
|
605
609
|
end
|
606
610
|
|
607
|
-
# Returns details about a membership. For an example, see [Get a
|
608
|
-
# https://developers.google.com/
|
609
|
-
#
|
610
|
-
#
|
611
|
-
#
|
612
|
-
#
|
611
|
+
# Returns details about a membership. For an example, see [Get details about a
|
612
|
+
# user's or Google Chat app's membership](https://developers.google.com/
|
613
|
+
# workspace/chat/get-members). Requires [authentication](https://developers.
|
614
|
+
# google.com/workspace/chat/authenticate-authorize). Supports [app
|
615
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
616
|
+
# authorize-chat-app) and [user authentication](https://developers.google.com/
|
617
|
+
# workspace/chat/authenticate-authorize-chat-user).
|
613
618
|
# @param [String] name
|
614
619
|
# Required. Resource name of the membership to retrieve. To get the app's own
|
615
|
-
# membership
|
616
|
-
#
|
617
|
-
#
|
618
|
-
#
|
619
|
-
#
|
620
|
-
# email
|
620
|
+
# membership [by using user authentication](https://developers.google.com/
|
621
|
+
# workspace/chat/authenticate-authorize-chat-user), you can optionally use `
|
622
|
+
# spaces/`space`/members/app`. Format: `spaces/`space`/members/`member`` or `
|
623
|
+
# spaces/`space`/members/app` When [authenticated as a user](https://developers.
|
624
|
+
# google.com/workspace/chat/authenticate-authorize-chat-user), you can use the
|
625
|
+
# user's email as an alias for ``member``. For example, `spaces/`space`/members/
|
626
|
+
# example@gmail.com` where `example@gmail.com` is the email of the Google Chat
|
627
|
+
# user.
|
621
628
|
# @param [String] fields
|
622
629
|
# Selector specifying which fields to include in a partial response.
|
623
630
|
# @param [String] quota_user
|
@@ -645,33 +652,34 @@ module Google
|
|
645
652
|
execute_or_queue_command(command, &block)
|
646
653
|
end
|
647
654
|
|
648
|
-
# Lists memberships in a space. For an example, see [List
|
649
|
-
# developers.google.com/chat/
|
650
|
-
# with [app authentication](https://developers.google.com/
|
651
|
-
#
|
652
|
-
#
|
653
|
-
# [User authentication](https://developers.
|
654
|
-
# lists memberships
|
655
|
-
# Requires [authentication](
|
656
|
-
#
|
657
|
-
#
|
658
|
-
# chat
|
655
|
+
# Lists memberships in a space. For an example, see [List users and Google Chat
|
656
|
+
# apps in a space](https://developers.google.com/workspace/chat/list-members).
|
657
|
+
# Listing memberships with [app authentication](https://developers.google.com/
|
658
|
+
# workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces
|
659
|
+
# that the Chat app has access to, but excludes Chat app memberships, including
|
660
|
+
# its own. Listing memberships with [User authentication](https://developers.
|
661
|
+
# google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships
|
662
|
+
# in spaces that the authenticated user has access to. Requires [authentication](
|
663
|
+
# https://developers.google.com/workspace/chat/authenticate-authorize). Supports
|
664
|
+
# [app authentication](https://developers.google.com/workspace/chat/authenticate-
|
665
|
+
# authorize-chat-app) and [user authentication](https://developers.google.com/
|
666
|
+
# workspace/chat/authenticate-authorize-chat-user).
|
659
667
|
# @param [String] parent
|
660
668
|
# Required. The resource name of the space for which to fetch a membership list.
|
661
669
|
# Format: spaces/`space`
|
662
670
|
# @param [String] filter
|
663
671
|
# Optional. A query filter. You can filter memberships by a member's role ([`
|
664
|
-
# role`](https://developers.google.com/chat/api/reference/rest/v1/
|
665
|
-
# membershiprole)) and type ([`member.type`](https://developers.
|
666
|
-
# api/reference/rest/v1/User#type)). To filter by role,
|
667
|
-
# ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.
|
668
|
-
# or `BOT`. To filter by both role and type, use the `AND`
|
669
|
-
# by either role or type, use the `OR` operator. For example,
|
670
|
-
# queries are valid: ``` role = "ROLE_MANAGER" OR role = "
|
671
|
-
# type = "HUMAN" AND role = "ROLE_MANAGER" ``` The following
|
672
|
-
# ``` member.type = "HUMAN" AND member.type = "BOT" role = "
|
673
|
-
# role = "ROLE_MEMBER" ``` Invalid queries are rejected by the
|
674
|
-
# INVALID_ARGUMENT` error.
|
672
|
+
# role`](https://developers.google.com/workspace/chat/api/reference/rest/v1/
|
673
|
+
# spaces.members#membershiprole)) and type ([`member.type`](https://developers.
|
674
|
+
# google.com/workspace/chat/api/reference/rest/v1/User#type)). To filter by role,
|
675
|
+
# set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.
|
676
|
+
# type` to `HUMAN` or `BOT`. To filter by both role and type, use the `AND`
|
677
|
+
# operator. To filter by either role or type, use the `OR` operator. For example,
|
678
|
+
# the following queries are valid: ``` role = "ROLE_MANAGER" OR role = "
|
679
|
+
# ROLE_MEMBER" member.type = "HUMAN" AND role = "ROLE_MANAGER" ``` The following
|
680
|
+
# queries are invalid: ``` member.type = "HUMAN" AND member.type = "BOT" role = "
|
681
|
+
# ROLE_MANAGER" AND role = "ROLE_MEMBER" ``` Invalid queries are rejected by the
|
682
|
+
# server with an `INVALID_ARGUMENT` error.
|
675
683
|
# @param [Fixnum] page_size
|
676
684
|
# Optional. The maximum number of memberships to return. The service might
|
677
685
|
# return fewer than this value. If unspecified, at most 100 memberships are
|
@@ -692,8 +700,8 @@ module Google
|
|
692
700
|
# Optional. When `true`, also returns memberships associated with invited
|
693
701
|
# members, in addition to other types of memberships. If a filter is set,
|
694
702
|
# invited memberships that don't match the filter criteria aren't returned.
|
695
|
-
# Currently requires [user authentication](https://developers.google.com/
|
696
|
-
#
|
703
|
+
# Currently requires [user authentication](https://developers.google.com/
|
704
|
+
# workspace/chat/authenticate-authorize-chat-user).
|
697
705
|
# @param [String] fields
|
698
706
|
# Selector specifying which fields to include in a partial response.
|
699
707
|
# @param [String] quota_user
|
@@ -726,10 +734,49 @@ module Google
|
|
726
734
|
execute_or_queue_command(command, &block)
|
727
735
|
end
|
728
736
|
|
729
|
-
#
|
730
|
-
#
|
731
|
-
#
|
732
|
-
#
|
737
|
+
# Updates a membership. Requires [user authentication](https://developers.google.
|
738
|
+
# com/workspace/chat/authenticate-authorize-chat-user).
|
739
|
+
# @param [String] name
|
740
|
+
# Resource name of the membership, assigned by the server. Format: `spaces/`
|
741
|
+
# space`/members/`member``
|
742
|
+
# @param [Google::Apis::ChatV1::Membership] membership_object
|
743
|
+
# @param [String] update_mask
|
744
|
+
# Required. The field paths to update. Separate multiple values with commas or
|
745
|
+
# use `*` to update all field paths. Currently supported field paths: - `role`
|
746
|
+
# @param [String] fields
|
747
|
+
# Selector specifying which fields to include in a partial response.
|
748
|
+
# @param [String] quota_user
|
749
|
+
# Available to use for quota purposes for server-side applications. Can be any
|
750
|
+
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
751
|
+
# @param [Google::Apis::RequestOptions] options
|
752
|
+
# Request-specific options
|
753
|
+
#
|
754
|
+
# @yield [result, err] Result & error if block supplied
|
755
|
+
# @yieldparam result [Google::Apis::ChatV1::Membership] parsed result object
|
756
|
+
# @yieldparam err [StandardError] error object if request failed
|
757
|
+
#
|
758
|
+
# @return [Google::Apis::ChatV1::Membership]
|
759
|
+
#
|
760
|
+
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
761
|
+
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
762
|
+
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
763
|
+
def patch_space_member(name, membership_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
764
|
+
command = make_simple_command(:patch, 'v1/{+name}', options)
|
765
|
+
command.request_representation = Google::Apis::ChatV1::Membership::Representation
|
766
|
+
command.request_object = membership_object
|
767
|
+
command.response_representation = Google::Apis::ChatV1::Membership::Representation
|
768
|
+
command.response_class = Google::Apis::ChatV1::Membership
|
769
|
+
command.params['name'] = name unless name.nil?
|
770
|
+
command.query['updateMask'] = update_mask unless update_mask.nil?
|
771
|
+
command.query['fields'] = fields unless fields.nil?
|
772
|
+
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
773
|
+
execute_or_queue_command(command, &block)
|
774
|
+
end
|
775
|
+
|
776
|
+
# Creates a message in a Google Chat space. For an example, see [Send a message](
|
777
|
+
# https://developers.google.com/workspace/chat/create-messages). Calling this
|
778
|
+
# method requires [authentication](https://developers.google.com/workspace/chat/
|
779
|
+
# authenticate-authorize) and supports the following authentication types: - For
|
733
780
|
# text messages, user authentication or app authentication are supported. - For
|
734
781
|
# card messages, only app authentication is supported. (Only Chat apps can
|
735
782
|
# create card messages.)
|
@@ -746,7 +793,7 @@ module Google
|
|
746
793
|
# Contains up to 63 characters and only lowercase letters, numbers, and hyphens.
|
747
794
|
# * Is unique within a space. A Chat app can't use the same custom ID for
|
748
795
|
# different messages. For details, see [Name a message](https://developers.
|
749
|
-
# google.com/chat/
|
796
|
+
# google.com/workspace/chat/create-messages#name_a_created_message).
|
750
797
|
# @param [String] message_reply_option
|
751
798
|
# Optional. Specifies whether a message starts a thread or replies to one. Only
|
752
799
|
# supported in named spaces.
|
@@ -757,8 +804,8 @@ module Google
|
|
757
804
|
# Optional. Deprecated: Use thread.thread_key instead. ID for the thread.
|
758
805
|
# Supports up to 4000 characters. To start or add to a thread, create a message
|
759
806
|
# and specify a `threadKey` or the thread.name. For example usage, see [Start or
|
760
|
-
# reply to a message thread](https://developers.google.com/chat/
|
761
|
-
# messages
|
807
|
+
# reply to a message thread](https://developers.google.com/workspace/chat/create-
|
808
|
+
# messages#create-message-thread).
|
762
809
|
# @param [String] fields
|
763
810
|
# Selector specifying which fields to include in a partial response.
|
764
811
|
# @param [String] quota_user
|
@@ -793,24 +840,26 @@ module Google
|
|
793
840
|
end
|
794
841
|
|
795
842
|
# Deletes a message. For an example, see [Delete a message](https://developers.
|
796
|
-
# google.com/chat/
|
797
|
-
#
|
798
|
-
# authentication](https://developers.google.com/chat/
|
799
|
-
#
|
800
|
-
#
|
801
|
-
# messages created by the calling Chat
|
843
|
+
# google.com/workspace/chat/delete-messages). Requires [authentication](https://
|
844
|
+
# developers.google.com/workspace/chat/authenticate-authorize). Supports [app
|
845
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
846
|
+
# authorize-chat-app) and [user authentication](https://developers.google.com/
|
847
|
+
# workspace/chat/authenticate-authorize-chat-user). When using app
|
848
|
+
# authentication, requests can only delete messages created by the calling Chat
|
849
|
+
# app.
|
802
850
|
# @param [String] name
|
803
851
|
# Required. Resource name of the message. Format: `spaces/`space`/messages/`
|
804
852
|
# message`` If you've set a custom ID for your message, you can use the value
|
805
853
|
# from the `clientAssignedMessageId` field for ``message``. For details, see [
|
806
|
-
# Name a message] (https://developers.google.com/chat/
|
807
|
-
#
|
854
|
+
# Name a message] (https://developers.google.com/workspace/chat/create-messages#
|
855
|
+
# name_a_created_message).
|
808
856
|
# @param [Boolean] force
|
809
857
|
# When `true`, deleting a message also deletes its threaded replies. When `false`
|
810
858
|
# , if a message has threaded replies, deletion fails. Only applies when [
|
811
|
-
# authenticating as a user](https://developers.google.com/chat/
|
812
|
-
#
|
813
|
-
# google.com/chat/
|
859
|
+
# authenticating as a user](https://developers.google.com/workspace/chat/
|
860
|
+
# authenticate-authorize-chat-user). Has no effect when [authenticating as a
|
861
|
+
# Chat app] (https://developers.google.com/workspace/chat/authenticate-authorize-
|
862
|
+
# chat-app).
|
814
863
|
# @param [String] fields
|
815
864
|
# Selector specifying which fields to include in a partial response.
|
816
865
|
# @param [String] quota_user
|
@@ -839,19 +888,19 @@ module Google
|
|
839
888
|
execute_or_queue_command(command, &block)
|
840
889
|
end
|
841
890
|
|
842
|
-
# Returns details about a message. For an example, see [
|
843
|
-
# developers.google.com/chat/
|
844
|
-
# authentication](https://developers.google.com/chat/
|
845
|
-
# app authentication](https://developers.google.com/
|
846
|
-
#
|
847
|
-
#
|
848
|
-
# space.
|
891
|
+
# Returns details about a message. For an example, see [Get details about a
|
892
|
+
# message](https://developers.google.com/workspace/chat/get-messages). Requires [
|
893
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
894
|
+
# authorize). Supports [app authentication](https://developers.google.com/
|
895
|
+
# workspace/chat/authenticate-authorize-chat-app) and [user authentication](
|
896
|
+
# https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
|
897
|
+
# Note: Might return a message from a blocked member or space.
|
849
898
|
# @param [String] name
|
850
899
|
# Required. Resource name of the message. Format: `spaces/`space`/messages/`
|
851
900
|
# message`` If you've set a custom ID for your message, you can use the value
|
852
901
|
# from the `clientAssignedMessageId` field for ``message``. For details, see [
|
853
|
-
# Name a message] (https://developers.google.com/chat/
|
854
|
-
#
|
902
|
+
# Name a message] (https://developers.google.com/workspace/chat/create-messages#
|
903
|
+
# name_a_created_message).
|
855
904
|
# @param [String] fields
|
856
905
|
# Selector specifying which fields to include in a partial response.
|
857
906
|
# @param [String] quota_user
|
@@ -882,7 +931,7 @@ module Google
|
|
882
931
|
# Lists messages in a space that the caller is a member of, including messages
|
883
932
|
# from blocked members and spaces. For an example, see [List messages](/chat/api/
|
884
933
|
# guides/v1/messages/list). Requires [user authentication](https://developers.
|
885
|
-
# google.com/chat/
|
934
|
+
# google.com/workspace/chat/authenticate-authorize-chat-user).
|
886
935
|
# @param [String] parent
|
887
936
|
# Required. The resource name of the space to list messages from. Format: `
|
888
937
|
# spaces/`space``
|
@@ -958,13 +1007,13 @@ module Google
|
|
958
1007
|
# Updates a message. There's a difference between the `patch` and `update`
|
959
1008
|
# methods. The `patch` method uses a `patch` request while the `update` method
|
960
1009
|
# uses a `put` request. We recommend using the `patch` method. For an example,
|
961
|
-
# see [Update a message](https://developers.google.com/chat/
|
962
|
-
# messages
|
963
|
-
#
|
964
|
-
#
|
965
|
-
# developers.google.com/chat/
|
966
|
-
# authentication, requests can only update
|
967
|
-
# app.
|
1010
|
+
# see [Update a message](https://developers.google.com/workspace/chat/update-
|
1011
|
+
# messages). Requires [authentication](https://developers.google.com/workspace/
|
1012
|
+
# chat/authenticate-authorize). Supports [app authentication](https://developers.
|
1013
|
+
# google.com/workspace/chat/authenticate-authorize-chat-app) and [user
|
1014
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
1015
|
+
# authorize-chat-user). When using app authentication, requests can only update
|
1016
|
+
# messages created by the calling Chat app.
|
968
1017
|
# @param [String] name
|
969
1018
|
# Resource name of the message. Format: `spaces/`space`/messages/`message``
|
970
1019
|
# Where ``space`` is the ID of the space where the message is posted and ``
|
@@ -973,13 +1022,13 @@ module Google
|
|
973
1022
|
# create a message, you can use this ID to specify the message in a request by
|
974
1023
|
# replacing ``message`` with the value from the `clientAssignedMessageId` field.
|
975
1024
|
# For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details,
|
976
|
-
# see [Name a message](https://developers.google.com/chat/
|
977
|
-
#
|
1025
|
+
# see [Name a message](https://developers.google.com/workspace/chat/create-
|
1026
|
+
# messages#name_a_created_message).
|
978
1027
|
# @param [Google::Apis::ChatV1::Message] message_object
|
979
1028
|
# @param [Boolean] allow_missing
|
980
1029
|
# Optional. If `true` and the message isn't found, a new message is created and `
|
981
1030
|
# updateMask` is ignored. The specified message ID must be [client-assigned](
|
982
|
-
# https://developers.google.com/chat/
|
1031
|
+
# https://developers.google.com/workspace/chat/create-messages#
|
983
1032
|
# name_a_created_message) or the request fails.
|
984
1033
|
# @param [String] update_mask
|
985
1034
|
# Required. The field paths to update. Separate multiple values with commas or
|
@@ -1022,13 +1071,13 @@ module Google
|
|
1022
1071
|
# Updates a message. There's a difference between the `patch` and `update`
|
1023
1072
|
# methods. The `patch` method uses a `patch` request while the `update` method
|
1024
1073
|
# uses a `put` request. We recommend using the `patch` method. For an example,
|
1025
|
-
# see [Update a message](https://developers.google.com/chat/
|
1026
|
-
# messages
|
1027
|
-
#
|
1028
|
-
#
|
1029
|
-
# developers.google.com/chat/
|
1030
|
-
# authentication, requests can only update
|
1031
|
-
# app.
|
1074
|
+
# see [Update a message](https://developers.google.com/workspace/chat/update-
|
1075
|
+
# messages). Requires [authentication](https://developers.google.com/workspace/
|
1076
|
+
# chat/authenticate-authorize). Supports [app authentication](https://developers.
|
1077
|
+
# google.com/workspace/chat/authenticate-authorize-chat-app) and [user
|
1078
|
+
# authentication](https://developers.google.com/workspace/chat/authenticate-
|
1079
|
+
# authorize-chat-user). When using app authentication, requests can only update
|
1080
|
+
# messages created by the calling Chat app.
|
1032
1081
|
# @param [String] name
|
1033
1082
|
# Resource name of the message. Format: `spaces/`space`/messages/`message``
|
1034
1083
|
# Where ``space`` is the ID of the space where the message is posted and ``
|
@@ -1037,13 +1086,13 @@ module Google
|
|
1037
1086
|
# create a message, you can use this ID to specify the message in a request by
|
1038
1087
|
# replacing ``message`` with the value from the `clientAssignedMessageId` field.
|
1039
1088
|
# For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details,
|
1040
|
-
# see [Name a message](https://developers.google.com/chat/
|
1041
|
-
#
|
1089
|
+
# see [Name a message](https://developers.google.com/workspace/chat/create-
|
1090
|
+
# messages#name_a_created_message).
|
1042
1091
|
# @param [Google::Apis::ChatV1::Message] message_object
|
1043
1092
|
# @param [Boolean] allow_missing
|
1044
1093
|
# Optional. If `true` and the message isn't found, a new message is created and `
|
1045
1094
|
# updateMask` is ignored. The specified message ID must be [client-assigned](
|
1046
|
-
# https://developers.google.com/chat/
|
1095
|
+
# https://developers.google.com/workspace/chat/create-messages#
|
1047
1096
|
# name_a_created_message) or the request fails.
|
1048
1097
|
# @param [String] update_mask
|
1049
1098
|
# Required. The field paths to update. Separate multiple values with commas or
|
@@ -1084,11 +1133,11 @@ module Google
|
|
1084
1133
|
end
|
1085
1134
|
|
1086
1135
|
# Gets the metadata of a message attachment. The attachment data is fetched
|
1087
|
-
# using the [media API](https://developers.google.com/chat/api/
|
1088
|
-
# media/download). For an example, see [Get
|
1089
|
-
# developers.google.com/chat/
|
1090
|
-
# app authentication](https://developers.google.com/
|
1091
|
-
#
|
1136
|
+
# using the [media API](https://developers.google.com/workspace/chat/api/
|
1137
|
+
# reference/rest/v1/media/download). For an example, see [Get metadata about a
|
1138
|
+
# message attachment](https://developers.google.com/workspace/chat/get-media-
|
1139
|
+
# attachments). Requires [app authentication](https://developers.google.com/
|
1140
|
+
# workspace/chat/authenticate-authorize-chat-app).
|
1092
1141
|
# @param [String] name
|
1093
1142
|
# Required. Resource name of the attachment, in the form `spaces/*/messages/*/
|
1094
1143
|
# attachments/*`.
|
@@ -1119,10 +1168,10 @@ module Google
|
|
1119
1168
|
execute_or_queue_command(command, &block)
|
1120
1169
|
end
|
1121
1170
|
|
1122
|
-
# Creates a reaction and adds it to a message.
|
1123
|
-
# reaction](https://developers.google.
|
1124
|
-
# Requires [user authentication](https://
|
1125
|
-
#
|
1171
|
+
# Creates a reaction and adds it to a message. Only unicode emojis are supported.
|
1172
|
+
# For an example, see [Add a reaction to a message](https://developers.google.
|
1173
|
+
# com/workspace/chat/create-reactions). Requires [user authentication](https://
|
1174
|
+
# developers.google.com/workspace/chat/authenticate-authorize-chat-user).
|
1126
1175
|
# @param [String] parent
|
1127
1176
|
# Required. The message where the reaction is created. Format: `spaces/`space`/
|
1128
1177
|
# messages/`message``
|
@@ -1156,9 +1205,10 @@ module Google
|
|
1156
1205
|
execute_or_queue_command(command, &block)
|
1157
1206
|
end
|
1158
1207
|
|
1159
|
-
# Deletes a reaction to a message.
|
1160
|
-
#
|
1161
|
-
# authentication](https://developers.google.
|
1208
|
+
# Deletes a reaction to a message. Only unicode emojis are supported. For an
|
1209
|
+
# example, see [Delete a reaction](https://developers.google.com/workspace/chat/
|
1210
|
+
# delete-reactions). Requires [user authentication](https://developers.google.
|
1211
|
+
# com/workspace/chat/authenticate-authorize-chat-user).
|
1162
1212
|
# @param [String] name
|
1163
1213
|
# Required. Name of the reaction to delete. Format: `spaces/`space`/messages/`
|
1164
1214
|
# message`/reactions/`reaction``
|
@@ -1189,33 +1239,34 @@ module Google
|
|
1189
1239
|
execute_or_queue_command(command, &block)
|
1190
1240
|
end
|
1191
1241
|
|
1192
|
-
# Lists reactions to a message. For an example, see [List reactions
|
1193
|
-
# developers.google.com/chat/
|
1194
|
-
# authentication](https://developers.google.com/chat/
|
1242
|
+
# Lists reactions to a message. For an example, see [List reactions for a
|
1243
|
+
# message](https://developers.google.com/workspace/chat/list-reactions).
|
1244
|
+
# Requires [user authentication](https://developers.google.com/workspace/chat/
|
1245
|
+
# authenticate-authorize-chat-user).
|
1195
1246
|
# @param [String] parent
|
1196
1247
|
# Required. The message users reacted to. Format: `spaces/`space`/messages/`
|
1197
1248
|
# message``
|
1198
1249
|
# @param [String] filter
|
1199
1250
|
# Optional. A query filter. You can filter reactions by [emoji](https://
|
1200
|
-
# developers.google.com/chat/api/reference/rest/v1/Emoji) (either `
|
1201
|
-
# or `emoji.custom_emoji.uid`) and [user](https://developers.
|
1202
|
-
# api/reference/rest/v1/User) (`user.name`). To filter
|
1203
|
-
# emojis or users, join similar fields with the `OR`
|
1204
|
-
# unicode = "🙂" OR emoji.unicode = "👍"` and `user.name =
|
1205
|
-
# name = "users/BBBBBB"`. To filter reactions by emoji
|
1206
|
-
# operator, such as `emoji.unicode = "🙂" AND user.name =
|
1207
|
-
# your query uses both `AND` and `OR`, group them with
|
1208
|
-
# the following queries are valid: ``` user.name = "
|
1209
|
-
# "🙂" emoji.custom_emoji.uid = "`uid`" emoji.
|
1210
|
-
#
|
1211
|
-
#
|
1212
|
-
# "`uid`") AND user.name = "users/`
|
1213
|
-
# ```
|
1214
|
-
#
|
1215
|
-
# emoji.unicode = "🙂" OR
|
1216
|
-
#
|
1217
|
-
# "users/`user`" ``` Invalid
|
1218
|
-
# INVALID_ARGUMENT` error.
|
1251
|
+
# developers.google.com/workspace/chat/api/reference/rest/v1/Emoji) (either `
|
1252
|
+
# emoji.unicode` or `emoji.custom_emoji.uid`) and [user](https://developers.
|
1253
|
+
# google.com/workspace/chat/api/reference/rest/v1/User) (`user.name`). To filter
|
1254
|
+
# reactions for multiple emojis or users, join similar fields with the `OR`
|
1255
|
+
# operator, such as `emoji.unicode = "🙂" OR emoji.unicode = "👍"` and `user.name =
|
1256
|
+
# "users/AAAAAA" OR user.name = "users/BBBBBB"`. To filter reactions by emoji
|
1257
|
+
# and user, use the `AND` operator, such as `emoji.unicode = "🙂" AND user.name =
|
1258
|
+
# "users/AAAAAA"`. If your query uses both `AND` and `OR`, group them with
|
1259
|
+
# parentheses. For example, the following queries are valid: ``` user.name = "
|
1260
|
+
# users/`user`" emoji.unicode = "🙂" emoji.custom_emoji.uid = "`uid`" emoji.
|
1261
|
+
# unicode = "🙂" OR emoji.unicode = "👍" emoji.unicode = "🙂" OR emoji.custom_emoji.
|
1262
|
+
# uid = "`uid`" emoji.unicode = "🙂" AND user.name = "users/`user`" (emoji.
|
1263
|
+
# unicode = "🙂" OR emoji.custom_emoji.uid = "`uid`") AND user.name = "users/`
|
1264
|
+
# user`" ``` The following queries are invalid: ``` emoji.unicode = "🙂" AND
|
1265
|
+
# emoji.unicode = "👍" emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "`uid`"
|
1266
|
+
# emoji.unicode = "🙂" OR user.name = "users/`user`" emoji.unicode = "🙂" OR emoji.
|
1267
|
+
# custom_emoji.uid = "`uid`" OR user.name = "users/`user`" emoji.unicode = "🙂"
|
1268
|
+
# OR emoji.custom_emoji.uid = "`uid`" AND user.name = "users/`user`" ``` Invalid
|
1269
|
+
# queries are rejected by the server with an `INVALID_ARGUMENT` error.
|
1219
1270
|
# @param [Fixnum] page_size
|
1220
1271
|
# Optional. The maximum number of reactions returned. The service can return
|
1221
1272
|
# fewer reactions than this value. If unspecified, the default value is 25. The
|
@@ -1255,15 +1306,19 @@ module Google
|
|
1255
1306
|
execute_or_queue_command(command, &block)
|
1256
1307
|
end
|
1257
1308
|
|
1258
|
-
# Returns
|
1259
|
-
#
|
1260
|
-
#
|
1261
|
-
#
|
1262
|
-
#
|
1263
|
-
# authentication](https://
|
1309
|
+
# Returns an event from a Google Chat space. The [event payload](https://
|
1310
|
+
# developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#
|
1311
|
+
# SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the
|
1312
|
+
# resource that changed. For example, if you request an event about a new
|
1313
|
+
# message but the message was later updated, the server returns the updated `
|
1314
|
+
# Message` resource in the event payload. Requires [user authentication](https://
|
1315
|
+
# developers.google.com/workspace/chat/authenticate-authorize-chat-user). To get
|
1316
|
+
# an event, the authenticated user must be a member of the space. For an example,
|
1317
|
+
# see [Get details about an event from a Google Chat space](https://developers.
|
1318
|
+
# google.com/workspace/chat/get-space-event).
|
1264
1319
|
# @param [String] name
|
1265
|
-
# Required. The resource name of the event. Format: `spaces/`space`/
|
1266
|
-
# spaceEvent``
|
1320
|
+
# Required. The resource name of the space event. Format: `spaces/`space`/
|
1321
|
+
# spaceEvents/`spaceEvent``
|
1267
1322
|
# @param [String] fields
|
1268
1323
|
# Selector specifying which fields to include in a partial response.
|
1269
1324
|
# @param [String] quota_user
|
@@ -1291,28 +1346,38 @@ module Google
|
|
1291
1346
|
execute_or_queue_command(command, &block)
|
1292
1347
|
end
|
1293
1348
|
|
1294
|
-
# Lists
|
1295
|
-
#
|
1296
|
-
#
|
1297
|
-
#
|
1298
|
-
#
|
1299
|
-
#
|
1300
|
-
#
|
1349
|
+
# Lists events from a Google Chat space. For each event, the [payload](https://
|
1350
|
+
# developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#
|
1351
|
+
# SpaceEvent.FIELDS.oneof_payload) contains the most recent version of the Chat
|
1352
|
+
# resource. For example, if you list events about new space members, the server
|
1353
|
+
# returns `Membership` resources that contain the latest membership details. If
|
1354
|
+
# new members were removed during the requested period, the event payload
|
1355
|
+
# contains an empty `Membership` resource. Requires [user authentication](https:/
|
1356
|
+
# /developers.google.com/workspace/chat/authenticate-authorize-chat-user). To
|
1357
|
+
# list events, the authenticated user must be a member of the space. For an
|
1358
|
+
# example, see [List events from a Google Chat space](https://developers.google.
|
1359
|
+
# com/workspace/chat/list-space-events).
|
1301
1360
|
# @param [String] parent
|
1302
|
-
# Required.
|
1303
|
-
# spaces
|
1361
|
+
# Required. Resource name of the [Google Chat space](https://developers.google.
|
1362
|
+
# com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred.
|
1363
|
+
# Format: `spaces/`space``.
|
1304
1364
|
# @param [String] filter
|
1305
|
-
# Required. A query filter.
|
1306
|
-
#
|
1307
|
-
#
|
1308
|
-
#
|
1309
|
-
#
|
1310
|
-
#
|
1311
|
-
#
|
1312
|
-
#
|
1313
|
-
#
|
1314
|
-
#
|
1315
|
-
#
|
1365
|
+
# Required. A query filter. You must specify at least one event type (`
|
1366
|
+
# event_type`) using the has `:` operator. To filter by multiple event types,
|
1367
|
+
# use the `OR` operator. Omit batch event types in your filter. The request
|
1368
|
+
# automatically returns any related batch events. For example, if you filter by
|
1369
|
+
# new reactions (`google.workspace.chat.reaction.v1.created`), the server also
|
1370
|
+
# returns batch new reactions events (`google.workspace.chat.reaction.v1.
|
1371
|
+
# batchCreated`). For a list of supported event types, see the [`SpaceEvents`
|
1372
|
+
# reference documentation](https://developers.google.com/workspace/chat/api/
|
1373
|
+
# reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.event_type). Optionally,
|
1374
|
+
# you can also filter by start time (`start_time`) and end time (`end_time`): *
|
1375
|
+
# `start_time`: Exclusive timestamp from which to start listing space events.
|
1376
|
+
# You can list events that occurred up to 28 days ago. If unspecified, lists
|
1377
|
+
# space events from the past 28 days. * `end_time`: Inclusive timestamp until
|
1378
|
+
# which space events are listed. If unspecified, lists events up to the time of
|
1379
|
+
# the request. To specify a start or end time, use the equals `=` operator and
|
1380
|
+
# format in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339). To filter by
|
1316
1381
|
# both `start_time` and `end_time`, use the `AND` operator. For example, the
|
1317
1382
|
# following queries are valid: ``` start_time="2023-08-23T19:20:33+00:00" AND
|
1318
1383
|
# end_time="2023-08-23T19:21:54+00:00" ``` ``` start_time="2023-08-23T19:20:33+
|
@@ -1323,8 +1388,9 @@ module Google
|
|
1323
1388
|
# updated" AND event_types:"google.workspace.chat.message.v1.created" ```
|
1324
1389
|
# Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.
|
1325
1390
|
# @param [Fixnum] page_size
|
1326
|
-
# Optional. The maximum number of space events returned. The service
|
1327
|
-
# fewer than this value. Negative values return an `INVALID_ARGUMENT`
|
1391
|
+
# Optional. The maximum number of space events returned. The service might
|
1392
|
+
# return fewer than this value. Negative values return an `INVALID_ARGUMENT`
|
1393
|
+
# error.
|
1328
1394
|
# @param [String] page_token
|
1329
1395
|
# A page token, received from a previous list space events call. Provide this to
|
1330
1396
|
# retrieve the subsequent page. When paginating, all other parameters provided
|