google-apis-chat_v1 0.90.0 → 0.91.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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/api/guides/v1/media-and-attachments/upload).
95
- # Requires user [authentication](https://developers.google.com/chat/api/guides/
96
- # auth/users). You can upload attachments up to 200 MB. Certain file types aren'
97
- # t supported. For details, see [File types blocked by Google Chat](https://
98
- # support.google.com/chat/answer/7651457?&co=GENIE.Platform%3DDesktop#File%
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/api/guides/
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/chat/
147
- # api/guides/authorize-import).
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/api/guides/v1/
182
- # spaces/create). If you receive the error message `ALREADY_EXISTS` when
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/api/guides/auth/users).
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/api/guides/v1/spaces/delete). Requires [user
225
- # authentication](https://developers.google.com/chat/api/guides/auth/users) from
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/api/guides/auth/users),
260
- # returns the direct message space between the specified user and the
261
- # authenticated user. With [app authentication](https://developers.google.com/
262
- # chat/api/guides/auth/service-accounts), returns the direct message space
263
- # between the specified user and the calling Chat app. Requires [user
264
- # authentication](https://developers.google.com/chat/api/guides/auth/users) or [
265
- # app authentication](https://developers.google.com/chat/api/guides/auth/service-
266
- # accounts).
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/api/guides/auth/users), you can use the email as an alias for `
276
- # `user``. For example, `users/example@gmail.com` where `example@gmail.com` is
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](https://
306
- # developers.google.com/chat/api/guides/v1/spaces/get). Requires [authentication]
307
- # (https://developers.google.com/chat/api/guides/auth). Supports [app
308
- # authentication](https://developers.google.com/chat/api/guides/auth/service-
309
- # accounts) and [user authentication](https://developers.google.com/chat/api/
310
- # guides/auth/users).
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/api/guides/v1/spaces/list). Requires [
344
- # authentication](https://developers.google.com/chat/api/guides/auth). Supports [
345
- # app authentication](https://developers.google.com/chat/api/guides/auth/service-
346
- # accounts) and [user authentication](https://developers.google.com/chat/api/
347
- # guides/auth/users). Lists spaces visible to the caller or authenticated user.
348
- # Group chats and DMs aren't listed until the first message is sent.
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/v1/spaces#
352
- # spacetype)). To filter by space type, you must specify valid enum value, such
353
- # as `SPACE` or `GROUP_CHAT` (the `space_type` can't be `SPACE_TYPE_UNSPECIFIED`)
354
- # . To query for multiple space types, use the `OR` operator. For example, the
355
- # following queries are valid: ``` space_type = "SPACE" spaceType = "GROUP_CHAT"
356
- # OR spaceType = "DIRECT_MESSAGE" ``` Invalid queries are rejected by the server
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/api/guides/v1/spaces/update). If you're updating the `
399
- # displayName` field and receive the error message `ALREADY_EXISTS`, try a
400
- # different display name.. An existing space within the Google Workspace
401
- # organization might already use this display name. Requires [user
402
- # authentication](https://developers.google.com/chat/api/guides/auth/users).
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](https://developers.google.
463
- # com/chat/api/guides/v1/spaces/set-up). To specify the human members to add,
464
- # add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`.
465
- # To add a human user, use `users/`user``, where ``user`` can be the email
466
- # address for the user. For users in the same Workspace organization ``user``
467
- # can also be the `id` for the person from the People API, or the `id` for the
468
- # user in the Directory API. For example, if the People API Person profile ID
469
- # for `user@example.com` is `123456789`, you can add the user to the space by
470
- # setting the `membership.member.name` to `users/user@example.com` or `users/
471
- # 123456789`. For a space or group chat, if the caller blocks or is blocked by
472
- # some members, then those members aren't added to the created space. To create
473
- # a direct message (DM) between the calling user and another human user, specify
474
- # exactly one membership to represent the human user. If one user blocks the
475
- # other, the request fails and the DM isn't created. To create a DM between the
476
- # calling user and the calling app, set `Space.singleUserBotDm` to `true` and
477
- # don't specify any memberships. You can only use this method to set up a DM
478
- # with the calling app. To add the calling app as a member of a space or an
479
- # existing DM between two human users, see [create a membership](https://
480
- # developers.google.com/chat/api/guides/v1/members/create). If a DM already
481
- # exists between two users, even when one user blocks the other at the time a
482
- # request is made, then the existing DM is returned. Spaces with threaded
483
- # replies aren't supported. If you receive the error message `ALREADY_EXISTS`
484
- # when setting up a space, try a different `displayName`. An existing space
485
- # within the Google Workspace organization might already use this display name.
486
- # Requires [user authentication](https://developers.google.com/chat/api/guides/
487
- # auth/users).
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 [ Create a
519
- # membership](https://developers.google.com/chat/api/guides/v1/members/create).
520
- # When creating a membership, if the specified member has their auto-accept
521
- # policy turned off, then they're invited, and must accept the space invitation
522
- # before joining. Otherwise, creating a membership adds the member directly to
523
- # the specified space. Requires [user authentication](https://developers.google.
524
- # com/chat/api/guides/auth/users). To specify the member to add, set the `
525
- # membership.member.name` in the `CreateMembershipRequest`: - To add the calling
526
- # app to a space or a direct message between two human users, use `users/app`.
527
- # Unable to add other apps to the space. - To add a human user, use `users/`user`
528
- # `, where ``user`` can be the email address for the user. For users in the same
529
- # Workspace organization ``user`` can also be the `id` for the person from the
530
- # People API, or the `id` for the user in the Directory API. For example, if the
531
- # People API Person profile ID for `user@example.com` is `123456789`, you can
532
- # add the user to the space by setting the `membership.member.name` to `users/
533
- # user@example.com` or `users/123456789`.
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 [Delete a membership](https://
568
- # developers.google.com/chat/api/guides/v1/members/delete). Requires [user
569
- # authentication](https://developers.google.com/chat/api/guides/auth/users).
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 membership](
608
- # https://developers.google.com/chat/api/guides/v1/members/get). Requires [
609
- # authentication](https://developers.google.com/chat/api/guides/auth). Supports [
610
- # app authentication](https://developers.google.com/chat/api/guides/auth/service-
611
- # accounts) and [user authentication](https://developers.google.com/chat/api/
612
- # guides/auth/users).
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, you can optionally use `spaces/`space`/members/app`. Format: `
616
- # spaces/`space`/members/`member`` or `spaces/`space`/members/app` When [
617
- # authenticated as a user](https://developers.google.com/chat/api/guides/auth/
618
- # users), you can use the user's email as an alias for ``member``. For example, `
619
- # spaces/`space`/members/example@gmail.com` where `example@gmail.com` is the
620
- # email of the Google Chat user.
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 memberships](https://
649
- # developers.google.com/chat/api/guides/v1/members/list). Listing memberships
650
- # with [app authentication](https://developers.google.com/chat/api/guides/auth/
651
- # service-accounts) lists memberships in spaces that the Chat app has access to,
652
- # but excludes Chat app memberships, including its own. Listing memberships with
653
- # [User authentication](https://developers.google.com/chat/api/guides/auth/users)
654
- # lists memberships in spaces that the authenticated user has access to.
655
- # Requires [authentication](https://developers.google.com/chat/api/guides/auth).
656
- # Supports [app authentication](https://developers.google.com/chat/api/guides/
657
- # auth/service-accounts) and [user authentication](https://developers.google.com/
658
- # chat/api/guides/auth/users).
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/spaces.members#
665
- # membershiprole)) and type ([`member.type`](https://developers.google.com/chat/
666
- # api/reference/rest/v1/User#type)). To filter by role, set `role` to `
667
- # ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN`
668
- # or `BOT`. To filter by both role and type, use the `AND` operator. To filter
669
- # by either role or type, use the `OR` operator. For example, the following
670
- # queries are valid: ``` role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.
671
- # type = "HUMAN" AND role = "ROLE_MANAGER" ``` The following queries are invalid:
672
- # ``` member.type = "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND
673
- # role = "ROLE_MEMBER" ``` Invalid queries are rejected by the server with an `
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/chat/
696
- # api/guides/auth/users).
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
- # Creates a message in a Google Chat space. For an example, see [Create a
730
- # message](https://developers.google.com/chat/api/guides/v1/messages/create).
731
- # Calling this method requires [authentication](https://developers.google.com/
732
- # chat/api/guides/auth) and supports the following authentication types: - For
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/api/guides/v1/messages/create#name_a_created_message).
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/api/guides/v1/
761
- # messages/create#create-message-thread).
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/api/guides/v1/messages/delete). Requires [authentication](
797
- # https://developers.google.com/chat/api/guides/auth). Supports [app
798
- # authentication](https://developers.google.com/chat/api/guides/auth/service-
799
- # accounts) and [user authentication](https://developers.google.com/chat/api/
800
- # guides/auth/users). When using app authentication, requests can only delete
801
- # messages created by the calling Chat app.
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/api/guides/v1/messages/
807
- # create#name_a_created_message).
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/api/guides/auth/
812
- # users). Has no effect when [authenticating as a Chat app] (https://developers.
813
- # google.com/chat/api/guides/auth/service-accounts).
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 [Read a message](https://
843
- # developers.google.com/chat/api/guides/v1/messages/get). Requires [
844
- # authentication](https://developers.google.com/chat/api/guides/auth). Supports [
845
- # app authentication](https://developers.google.com/chat/api/guides/auth/service-
846
- # accounts) and [user authentication](https://developers.google.com/chat/api/
847
- # guides/auth/users). Note: Might return a message from a blocked member or
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/api/guides/v1/messages/
854
- # create#name_a_created_message).
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/api/guides/auth/users).
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/api/guides/v1/
962
- # messages/update). Requires [authentication](https://developers.google.com/chat/
963
- # api/guides/auth). Supports [app authentication](https://developers.google.com/
964
- # chat/api/guides/auth/service-accounts) and [user authentication](https://
965
- # developers.google.com/chat/api/guides/auth/users). When using app
966
- # authentication, requests can only update messages created by the calling Chat
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/api/guides/v1/messages/
977
- # create#name_a_created_message).
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/api/guides/v1/messages/create#
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/api/guides/v1/
1026
- # messages/update). Requires [authentication](https://developers.google.com/chat/
1027
- # api/guides/auth). Supports [app authentication](https://developers.google.com/
1028
- # chat/api/guides/auth/service-accounts) and [user authentication](https://
1029
- # developers.google.com/chat/api/guides/auth/users). When using app
1030
- # authentication, requests can only update messages created by the calling Chat
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/api/guides/v1/messages/
1041
- # create#name_a_created_message).
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/api/guides/v1/messages/create#
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/reference/rest/v1/
1088
- # media/download). For an example, see [Get a message attachment](https://
1089
- # developers.google.com/chat/api/guides/v1/media-and-attachments/get). Requires [
1090
- # app authentication](https://developers.google.com/chat/api/guides/auth/service-
1091
- # accounts).
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. For an example, see [Create a
1123
- # reaction](https://developers.google.com/chat/api/guides/v1/reactions/create).
1124
- # Requires [user authentication](https://developers.google.com/chat/api/guides/
1125
- # auth/users). Only unicode emoji are supported.
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. For an example, see [Delete a reaction](https:
1160
- # //developers.google.com/chat/api/guides/v1/reactions/delete). Requires [user
1161
- # authentication](https://developers.google.com/chat/api/guides/auth/users).
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](https://
1193
- # developers.google.com/chat/api/guides/v1/reactions/list). Requires [user
1194
- # authentication](https://developers.google.com/chat/api/guides/auth/users).
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 `emoji.unicode`
1201
- # or `emoji.custom_emoji.uid`) and [user](https://developers.google.com/chat/
1202
- # api/reference/rest/v1/User) (`user.name`). To filter reactions for multiple
1203
- # emojis or users, join similar fields with the `OR` operator, such as `emoji.
1204
- # unicode = "🙂" OR emoji.unicode = "👍"` and `user.name = "users/AAAAAA" OR user.
1205
- # name = "users/BBBBBB"`. To filter reactions by emoji and user, use the `AND`
1206
- # operator, such as `emoji.unicode = "🙂" AND user.name = "users/AAAAAA"`. If
1207
- # your query uses both `AND` and `OR`, group them with parentheses. For example,
1208
- # the following queries are valid: ``` user.name = "users/`user`" emoji.unicode =
1209
- # "🙂" emoji.custom_emoji.uid = "`uid`" emoji.unicode = "🙂" OR emoji.unicode = "👍
1210
- # " emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "`uid`" emoji.unicode = "🙂"
1211
- # AND user.name = "users/`user`" (emoji.unicode = "🙂" OR emoji.custom_emoji.uid =
1212
- # "`uid`") AND user.name = "users/`user`" ``` The following queries are invalid:
1213
- # ``` emoji.unicode = "🙂" AND emoji.unicode = "👍" emoji.unicode = "🙂" AND emoji.
1214
- # custom_emoji.uid = "`uid`" emoji.unicode = "🙂" OR user.name = "users/`user`"
1215
- # emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "`uid`" OR user.name = "users/`
1216
- # user`" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "`uid`" AND user.name =
1217
- # "users/`user`" ``` Invalid queries are rejected by the server with an `
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
@@ -1261,10 +1312,10 @@ module Google
1261
1312
  # resource that changed. For example, if you request an event about a new
1262
1313
  # message but the message was later updated, the server returns the updated `
1263
1314
  # Message` resource in the event payload. Requires [user authentication](https://
1264
- # developers.google.com/chat/api/guides/auth/users). To get an event, the
1265
- # authenticated user must be a member of the space. For an example, see [Get
1266
- # details about an event from a Google Chat space](https://developers.google.com/
1267
- # workspace/chat/get-space-event).
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).
1268
1319
  # @param [String] name
1269
1320
  # Required. The resource name of the space event. Format: `spaces/`space`/
1270
1321
  # spaceEvents/`spaceEvent``
@@ -1302,10 +1353,10 @@ module Google
1302
1353
  # returns `Membership` resources that contain the latest membership details. If
1303
1354
  # new members were removed during the requested period, the event payload
1304
1355
  # contains an empty `Membership` resource. Requires [user authentication](https:/
1305
- # /developers.google.com/chat/api/guides/auth/users). To list events, the
1306
- # authenticated user must be a member of the space. For an example, see [List
1307
- # events from a Google Chat space](https://developers.google.com/workspace/chat/
1308
- # list-space-events).
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).
1309
1360
  # @param [String] parent
1310
1361
  # Required. Resource name of the [Google Chat space](https://developers.google.
1311
1362
  # com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred.