Regenerate chat client (#8419)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-php-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

src/HangoutsChat.php

@@ -299,6 +299,28 @@ public function __construct($clientOrConfig = [], $rootUrl = null)
                   'type' => 'string',
                 ],
               ],
+            ],'findGroupChats' => [
+              'path' => 'v1/spaces:findGroupChats',
+              'httpMethod' => 'GET',
+              'parameters' => [
+                'pageSize' => [
+                  'location' => 'query',
+                  'type' => 'integer',
+                ],
+                'pageToken' => [
+                  'location' => 'query',
+                  'type' => 'string',
+                ],
+                'spaceView' => [
+                  'location' => 'query',
+                  'type' => 'string',
+                ],
+                'users' => [
+                  'location' => 'query',
+                  'type' => 'string',
+                  'repeated' => true,
+                ],
+              ],
             ],'get' => [
               'path' => 'v1/{+name}',
               'httpMethod' => 'GET',

src/HangoutsChat/FindGroupChatsResponse.php

@@ -0,0 +1,69 @@
+<?php
+/*
+ * Copyright 2014 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+namespace Google\Service\HangoutsChat;
+
+class FindGroupChatsResponse extends \Google\Collection
+{
+  protected $collection_key = 'spaces';
+  /**
+   * A token that you can send as `pageToken` to retrieve the next page of
+   * results. If empty, there are no subsequent pages.
+   *
+   * @var string
+   */
+  public $nextPageToken;
+  protected $spacesType = Space::class;
+  protected $spacesDataType = 'array';
+
+  /**
+   * A token that you can send as `pageToken` to retrieve the next page of
+   * results. If empty, there are no subsequent pages.
+   *
+   * @param string $nextPageToken
+   */
+  public function setNextPageToken($nextPageToken)
+  {
+    $this->nextPageToken = $nextPageToken;
+  }
+  /**
+   * @return string
+   */
+  public function getNextPageToken()
+  {
+    return $this->nextPageToken;
+  }
+  /**
+   * List of spaces in the requested (or first) page.
+   *
+   * @param Space[] $spaces
+   */
+  public function setSpaces($spaces)
+  {
+    $this->spaces = $spaces;
+  }
+  /**
+   * @return Space[]
+   */
+  public function getSpaces()
+  {
+    return $this->spaces;
+  }
+}
+
+// Adding a class alias for backwards compatibility with the previous class name.
+class_alias(FindGroupChatsResponse::class, 'Google_Service_HangoutsChat_FindGroupChatsResponse');

src/HangoutsChat/Resource/Spaces.php

@@ -20,6 +20,7 @@
 use Google\Service\HangoutsChat\ChatEmpty;
 use Google\Service\HangoutsChat\CompleteImportSpaceRequest;
 use Google\Service\HangoutsChat\CompleteImportSpaceResponse;
+use Google\Service\HangoutsChat\FindGroupChatsResponse;
 use Google\Service\HangoutsChat\ListSpacesResponse;
 use Google\Service\HangoutsChat\SearchSpacesResponse;
 use Google\Service\HangoutsChat\SetUpSpaceRequest;
@@ -196,6 +197,63 @@ public function findDirectMessage($optParams = [])
     $params = array_merge($params, $optParams);
     return $this->call('findDirectMessage', [$params], Space::class);
   }
