fix(deps): Update the Java code generator (gapic-generator-java) to 2…

….32.0 (#1534)

* chore: Add FindNearest API to the preview branch
docs: Improve the documentation on Document.fields

PiperOrigin-RevId: 599602467

Source-Link: googleapis/googleapis@d32bd97

Source-Link: googleapis/googleapis-gen@0545ffc
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDU0NWZmYzQ4OGI4MmQzYTQ3NzExMThjOTIzZDY0Y2QwYjc1OTk1MyJ9

* 🦉 Updates from OwlBot post-processor

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

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

PiperOrigin-RevId: 599914188

Source-Link: googleapis/googleapis@17e6661

Source-Link: googleapis/googleapis-gen@d86ba5b
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZDg2YmE1YmU1MzdlNDg5NDM1MTA1Y2E4NTU2NmNjNDEwMzMwMWFiYSJ9

* 🦉 Updates from OwlBot post-processor

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

---------

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

google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/stub/FirestoreAdminStubSettings.java

@@ -403,6 +403,15 @@ public FirestoreAdminStub createStub() throws IOException {
             "Transport not supported: %s", getTransportChannelProvider().getTransportName()));
   }
 
+  /** Returns the endpoint set by the user or the the service's default endpoint. */
+  @Override
+  public String getEndpoint() {
+    if (super.getEndpoint() != null) {
+      return super.getEndpoint();
+    }
+    return getDefaultEndpoint();
+  }
+
   /** Returns the default service name. */
   @Override
   public String getServiceName() {
@@ -713,7 +722,6 @@ private static Builder createDefault() {
       builder.setTransportChannelProvider(defaultTransportChannelProvider());
       builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build());
       builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build());
-      builder.setEndpoint(getDefaultEndpoint());
       builder.setMtlsEndpoint(getDefaultMtlsEndpoint());
       builder.setSwitchToMtlsEndpointAllowed(true);
 
@@ -726,7 +734,6 @@ private static Builder createHttpJsonDefault() {
       builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build());
       builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build());
       builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build());
-      builder.setEndpoint(getDefaultEndpoint());
       builder.setMtlsEndpoint(getDefaultMtlsEndpoint());
       builder.setSwitchToMtlsEndpointAllowed(true);
 
@@ -1119,6 +1126,15 @@ public UnaryCallSettings.Builder<DeleteDatabaseRequest, Operation> deleteDatabas
       return deleteDatabaseOperationSettings;
     }
 
