fix(deps): [Many APIs] Update the Java code generator (gapic-generato…

…r-java) to 2.31.0 (#10201)

* fix(deps): Update the Java code generator (gapic-generator-java) to 2.31.0

PiperOrigin-RevId: 596645164

Source-Link: googleapis/googleapis@4a0e62e

Source-Link: https://github.com/googleapis/googleapis-gen/commit/a10ed6a77676c37e60799098d48d0afb16008613
Copy-Tag: eyJwIjoiamF2YS1yZWNvbW1lbmRhdGlvbnMtYWkvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1yZWNvbW1lbmRlci8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9
Copy-Tag: eyJwIjoiamF2YS1yZWRpcy1jbHVzdGVyLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0=
Copy-Tag: eyJwIjoiamF2YS1yZWRpcy8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9
Copy-Tag: eyJwIjoiamF2YS1yZXNvdXJjZS1zZXR0aW5ncy8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9
Copy-Tag: eyJwIjoiamF2YS1yZXNvdXJjZW1hbmFnZXIvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1ydW4vLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1zY2hlZHVsZXIvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1zZWNyZXRtYW5hZ2VyLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0=
Copy-Tag: eyJwIjoiamF2YS1zZWN1cmVzb3VyY2VtYW5hZ2VyLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0=
Copy-Tag: eyJwIjoiamF2YS1zZWN1cml0eS1wcml2YXRlLWNhLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0=
Copy-Tag: eyJwIjoiamF2YS1zZWN1cml0eWNlbnRlci1zZXR0aW5ncy8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9
Copy-Tag: eyJwIjoiamF2YS1zZWN1cml0eWNlbnRlci8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9
Copy-Tag: eyJwIjoiamF2YS1zZXJ2aWNlLWNvbnRyb2wvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1zZXJ2aWNlLW1hbmFnZW1lbnQvLk93bEJvdC55YW1sIiwiaCI6ImExMGVkNmE3NzY3NmMzN2U2MDc5OTA5OGQ0OGQwYWZiMTYwMDg2MTMifQ==
Copy-Tag: eyJwIjoiamF2YS1zZXJ2aWNlLXVzYWdlLy5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0=
Copy-Tag: eyJwIjoiamF2YS1zZXJ2aWNlZGlyZWN0b3J5Ly5Pd2xCb3QueWFtbCIsImgiOiJhMTBlZDZhNzc2NzZjMzdlNjA3OTkwOThkNDhkMGFmYjE2MDA4NjEzIn0=
Copy-Tag: eyJwIjoiamF2YS1zaGVsbC8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9
Copy-Tag: eyJwIjoiamF2YS1zaG9wcGluZy1tZXJjaGFudC1pbnZlbnRvcmllcy8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* chore: reverted Ignore annotation deletion

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Tomo Suzuki <suztomo@google.com>

java-recommendations-ai/README.md

@@ -202,7 +202,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-preview-yellow
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-recommendations-ai.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-recommendations-ai/0.37.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-recommendations-ai/0.39.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/CatalogServiceClient.java

@@ -62,19 +62,127 @@
  * <p>Note: close() needs to be called on the CatalogServiceClient object to clean up resources such
  * as threads. In the example above, try-with-resources is used, which automatically calls close().
  *
- * <p>The surface of this class includes several types of Java methods for each of the API's
- * methods:
- *
- * <ol>
- *   <li>A "flattened" method. With this type of method, the fields of the request type have been
- *       converted into function parameters. It may be the case that not all fields are available as
- *       parameters, and not every API method will have a flattened method entry point.
- *   <li>A "request object" method. This type of method only takes one parameter, a request object,
- *       which must be constructed before the call. Not every API method will have a request object
- *       method.
- *   <li>A "callable" method. This type of method takes no parameters and returns an immutable API
- *       callable object, which can be used to initiate calls to the service.
- * </ol>
+ * <table>
+ *    <tr>
+ *      <th>Method</th>
+ *      <th>Description</th>
+ *      <th>Method Variants</th>
+ *    <tr>
+ *      <td>CreateCatalogItem</td>
+ *      <td><p> Creates a catalog item.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>createCatalogItem(CreateCatalogItemRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>createCatalogItem(CatalogName parent, CatalogItem catalogItem)
+ *           <li>createCatalogItem(String parent, CatalogItem catalogItem)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>createCatalogItemCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>GetCatalogItem</td>
+ *      <td><p> Gets a specific catalog item.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>getCatalogItem(GetCatalogItemRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>getCatalogItem(CatalogItemPathName name)
+ *           <li>getCatalogItem(String name)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>getCatalogItemCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>ListCatalogItems</td>
+ *      <td><p> Gets a list of catalog items.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>listCatalogItems(ListCatalogItemsRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>listCatalogItems(CatalogName parent, String filter)
+ *           <li>listCatalogItems(String parent, String filter)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>listCatalogItemsPagedCallable()
+ *           <li>listCatalogItemsCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>UpdateCatalogItem</td>
+ *      <td><p> Updates a catalog item. Partial updating is supported. Non-existing items will be created.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>updateCatalogItem(UpdateCatalogItemRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>updateCatalogItem(CatalogItemPathName name, CatalogItem catalogItem, FieldMask updateMask)
+ *           <li>updateCatalogItem(String name, CatalogItem catalogItem, FieldMask updateMask)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>updateCatalogItemCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>DeleteCatalogItem</td>
+ *      <td><p> Deletes a catalog item.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>deleteCatalogItem(DeleteCatalogItemRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>deleteCatalogItem(CatalogItemPathName name)
+ *           <li>deleteCatalogItem(String name)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>deleteCatalogItemCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>ImportCatalogItems</td>
+ *      <td><p> Bulk import of multiple catalog items. Request processing may be synchronous. No partial updating supported. Non-existing items will be created.
+ * <p>  Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully updated.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>importCatalogItemsAsync(CatalogName parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig)
+ *           <li>importCatalogItemsAsync(String parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig)
+ *           <li>importCatalogItemsAsync(ImportCatalogItemsRequest request)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>importCatalogItemsOperationCallable()
+ *           <li>importCatalogItemsCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    </tr>
+ *  </table>
  *
  * <p>See the individual methods for example code.
  *

java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionApiKeyRegistryClient.java

@@ -66,19 +66,71 @@
  * resources such as threads. In the example above, try-with-resources is used, which automatically
  * calls close().
  *
- * <p>The surface of this class includes several types of Java methods for each of the API's
- * methods:
- *
- * <ol>
- *   <li>A "flattened" method. With this type of method, the fields of the request type have been
- *       converted into function parameters. It may be the case that not all fields are available as
- *       parameters, and not every API method will have a flattened method entry point.
- *   <li>A "request object" method. This type of method only takes one parameter, a request object,
- *       which must be constructed before the call. Not every API method will have a request object
- *       method.
- *   <li>A "callable" method. This type of method takes no parameters and returns an immutable API
- *       callable object, which can be used to initiate calls to the service.
- * </ol>
+ * <table>
+ *    <tr>
+ *      <th>Method</th>
+ *      <th>Description</th>
+ *      <th>Method Variants</th>
+ *    <tr>
+ *      <td>CreatePredictionApiKeyRegistration</td>
+ *      <td><p> Register an API key for use with predict method.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>createPredictionApiKeyRegistration(CreatePredictionApiKeyRegistrationRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>createPredictionApiKeyRegistration(EventStoreName parent, PredictionApiKeyRegistration predictionApiKeyRegistration)
+ *           <li>createPredictionApiKeyRegistration(String parent, PredictionApiKeyRegistration predictionApiKeyRegistration)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>createPredictionApiKeyRegistrationCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>ListPredictionApiKeyRegistrations</td>
+ *      <td><p> List the registered apiKeys for use with predict method.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>listPredictionApiKeyRegistrations(ListPredictionApiKeyRegistrationsRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>listPredictionApiKeyRegistrations(EventStoreName parent)
+ *           <li>listPredictionApiKeyRegistrations(String parent)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>listPredictionApiKeyRegistrationsPagedCallable()
+ *           <li>listPredictionApiKeyRegistrationsCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    <tr>
+ *      <td>DeletePredictionApiKeyRegistration</td>
+ *      <td><p> Unregister an apiKey from using for predict method.</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>deletePredictionApiKeyRegistration(DeletePredictionApiKeyRegistrationRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>deletePredictionApiKeyRegistration(PredictionApiKeyRegistrationName name)
+ *           <li>deletePredictionApiKeyRegistration(String name)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>deletePredictionApiKeyRegistrationCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    </tr>
+ *  </table>
  *
  * <p>See the individual methods for example code.
  *

java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionServiceClient.java

@@ -63,19 +63,33 @@
  * such as threads. In the example above, try-with-resources is used, which automatically calls
  * close().
  *
- * <p>The surface of this class includes several types of Java methods for each of the API's
- * methods:
- *
- * <ol>
- *   <li>A "flattened" method. With this type of method, the fields of the request type have been
- *       converted into function parameters. It may be the case that not all fields are available as
- *       parameters, and not every API method will have a flattened method entry point.
- *   <li>A "request object" method. This type of method only takes one parameter, a request object,
- *       which must be constructed before the call. Not every API method will have a request object
- *       method.
- *   <li>A "callable" method. This type of method takes no parameters and returns an immutable API
- *       callable object, which can be used to initiate calls to the service.
- * </ol>
+ * <table>
+ *    <tr>
+ *      <th>Method</th>
+ *      <th>Description</th>
+ *      <th>Method Variants</th>
+ *    <tr>
+ *      <td>Predict</td>
+ *      <td><p> Makes a recommendation prediction. If using API Key based authentication, the API Key must be registered using the [PredictionApiKeyRegistry][google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry] service. [Learn more](/recommendations-ai/docs/setting-up#register-key).</td>
+ *      <td>
+ *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
+ *      <ul>
+ *           <li>predict(PredictRequest request)
+ *      </ul>
+ *      <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
+ *      <ul>
+ *           <li>predict(PlacementName name, UserEvent userEvent)
+ *           <li>predict(String name, UserEvent userEvent)
+ *      </ul>
+ *      <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
+ *      <ul>
+ *           <li>predictPagedCallable()
+ *           <li>predictCallable()
+ *      </ul>
+ *       </td>
+ *    </tr>
+ *    </tr>
+ *  </table>
  *
  * <p>See the individual methods for example code.
  *