google-apis-chat_v1 0.90.0 → 0.91.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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.