+    /** Returns the endpoint set by the user or the the service's default endpoint. */
+    @Override
+    public String getEndpoint() {
+      if (super.getEndpoint() != null) {
+        return super.getEndpoint();
+      }
+      return getDefaultEndpoint();
+    }
+
     @Override
     public FirestoreAdminStubSettings build() throws IOException {
       return new FirestoreAdminStubSettings(this);

google-cloud-firestore/src/main/java/com/google/cloud/firestore/v1/FirestoreClient.java

@@ -105,240 +105,241 @@
  *      <th>Method</th>
  *      <th>Description</th>
  *      <th>Method Variants</th>
+ *    </tr>
  *    <tr>
- *      <td>GetDocument</td>
+ *      <td><p> GetDocument</td>
  *      <td><p> Gets a single document.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>getDocument(GetDocumentRequest request)
+ *           <li><p> getDocument(GetDocumentRequest 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>getDocumentCallable()
+ *           <li><p> getDocumentCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>ListDocuments</td>
+ *      <td><p> ListDocuments</td>
  *      <td><p> Lists documents.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>listDocuments(ListDocumentsRequest request)
+ *           <li><p> listDocuments(ListDocumentsRequest 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>listDocumentsPagedCallable()
- *           <li>listDocumentsCallable()
+ *           <li><p> listDocumentsPagedCallable()
+ *           <li><p> listDocumentsCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>UpdateDocument</td>
+ *      <td><p> UpdateDocument</td>
  *      <td><p> Updates or inserts a document.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>updateDocument(UpdateDocumentRequest request)
+ *           <li><p> updateDocument(UpdateDocumentRequest 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>updateDocument(Document document, DocumentMask updateMask)
+ *           <li><p> updateDocument(Document document, DocumentMask 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>updateDocumentCallable()
+ *           <li><p> updateDocumentCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>DeleteDocument</td>
+ *      <td><p> DeleteDocument</td>
  *      <td><p> Deletes a document.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>deleteDocument(DeleteDocumentRequest request)
+ *           <li><p> deleteDocument(DeleteDocumentRequest 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>deleteDocument(String name)
+ *           <li><p> deleteDocument(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>deleteDocumentCallable()
+ *           <li><p> deleteDocumentCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>BatchGetDocuments</td>
+ *      <td><p> BatchGetDocuments</td>
  *      <td><p> Gets multiple documents.
  * <p>  Documents returned by this method are not guaranteed to be returned in the same order that they were requested.</td>
  *      <td>
  *      <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>batchGetDocumentsCallable()
+ *           <li><p> batchGetDocumentsCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>BeginTransaction</td>
+ *      <td><p> BeginTransaction</td>
  *      <td><p> Starts a new transaction.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>beginTransaction(BeginTransactionRequest request)
+ *           <li><p> beginTransaction(BeginTransactionRequest 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>beginTransaction(String database)
+ *           <li><p> beginTransaction(String database)
  *      </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>beginTransactionCallable()
+ *           <li><p> beginTransactionCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>Commit</td>
+ *      <td><p> Commit</td>
  *      <td><p> Commits a transaction, while optionally updating documents.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>commit(CommitRequest request)
+ *           <li><p> commit(CommitRequest 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>commit(String database, List&lt;Write&gt; writes)
+ *           <li><p> commit(String database, List&lt;Write&gt; writes)
  *      </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>commitCallable()
+ *           <li><p> commitCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>Rollback</td>
+ *      <td><p> Rollback</td>
  *      <td><p> Rolls back a transaction.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>rollback(RollbackRequest request)
+ *           <li><p> rollback(RollbackRequest 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>rollback(String database, ByteString transaction)
+ *           <li><p> rollback(String database, ByteString transaction)
  *      </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>rollbackCallable()
+ *           <li><p> rollbackCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>RunQuery</td>
+ *      <td><p> RunQuery</td>
  *      <td><p> Runs a query.</td>
  *      <td>
  *      <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>runQueryCallable()
+ *           <li><p> runQueryCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>RunAggregationQuery</td>
+ *      <td><p> RunAggregationQuery</td>
  *      <td><p> Runs an aggregation query.
  * <p>  Rather than producing [Document][google.firestore.v1.Document] results like [Firestore.RunQuery][google.firestore.v1.Firestore.RunQuery], this API allows running an aggregation to produce a series of [AggregationResult][google.firestore.v1.AggregationResult] server-side.
  * <p>  High-Level Example:
  * <p>  ``` -- Return the number of documents in table given a filter. SELECT COUNT(&#42;) FROM ( SELECT &#42; FROM k where a = true ); ```</td>
  *      <td>
  *      <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>runAggregationQueryCallable()
+ *           <li><p> runAggregationQueryCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>PartitionQuery</td>
+ *      <td><p> PartitionQuery</td>
  *      <td><p> Partitions a query by returning partition cursors that can be used to run the query in parallel. The returned partition cursors are split points that can be used by RunQuery as starting/end points for the query results.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>partitionQuery(PartitionQueryRequest request)
+ *           <li><p> partitionQuery(PartitionQueryRequest 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>partitionQueryPagedCallable()
- *           <li>partitionQueryCallable()
+ *           <li><p> partitionQueryPagedCallable()
+ *           <li><p> partitionQueryCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>Write</td>
+ *      <td><p> Write</td>
  *      <td><p> Streams batches of document updates and deletes, in order. This method is only available via gRPC or WebChannel (not REST).</td>
  *      <td>
  *      <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>writeCallable()
+ *           <li><p> writeCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>Listen</td>
+ *      <td><p> Listen</td>
  *      <td><p> Listens to changes. This method is only available via gRPC or WebChannel (not REST).</td>
  *      <td>
  *      <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>listenCallable()
+ *           <li><p> listenCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>ListCollectionIds</td>
+ *      <td><p> ListCollectionIds</td>
  *      <td><p> Lists all the collection IDs underneath a document.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>listCollectionIds(ListCollectionIdsRequest request)
+ *           <li><p> listCollectionIds(ListCollectionIdsRequest 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>listCollectionIds(String parent)
+ *           <li><p> listCollectionIds(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>listCollectionIdsPagedCallable()
- *           <li>listCollectionIdsCallable()
+ *           <li><p> listCollectionIdsPagedCallable()
+ *           <li><p> listCollectionIdsCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>BatchWrite</td>
+ *      <td><p> BatchWrite</td>
  *      <td><p> Applies a batch of write operations.
  * <p>  The BatchWrite method does not apply the write operations atomically and can apply them out of order. Method does not allow more than one write per document. Each write succeeds or fails independently. See the [BatchWriteResponse][google.firestore.v1.BatchWriteResponse] for the success status of each write.
  * <p>  If you require an atomically applied set of writes, use [Commit][google.firestore.v1.Firestore.Commit] instead.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>batchWrite(BatchWriteRequest request)
+ *           <li><p> batchWrite(BatchWriteRequest 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>batchWriteCallable()
+ *           <li><p> batchWriteCallable()
  *      </ul>
  *       </td>
  *    </tr>
  *    <tr>
- *      <td>CreateDocument</td>
+ *      <td><p> CreateDocument</td>
  *      <td><p> Creates a new document.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
- *           <li>createDocument(CreateDocumentRequest request)
+ *           <li><p> createDocument(CreateDocumentRequest 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>createDocumentCallable()
+ *           <li><p> createDocumentCallable()
  *      </ul>
  *       </td>
  *    </tr>

google-cloud-firestore/src/main/java/com/google/cloud/firestore/v1/stub/FirestoreStubSettings.java

@@ -426,6 +426,15 @@ public FirestoreStub createStub() throws IOException {
             "Transport not supported: %s", getTransportChannelProvider().getTransportName()));
   }
 
+  /** Returns the endpoint set by the user or the the service's default endpoint. */
+  @Override
+  public String getEndpoint() {
+    if (super.getEndpoint() != null) {
+      return super.getEndpoint();
+    }
+    return getDefaultEndpoint();
+  }
+
   /** Returns the default service name. */
   @Override
   public String getServiceName() {
@@ -769,7 +778,6 @@ private static Builder createDefault() {
       builder.setTransportChannelProvider(defaultTransportChannelProvider());
       builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build());
       builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build());
-      builder.setEndpoint(getDefaultEndpoint());
       builder.setMtlsEndpoint(getDefaultMtlsEndpoint());
       builder.setSwitchToMtlsEndpointAllowed(true);
 
@@ -782,7 +790,6 @@ private static Builder createHttpJsonDefault() {
       builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build());
       builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build());
       builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build());
-      builder.setEndpoint(getDefaultEndpoint());
       builder.setMtlsEndpoint(getDefaultMtlsEndpoint());
       builder.setSwitchToMtlsEndpointAllowed(true);
 
@@ -969,6 +976,15 @@ public UnaryCallSettings.Builder<CreateDocumentRequest, Document> createDocument
       return createDocumentSettings;
     }
 
+    /** Returns the endpoint set by the user or the the service's default endpoint. */
+    @Override
+    public String getEndpoint() {
+      if (super.getEndpoint() != null) {
+        return super.getEndpoint();
+      }
+      return getDefaultEndpoint();
+    }
+
     @Override
     public FirestoreStubSettings build() throws IOException {
       return new FirestoreStubSettings(this);