+  /**
+   * [Developer Preview](https://developers.google.com/workspace/preview): Returns
+   * all spaces with `spaceType == GROUP_CHAT`, whose human memberships contain
+   * exactly the calling user, and the users specified in
+   * `FindGroupChatsRequest.users`. Only members that have joined the conversation
+   * are supported. For an example, see [Find group
+   * chats](https://developers.google.com/workspace/chat/find-group-chats). If the
+   * calling user blocks, or is blocked by, some users, and no spaces with the
+   * entire specified set of users are found, this method returns spaces that
+   * don't include the blocked or blocking users. The specified set of users must
+   * contain only human (non-app) memberships. A request that contains non-human
+   * users doesn't return any spaces. Requires [user
+   * authentication](https://developers.google.com/workspace/chat/authenticate-
+   * authorize-chat-user) with one of the following [authorization
+   * scopes](https://developers.google.com/workspace/chat/authenticate-
+   * authorize#chat-api-scopes): -
+   * `https://www.googleapis.com/auth/chat.memberships.readonly` -
+   * `https://www.googleapis.com/auth/chat.memberships` (spaces.findGroupChats)
+   *
+   * @param array $optParams Optional parameters.
+   *
+   * @opt_param int pageSize Optional. The maximum number of spaces to return. The
+   * service might return fewer than this value. If unspecified, at most 10 spaces
+   * are returned. The maximum value is 30. If you use a value more than 30, it's
+   * automatically changed to 30. Negative values return an `INVALID_ARGUMENT`
+   * error.
+   * @opt_param string pageToken Optional. A page token, received from a previous
+   * call to find group chats. Provide this parameter to retrieve the subsequent
+   * page. When paginating, all other parameters provided should match the call
+   * that provided the token. Passing different values may lead to unexpected
+   * results.
+   * @opt_param string spaceView Requested space view type. If unset, defaults to
+   * `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify `SPACE_VIEW_EXPANDED`
+   * must include scopes that allow reading space data, for example,
+   * https://www.googleapis.com/auth/chat.spaces or
+   * https://www.googleapis.com/auth/chat.spaces.readonly.
+   * @opt_param string users Optional. Resource names of all human users in group
+   * chat with the calling user. Chat apps can't be included in the request. The
+   * maximum number of users that can be specified in a single request is `49`.
+   * Format: `users/{user}`, where `{user}` is either the `id` for the
+   * [person](https://developers.google.com/people/api/rest/v1/people) from the
+   * People API, or the `id` for the [user](https://developers.google.com/admin-
+   * sdk/directory/reference/rest/v1/users) in the Directory API. For example, to
+   * find all group chats with the calling user and two other users, with People
+   * API profile IDs `123456789` and `987654321`, you can use `users/123456789`
+   * and `users/987654321`. You can also use the email as an alias for `{user}`.
+   * For example, `users/example@gmail.com` where `example@gmail.com` is the email
+   * of the Google Chat user.
+   * @return FindGroupChatsResponse
+   * @throws \Google\Service\Exception
+   */
+  public function findGroupChats($optParams = [])
+  {
+    $params = [];
+    $params = array_merge($params, $optParams);
+    return $this->call('findGroupChats', [$params], FindGroupChatsResponse::class);
+  }
   /**
    * Returns details about a space. For an example, see [Get details about a
    * space](https://developers.google.com/workspace/chat/get-spaces). Supports the

src/HangoutsChat/Resource/SpacesMessages.php

@@ -158,11 +158,9 @@ public function delete($name, $optParams = [])
    * commands](https://developers.google.com/workspace/chat/slash-commands) that
    * invoke the Chat app. -
    * `https://www.googleapis.com/auth/chat.app.messages.readonly` with
-   * [administrator approval](https://support.google.com/a?p=chat-app-auth)
-   * (available in [Developer
-   * Preview](https://developers.google.com/workspace/preview)). When using this
-   * authentication scope, this method returns details about a public message in a
-   * space. - [User
+   * [administrator approval](https://support.google.com/a?p=chat-app-auth). When
+   * using this authentication scope, this method returns details about a public
+   * message in a space. - [User
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-user) with one of the following authorization scopes: -
    * `https://www.googleapis.com/auth/chat.messages.readonly` -
@@ -197,8 +195,7 @@ public function get($name, $optParams = [])
    * authorize): - [App
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-app) with [administrator
-   * approval](https://support.google.com/a?p=chat-app-auth) in [Developer
-   * Preview](https://developers.google.com/workspace/preview) with the
+   * approval](https://support.google.com/a?p=chat-app-auth) with the
    * authorization scope: -
    * `https://www.googleapis.com/auth/chat.app.messages.readonly`. When using this
    * authentication scope, this method only returns public messages in a space. It

src/HangoutsChat/Resource/SpacesSpaceEvents.php

@@ -45,12 +45,13 @@ class SpacesSpaceEvents extends \Google\Service\Resource
    * authorize#chat-api-scopes) appropriate for reading the requested data: - [App
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-app) with [administrator
-   * approval](https://support.google.com/a?p=chat-app-auth) in [Developer
-   * Preview](https://developers.google.com/workspace/preview) with one of the
+   * approval](https://support.google.com/a?p=chat-app-auth) with one of the
    * following authorization scopes: -
    * `https://www.googleapis.com/auth/chat.app.spaces` -
+   * `https://www.googleapis.com/auth/chat.app.spaces.readonly` -
    * `https://www.googleapis.com/auth/chat.app.messages.readonly` -
-   * `https://www.googleapis.com/auth/chat.app.memberships` - [User
+   * `https://www.googleapis.com/auth/chat.app.memberships` -
+   * `https://www.googleapis.com/auth/chat.app.memberships.readonly` - [User
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-user) with one of the following authorization scopes: -
    * `https://www.googleapis.com/auth/chat.spaces.readonly` -
@@ -93,12 +94,13 @@ public function get($name, $optParams = [])
    * authorize#chat-api-scopes) appropriate for reading the requested data: - [App
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-app) with [administrator
-   * approval](https://support.google.com/a?p=chat-app-auth) in [Developer
-   * Preview](https://developers.google.com/workspace/preview) with one of the
+   * approval](https://support.google.com/a?p=chat-app-auth) with one of the
    * following authorization scopes: -
    * `https://www.googleapis.com/auth/chat.app.spaces` -
+   * `https://www.googleapis.com/auth/chat.app.spaces.readonly` -
    * `https://www.googleapis.com/auth/chat.app.messages.readonly` -
-   * `https://www.googleapis.com/auth/chat.app.memberships` - [User
+   * `https://www.googleapis.com/auth/chat.app.memberships` -
+   * `https://www.googleapis.com/auth/chat.app.memberships.readonly` - [User
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-user) with one of the following authorization scopes: -
    * `https://www.googleapis.com/auth/chat.spaces.readonly` -

src/HangoutsChat/Resource/UsersSections.php

@@ -34,8 +34,7 @@
 class UsersSections extends \Google\Service\Resource
 {
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Creates
-   * a section in Google Chat. Sections help users group conversations and
+   * Creates a section in Google Chat. Sections help users group conversations and
    * customize the list of spaces displayed in Chat navigation panel. Only
    * sections of type `CUSTOM_SECTION` can be created. For details, see [Create
    * and organize sections in Google
@@ -60,10 +59,9 @@ public function create($parent, GoogleChatV1Section $postBody, $optParams = [])
     return $this->call('create', [$params], GoogleChatV1Section::class);
   }
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Deletes
-   * a section of type `CUSTOM_SECTION`. If the section contains items, such as
-   * spaces, the items are moved to Google Chat's default sections and are not
-   * deleted. For details, see [Create and organize sections in Google
+   * Deletes a section of type `CUSTOM_SECTION`. If the section contains items,
+   * such as spaces, the items are moved to Google Chat's default sections and are
+   * not deleted. For details, see [Create and organize sections in Google
    * Chat](https://support.google.com/chat/answer/16059854). Requires [user
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-user) with the [authorization
@@ -84,8 +82,7 @@ public function delete($name, $optParams = [])
     return $this->call('delete', [$params], ChatEmpty::class);
   }
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Lists
-   * sections available to the Chat user. Sections help users group their
+   * Lists sections available to the Chat user. Sections help users group their
    * conversations and customize the list of spaces displayed in Chat navigation
    * panel. For details, see [Create and organize sections in Google
    * Chat](https://support.google.com/chat/answer/16059854). Requires [user
@@ -125,8 +122,7 @@ public function listUsersSections($parent, $optParams = [])
     return $this->call('list', [$params], ListSectionsResponse::class);
   }
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Updates
-   * a section. Only sections of type `CUSTOM_SECTION` can be updated. For
+   * Updates a section. Only sections of type `CUSTOM_SECTION` can be updated. For
    * details, see [Create and organize sections in Google
    * Chat](https://support.google.com/chat/answer/16059854). Requires [user
    * authentication](https://developers.google.com/workspace/chat/authenticate-
@@ -156,10 +152,9 @@ public function patch($name, GoogleChatV1Section $postBody, $optParams = [])
     return $this->call('patch', [$params], GoogleChatV1Section::class);
   }
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Changes
-   * the sort order of a section. For details, see [Create and organize sections
-   * in Google Chat](https://support.google.com/chat/answer/16059854). Requires
-   * [user
+   * Changes the sort order of a section. For details, see [Create and organize
+   * sections in Google Chat](https://support.google.com/chat/answer/16059854).
+   * Requires [user
    * authentication](https://developers.google.com/workspace/chat/authenticate-
    * authorize-chat-user) with the [authorization
    * scope](https://developers.google.com/workspace/chat/authenticate-

src/HangoutsChat/Resource/UsersSectionsItems.php

@@ -32,8 +32,7 @@
 class UsersSectionsItems extends \Google\Service\Resource
 {
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Lists
-   * items in a section. Only spaces can be section items. For details, see
+   * Lists items in a section. Only spaces can be section items. For details, see
    * [Create and organize sections in Google
    * Chat](https://support.google.com/chat/answer/16059854). Requires [user
    * authentication](https://developers.google.com/workspace/chat/authenticate-
@@ -74,8 +73,7 @@ public function listUsersSectionsItems($parent, $optParams = [])
     return $this->call('list', [$params], ListSectionItemsResponse::class);
   }
   /**
-   * [Developer Preview](https://developers.google.com/workspace/preview): Moves
-   * an item from one section to another. For example, if a section contains
+   * Moves an item from one section to another. For example, if a section contains
    * spaces, this method can be used to move a space to a different section. For
    * details, see [Create and organize sections in Google
    * Chat](https://support.google.com/chat/answer/16059854). Requires [user