🦉 Updates from OwlBot post-processor

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

Author: gcf-owl-bot[bot]

google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java

@@ -115,146 +115,19 @@
  * <p>Note: close() needs to be called on the DatastoreAdminClient object to clean up resources such
  * as threads. In the example above, try-with-resources is used, which automatically calls close().
  *
- * <table>
- * <tr>
- * <th>Method</th>
- * <th>Description</th>
- * <th>Method Variants</th>
- * <tr>
- * <td>ExportEntities</td>
- * <td><p>Exports a copy of all or a subset of entities from Google Cloud Datastore
- * to another storage system, such as Google Cloud Storage. Recent updates to
- * entities may not be reflected in the export. The export occurs in the
- * background and its progress can be monitored and managed via the
- * Operation resource that is created. The output of an export may only be
- * used once the associated operation is done. If an export operation is
- * cancelled before completion it may leave partial data behind in Google
- * Cloud Storage.</p></td>
- * <td>
- * <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
- * <ul>
- * <li>exportEntitiesAsync(ExportEntitiesRequest request)
- * </ul>
- * <p>Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.</p>
- * <ul>
- * <li>exportEntitiesAsync(String projectId, Map<String, String> labels, EntityFilter entityFilter, String outputUrlPrefix)
- * </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>exportEntitiesOperationCallable()
- * <li>exportEntitiesCallable()
- * </ul>
- * </td>
- * </tr>
- * <tr>
- * <td>ImportEntities</td>
- * <td><p>Imports entities into Google Cloud Datastore. Existing entities with the
- * same key are overwritten. The import occurs in the background and its
- * progress can be monitored and managed via the Operation resource that is
- * created. If an ImportEntities operation is cancelled, it is possible
- * that a subset of the data has already been imported to Cloud Datastore.</p></td>
- * <td>
- * <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
- * <ul>
- * <li>importEntitiesAsync(ImportEntitiesRequest request)
- * </ul>
- * <p>Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.</p>
- * <ul>
- * <li>importEntitiesAsync(String projectId, Map<String, String> labels, String inputUrl, EntityFilter entityFilter)
- * </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>importEntitiesOperationCallable()
- * <li>importEntitiesCallable()
- * </ul>
- * </td>
- * </tr>
- * <tr>
- * <td>CreateIndex</td>
- * <td><p>Creates the specified index.
- * A newly created index's initial state is `CREATING`. On completion of the
- * returned [google.longrunning.Operation][google.longrunning.Operation], the
- * state will be `READY`. If the index already exists, the call will return an
- * `ALREADY_EXISTS` status.
+ * <p>The surface of this class includes several types of Java methods for each of the API's
+ * methods:
  *
- * During index creation, the process could result in an error, in which
- * case the index will move to the `ERROR` state. The process can be recovered
- * by fixing the data that caused the error, removing the index with
- * [delete][google.datastore.admin.v1.DatastoreAdmin.DeleteIndex], then
- * re-creating the index with [create]
- * [google.datastore.admin.v1.DatastoreAdmin.CreateIndex].
- *
- * Indexes with a single property cannot be created.</p></td>
- * <td>
- * <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
- * <ul>
- * <li>createIndexAsync(CreateIndexRequest 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>createIndexOperationCallable()
- * <li>createIndexCallable()
- * </ul>
- * </td>
- * </tr>
- * <tr>
- * <td>DeleteIndex</td>
- * <td><p>Deletes an existing index.
- * An index can only be deleted if it is in a `READY` or `ERROR` state. On
- * successful execution of the request, the index will be in a `DELETING`
- * [state][google.datastore.admin.v1.Index.State]. And on completion of the
- * returned [google.longrunning.Operation][google.longrunning.Operation], the
- * index will be removed.
- *
- * During index deletion, the process could result in an error, in which
- * case the index will move to the `ERROR` state. The process can be recovered
- * by fixing the data that caused the error, followed by calling
- * [delete][google.datastore.admin.v1.DatastoreAdmin.DeleteIndex] again.</p></td>
- * <td>
- * <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
- * <ul>
- * <li>deleteIndexAsync(DeleteIndexRequest 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>deleteIndexOperationCallable()
- * <li>deleteIndexCallable()
- * </ul>
- * </td>
- * </tr>
- * <tr>
- * <td>GetIndex</td>
- * <td><p>Gets an index.</p></td>
- * <td>
- * <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
- * <ul>
- * <li>getIndex(GetIndexRequest 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>getIndexCallable()
- * </ul>
- * </td>
- * </tr>
- * <tr>
- * <td>ListIndexes</td>
- * <td><p>Lists the indexes that match the specified filters. Datastore uses an
- * eventually consistent query to fetch the list of indexes and may
- * occasionally return stale results.</p></td>
- * <td>
- * <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
- * <ul>
- * <li>listIndexes(ListIndexesRequest 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>listIndexesPagedCallable()
- * <li>listIndexesCallable()
- * </ul>
- * </td>
- * </tr>
- * </tr>
- * </table>
+ * <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>
  *
  * <p>See the individual methods for example code.
  *