diff --git a/README.md b/README.md index 1e91e0a91..e8439ed7d 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ If you are using Maven without the BOM, add this to your dependencies: If you are using Gradle 5.x or later, add this to your dependencies: ```Groovy -implementation platform('com.google.cloud:libraries-bom:26.19.0') +implementation platform('com.google.cloud:libraries-bom:26.20.0') implementation 'com.google.cloud:google-cloud-datastore' ``` diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java index 7d4752fb9..399e61e01 100644 --- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java +++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/DatastoreAdminClient.java @@ -58,56 +58,40 @@ * *

The Datastore Admin API provides several admin services for Cloud Datastore. * - *

----------------------------------------------------------------------------- ## Concepts - * - *

Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. + *

Concepts: Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. * *

Operation: An Operation represents work being performed in the background. * *

EntityFilter: Allows specifying a subset of entities in a project. This is specified as a * combination of kinds and namespaces (either or both of which may be all). * - *

----------------------------------------------------------------------------- ## Services - * - *

# Export/Import - * - *

The Export/Import service provides the ability to copy all or a subset of entities to/from - * Google Cloud Storage. - * - *

Exported data may be imported into Cloud Datastore for any Google Cloud Platform project. It - * is not restricted to the export source project. It is possible to export from one project and - * then import into another. - * - *

Exported data can also be loaded into Google BigQuery for analysis. + *

Export/Import Service: * - *

Exports and imports are performed asynchronously. An Operation resource is created for each - * export/import. The state (including any errors encountered) of the export/import may be queried - * via the Operation resource. + *

- The Export/Import service provides the ability to copy all or a subset of entities to/from + * Google Cloud Storage. - Exported data may be imported into Cloud Datastore for any Google Cloud + * Platform project. It is not restricted to the export source project. It is possible to export + * from one project and then import into another. - Exported data can also be loaded into Google + * BigQuery for analysis. - Exports and imports are performed asynchronously. An Operation resource + * is created for each export/import. The state (including any errors encountered) of the + * export/import may be queried via the Operation resource. * - *

# Index + *

Index Service: * - *

The index service manages Cloud Datastore composite indexes. + *

- The index service manages Cloud Datastore composite indexes. - Index creation and deletion + * are performed asynchronously. An Operation resource is created for each such asynchronous + * operation. The state of the operation (including any errors encountered) may be queried via the + * Operation resource. * - *

Index creation and deletion are performed asynchronously. An Operation resource is created for - * each such asynchronous operation. The state of the operation (including any errors encountered) - * may be queried via the Operation resource. + *

Operation Service: * - *

# Operation - * - *

The Operations collection provides a record of actions performed for the specified project + *

- The Operations collection provides a record of actions performed for the specified project * (including any operations in progress). Operations are not created directly but through calls on - * other collections or resources. - * - *

An operation that is not yet done may be cancelled. The request to cancel is asynchronous and - * the operation may continue to run for some time after the request to cancel is made. - * - *

An operation that is done may be deleted so that it is no longer listed as part of the - * Operation collection. - * - *

ListOperations returns all pending operations, but not completed operations. - * - *

Operations are created by service DatastoreAdmin, but are accessed via service - * google.longrunning.Operations. + * other collections or resources. - An operation that is not yet done may be cancelled. The request + * to cancel is asynchronous and the operation may continue to run for some time after the request + * to cancel is made. - An operation that is done may be deleted so that it is no longer listed as + * part of the Operation collection. - ListOperations returns all pending operations, but not + * completed operations. - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. * *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: diff --git a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java index b6dd28a57..3079a193a 100644 --- a/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java +++ b/google-cloud-datastore/src/main/java/com/google/cloud/datastore/admin/v1/package-info.java @@ -25,56 +25,40 @@ * *

The Datastore Admin API provides several admin services for Cloud Datastore. * - *

----------------------------------------------------------------------------- ## Concepts - * - *

Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. + *

Concepts: Project, namespace, kind, and entity as defined in the Google Cloud Datastore API. * *

Operation: An Operation represents work being performed in the background. * *

EntityFilter: Allows specifying a subset of entities in a project. This is specified as a * combination of kinds and namespaces (either or both of which may be all). * - *

----------------------------------------------------------------------------- ## Services - * - *

# Export/Import - * - *

The Export/Import service provides the ability to copy all or a subset of entities to/from - * Google Cloud Storage. - * - *

Exported data may be imported into Cloud Datastore for any Google Cloud Platform project. It - * is not restricted to the export source project. It is possible to export from one project and - * then import into another. - * - *

Exported data can also be loaded into Google BigQuery for analysis. + *

Export/Import Service: * - *

Exports and imports are performed asynchronously. An Operation resource is created for each - * export/import. The state (including any errors encountered) of the export/import may be queried - * via the Operation resource. + *

- The Export/Import service provides the ability to copy all or a subset of entities to/from + * Google Cloud Storage. - Exported data may be imported into Cloud Datastore for any Google Cloud + * Platform project. It is not restricted to the export source project. It is possible to export + * from one project and then import into another. - Exported data can also be loaded into Google + * BigQuery for analysis. - Exports and imports are performed asynchronously. An Operation resource + * is created for each export/import. The state (including any errors encountered) of the + * export/import may be queried via the Operation resource. * - *

# Index + *

Index Service: * - *

The index service manages Cloud Datastore composite indexes. + *

- The index service manages Cloud Datastore composite indexes. - Index creation and deletion + * are performed asynchronously. An Operation resource is created for each such asynchronous + * operation. The state of the operation (including any errors encountered) may be queried via the + * Operation resource. * - *

Index creation and deletion are performed asynchronously. An Operation resource is created for - * each such asynchronous operation. The state of the operation (including any errors encountered) - * may be queried via the Operation resource. + *

Operation Service: * - *

# Operation - * - *

The Operations collection provides a record of actions performed for the specified project + *

- The Operations collection provides a record of actions performed for the specified project * (including any operations in progress). Operations are not created directly but through calls on - * other collections or resources. - * - *

An operation that is not yet done may be cancelled. The request to cancel is asynchronous and - * the operation may continue to run for some time after the request to cancel is made. - * - *

An operation that is done may be deleted so that it is no longer listed as part of the - * Operation collection. - * - *

ListOperations returns all pending operations, but not completed operations. - * - *

Operations are created by service DatastoreAdmin, but are accessed via service - * google.longrunning.Operations. + * other collections or resources. - An operation that is not yet done may be cancelled. The request + * to cancel is asynchronous and the operation may continue to run for some time after the request + * to cancel is made. - An operation that is done may be deleted so that it is no longer listed as + * part of the Operation collection. - ListOperations returns all pending operations, but not + * completed operations. - Operations are created by service DatastoreAdmin, but are accessed via + * service google.longrunning.Operations. * *

Sample for DatastoreAdminClient: * diff --git a/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java b/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java index 6fe5618d7..1b1f7803f 100644 --- a/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java +++ b/grpc-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/DatastoreAdminGrpc.java @@ -23,44 +23,41 @@ *

  * Google Cloud Datastore Admin API
  * The Datastore Admin API provides several admin services for Cloud Datastore.
- * -----------------------------------------------------------------------------
- * ## Concepts
- * Project, namespace, kind, and entity as defined in the Google Cloud Datastore
- * API.
+ * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
+ * Datastore API.
  * Operation: An Operation represents work being performed in the background.
  * EntityFilter: Allows specifying a subset of entities in a project. This is
  * specified as a combination of kinds and namespaces (either or both of which
  * may be all).
- * -----------------------------------------------------------------------------
- * ## Services
- * # Export/Import
- * The Export/Import service provides the ability to copy all or a subset of
+ * Export/Import Service:
+ * - The Export/Import service provides the ability to copy all or a subset of
  * entities to/from Google Cloud Storage.
- * Exported data may be imported into Cloud Datastore for any Google Cloud
+ * - Exported data may be imported into Cloud Datastore for any Google Cloud
  * Platform project. It is not restricted to the export source project. It is
  * possible to export from one project and then import into another.
- * Exported data can also be loaded into Google BigQuery for analysis.
- * Exports and imports are performed asynchronously. An Operation resource is
+ * - Exported data can also be loaded into Google BigQuery for analysis.
+ * - Exports and imports are performed asynchronously. An Operation resource is
  * created for each export/import. The state (including any errors encountered)
  * of the export/import may be queried via the Operation resource.
- * # Index
- * The index service manages Cloud Datastore composite indexes.
- * Index creation and deletion are performed asynchronously.
+ * Index Service:
+ * - The index service manages Cloud Datastore composite indexes.
+ * - Index creation and deletion are performed asynchronously.
  * An Operation resource is created for each such asynchronous operation.
  * The state of the operation (including any errors encountered)
  * may be queried via the Operation resource.
- * # Operation
- * The Operations collection provides a record of actions performed for the
+ * Operation Service:
+ * - The Operations collection provides a record of actions performed for the
  * specified project (including any operations in progress). Operations are not
  * created directly but through calls on other collections or resources.
- * An operation that is not yet done may be cancelled. The request to cancel is
- * asynchronous and the operation may continue to run for some time after the
+ * - An operation that is not yet done may be cancelled. The request to cancel
+ * is asynchronous and the operation may continue to run for some time after the
  * request to cancel is made.
- * An operation that is done may be deleted so that it is no longer listed as
+ * - An operation that is done may be deleted so that it is no longer listed as
  * part of the Operation collection.
- * ListOperations returns all pending operations, but not completed operations.
- * Operations are created by service DatastoreAdmin,
- * but are accessed via service google.longrunning.Operations.
+ * - ListOperations returns all pending operations, but not completed
+ * operations.
+ * - Operations are created by service DatastoreAdmin, but are accessed via
+ * service google.longrunning.Operations.
  * 
*/ @javax.annotation.Generated( @@ -381,44 +378,41 @@ public DatastoreAdminFutureStub newStub( *
    * Google Cloud Datastore Admin API
    * The Datastore Admin API provides several admin services for Cloud Datastore.
-   * -----------------------------------------------------------------------------
-   * ## Concepts
-   * Project, namespace, kind, and entity as defined in the Google Cloud Datastore
-   * API.
+   * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
+   * Datastore API.
    * Operation: An Operation represents work being performed in the background.
    * EntityFilter: Allows specifying a subset of entities in a project. This is
    * specified as a combination of kinds and namespaces (either or both of which
    * may be all).
-   * -----------------------------------------------------------------------------
-   * ## Services
-   * # Export/Import
-   * The Export/Import service provides the ability to copy all or a subset of
+   * Export/Import Service:
+   * - The Export/Import service provides the ability to copy all or a subset of
    * entities to/from Google Cloud Storage.
-   * Exported data may be imported into Cloud Datastore for any Google Cloud
+   * - Exported data may be imported into Cloud Datastore for any Google Cloud
    * Platform project. It is not restricted to the export source project. It is
    * possible to export from one project and then import into another.
-   * Exported data can also be loaded into Google BigQuery for analysis.
-   * Exports and imports are performed asynchronously. An Operation resource is
+   * - Exported data can also be loaded into Google BigQuery for analysis.
+   * - Exports and imports are performed asynchronously. An Operation resource is
    * created for each export/import. The state (including any errors encountered)
    * of the export/import may be queried via the Operation resource.
-   * # Index
-   * The index service manages Cloud Datastore composite indexes.
-   * Index creation and deletion are performed asynchronously.
+   * Index Service:
+   * - The index service manages Cloud Datastore composite indexes.
+   * - Index creation and deletion are performed asynchronously.
    * An Operation resource is created for each such asynchronous operation.
    * The state of the operation (including any errors encountered)
    * may be queried via the Operation resource.
-   * # Operation
-   * The Operations collection provides a record of actions performed for the
+   * Operation Service:
+   * - The Operations collection provides a record of actions performed for the
    * specified project (including any operations in progress). Operations are not
    * created directly but through calls on other collections or resources.
-   * An operation that is not yet done may be cancelled. The request to cancel is
-   * asynchronous and the operation may continue to run for some time after the
+   * - An operation that is not yet done may be cancelled. The request to cancel
+   * is asynchronous and the operation may continue to run for some time after the
    * request to cancel is made.
-   * An operation that is done may be deleted so that it is no longer listed as
+   * - An operation that is done may be deleted so that it is no longer listed as
    * part of the Operation collection.
-   * ListOperations returns all pending operations, but not completed operations.
-   * Operations are created by service DatastoreAdmin,
-   * but are accessed via service google.longrunning.Operations.
+   * - ListOperations returns all pending operations, but not completed
+   * operations.
+   * - Operations are created by service DatastoreAdmin, but are accessed via
+   * service google.longrunning.Operations.
    * 
*/ public interface AsyncService { @@ -468,9 +462,9 @@ default void importEntities( *
      * 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.
+     * 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.
      * 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
@@ -495,7 +489,8 @@ default void createIndex(
      * 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.
+     * 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
@@ -546,44 +541,41 @@ default void listIndexes(
    * 
    * Google Cloud Datastore Admin API
    * The Datastore Admin API provides several admin services for Cloud Datastore.
-   * -----------------------------------------------------------------------------
-   * ## Concepts
-   * Project, namespace, kind, and entity as defined in the Google Cloud Datastore
-   * API.
+   * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
+   * Datastore API.
    * Operation: An Operation represents work being performed in the background.
    * EntityFilter: Allows specifying a subset of entities in a project. This is
    * specified as a combination of kinds and namespaces (either or both of which
    * may be all).
-   * -----------------------------------------------------------------------------
-   * ## Services
-   * # Export/Import
-   * The Export/Import service provides the ability to copy all or a subset of
+   * Export/Import Service:
+   * - The Export/Import service provides the ability to copy all or a subset of
    * entities to/from Google Cloud Storage.
-   * Exported data may be imported into Cloud Datastore for any Google Cloud
+   * - Exported data may be imported into Cloud Datastore for any Google Cloud
    * Platform project. It is not restricted to the export source project. It is
    * possible to export from one project and then import into another.
-   * Exported data can also be loaded into Google BigQuery for analysis.
-   * Exports and imports are performed asynchronously. An Operation resource is
+   * - Exported data can also be loaded into Google BigQuery for analysis.
+   * - Exports and imports are performed asynchronously. An Operation resource is
    * created for each export/import. The state (including any errors encountered)
    * of the export/import may be queried via the Operation resource.
-   * # Index
-   * The index service manages Cloud Datastore composite indexes.
-   * Index creation and deletion are performed asynchronously.
+   * Index Service:
+   * - The index service manages Cloud Datastore composite indexes.
+   * - Index creation and deletion are performed asynchronously.
    * An Operation resource is created for each such asynchronous operation.
    * The state of the operation (including any errors encountered)
    * may be queried via the Operation resource.
-   * # Operation
-   * The Operations collection provides a record of actions performed for the
+   * Operation Service:
+   * - The Operations collection provides a record of actions performed for the
    * specified project (including any operations in progress). Operations are not
    * created directly but through calls on other collections or resources.
-   * An operation that is not yet done may be cancelled. The request to cancel is
-   * asynchronous and the operation may continue to run for some time after the
+   * - An operation that is not yet done may be cancelled. The request to cancel
+   * is asynchronous and the operation may continue to run for some time after the
    * request to cancel is made.
-   * An operation that is done may be deleted so that it is no longer listed as
+   * - An operation that is done may be deleted so that it is no longer listed as
    * part of the Operation collection.
-   * ListOperations returns all pending operations, but not completed operations.
-   * Operations are created by service DatastoreAdmin,
-   * but are accessed via service google.longrunning.Operations.
+   * - ListOperations returns all pending operations, but not completed
+   * operations.
+   * - Operations are created by service DatastoreAdmin, but are accessed via
+   * service google.longrunning.Operations.
    * 
*/ public abstract static class DatastoreAdminImplBase @@ -601,44 +593,41 @@ public final io.grpc.ServerServiceDefinition bindService() { *
    * Google Cloud Datastore Admin API
    * The Datastore Admin API provides several admin services for Cloud Datastore.
-   * -----------------------------------------------------------------------------
-   * ## Concepts
-   * Project, namespace, kind, and entity as defined in the Google Cloud Datastore
-   * API.
+   * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
+   * Datastore API.
    * Operation: An Operation represents work being performed in the background.
    * EntityFilter: Allows specifying a subset of entities in a project. This is
    * specified as a combination of kinds and namespaces (either or both of which
    * may be all).
-   * -----------------------------------------------------------------------------
-   * ## Services
-   * # Export/Import
-   * The Export/Import service provides the ability to copy all or a subset of
+   * Export/Import Service:
+   * - The Export/Import service provides the ability to copy all or a subset of
    * entities to/from Google Cloud Storage.
-   * Exported data may be imported into Cloud Datastore for any Google Cloud
+   * - Exported data may be imported into Cloud Datastore for any Google Cloud
    * Platform project. It is not restricted to the export source project. It is
    * possible to export from one project and then import into another.
-   * Exported data can also be loaded into Google BigQuery for analysis.
-   * Exports and imports are performed asynchronously. An Operation resource is
+   * - Exported data can also be loaded into Google BigQuery for analysis.
+   * - Exports and imports are performed asynchronously. An Operation resource is
    * created for each export/import. The state (including any errors encountered)
    * of the export/import may be queried via the Operation resource.
-   * # Index
-   * The index service manages Cloud Datastore composite indexes.
-   * Index creation and deletion are performed asynchronously.
+   * Index Service:
+   * - The index service manages Cloud Datastore composite indexes.
+   * - Index creation and deletion are performed asynchronously.
    * An Operation resource is created for each such asynchronous operation.
    * The state of the operation (including any errors encountered)
    * may be queried via the Operation resource.
-   * # Operation
-   * The Operations collection provides a record of actions performed for the
+   * Operation Service:
+   * - The Operations collection provides a record of actions performed for the
    * specified project (including any operations in progress). Operations are not
    * created directly but through calls on other collections or resources.
-   * An operation that is not yet done may be cancelled. The request to cancel is
-   * asynchronous and the operation may continue to run for some time after the
+   * - An operation that is not yet done may be cancelled. The request to cancel
+   * is asynchronous and the operation may continue to run for some time after the
    * request to cancel is made.
-   * An operation that is done may be deleted so that it is no longer listed as
+   * - An operation that is done may be deleted so that it is no longer listed as
    * part of the Operation collection.
-   * ListOperations returns all pending operations, but not completed operations.
-   * Operations are created by service DatastoreAdmin,
-   * but are accessed via service google.longrunning.Operations.
+   * - ListOperations returns all pending operations, but not completed
+   * operations.
+   * - Operations are created by service DatastoreAdmin, but are accessed via
+   * service google.longrunning.Operations.
    * 
*/ public static final class DatastoreAdminStub @@ -701,9 +690,9 @@ public void importEntities( *
      * 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.
+     * 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.
      * 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
@@ -730,7 +719,8 @@ public void createIndex(
      * 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.
+     * 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
@@ -786,44 +776,41 @@ public void listIndexes(
    * 
    * Google Cloud Datastore Admin API
    * The Datastore Admin API provides several admin services for Cloud Datastore.
-   * -----------------------------------------------------------------------------
-   * ## Concepts
-   * Project, namespace, kind, and entity as defined in the Google Cloud Datastore
-   * API.
+   * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
+   * Datastore API.
    * Operation: An Operation represents work being performed in the background.
    * EntityFilter: Allows specifying a subset of entities in a project. This is
    * specified as a combination of kinds and namespaces (either or both of which
    * may be all).
-   * -----------------------------------------------------------------------------
-   * ## Services
-   * # Export/Import
-   * The Export/Import service provides the ability to copy all or a subset of
+   * Export/Import Service:
+   * - The Export/Import service provides the ability to copy all or a subset of
    * entities to/from Google Cloud Storage.
-   * Exported data may be imported into Cloud Datastore for any Google Cloud
+   * - Exported data may be imported into Cloud Datastore for any Google Cloud
    * Platform project. It is not restricted to the export source project. It is
    * possible to export from one project and then import into another.
-   * Exported data can also be loaded into Google BigQuery for analysis.
-   * Exports and imports are performed asynchronously. An Operation resource is
+   * - Exported data can also be loaded into Google BigQuery for analysis.
+   * - Exports and imports are performed asynchronously. An Operation resource is
    * created for each export/import. The state (including any errors encountered)
    * of the export/import may be queried via the Operation resource.
-   * # Index
-   * The index service manages Cloud Datastore composite indexes.
-   * Index creation and deletion are performed asynchronously.
+   * Index Service:
+   * - The index service manages Cloud Datastore composite indexes.
+   * - Index creation and deletion are performed asynchronously.
    * An Operation resource is created for each such asynchronous operation.
    * The state of the operation (including any errors encountered)
    * may be queried via the Operation resource.
-   * # Operation
-   * The Operations collection provides a record of actions performed for the
+   * Operation Service:
+   * - The Operations collection provides a record of actions performed for the
    * specified project (including any operations in progress). Operations are not
    * created directly but through calls on other collections or resources.
-   * An operation that is not yet done may be cancelled. The request to cancel is
-   * asynchronous and the operation may continue to run for some time after the
+   * - An operation that is not yet done may be cancelled. The request to cancel
+   * is asynchronous and the operation may continue to run for some time after the
    * request to cancel is made.
-   * An operation that is done may be deleted so that it is no longer listed as
+   * - An operation that is done may be deleted so that it is no longer listed as
    * part of the Operation collection.
-   * ListOperations returns all pending operations, but not completed operations.
-   * Operations are created by service DatastoreAdmin,
-   * but are accessed via service google.longrunning.Operations.
+   * - ListOperations returns all pending operations, but not completed
+   * operations.
+   * - Operations are created by service DatastoreAdmin, but are accessed via
+   * service google.longrunning.Operations.
    * 
*/ public static final class DatastoreAdminBlockingStub @@ -881,9 +868,9 @@ public com.google.longrunning.Operation importEntities( *
      * 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.
+     * 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.
      * 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
@@ -907,7 +894,8 @@ public com.google.longrunning.Operation createIndex(
      * 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.
+     * 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
@@ -955,44 +943,41 @@ public com.google.datastore.admin.v1.ListIndexesResponse listIndexes(
    * 
    * Google Cloud Datastore Admin API
    * The Datastore Admin API provides several admin services for Cloud Datastore.
-   * -----------------------------------------------------------------------------
-   * ## Concepts
-   * Project, namespace, kind, and entity as defined in the Google Cloud Datastore
-   * API.
+   * Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
+   * Datastore API.
    * Operation: An Operation represents work being performed in the background.
    * EntityFilter: Allows specifying a subset of entities in a project. This is
    * specified as a combination of kinds and namespaces (either or both of which
    * may be all).
-   * -----------------------------------------------------------------------------
-   * ## Services
-   * # Export/Import
-   * The Export/Import service provides the ability to copy all or a subset of
+   * Export/Import Service:
+   * - The Export/Import service provides the ability to copy all or a subset of
    * entities to/from Google Cloud Storage.
-   * Exported data may be imported into Cloud Datastore for any Google Cloud
+   * - Exported data may be imported into Cloud Datastore for any Google Cloud
    * Platform project. It is not restricted to the export source project. It is
    * possible to export from one project and then import into another.
-   * Exported data can also be loaded into Google BigQuery for analysis.
-   * Exports and imports are performed asynchronously. An Operation resource is
+   * - Exported data can also be loaded into Google BigQuery for analysis.
+   * - Exports and imports are performed asynchronously. An Operation resource is
    * created for each export/import. The state (including any errors encountered)
    * of the export/import may be queried via the Operation resource.
-   * # Index
-   * The index service manages Cloud Datastore composite indexes.
-   * Index creation and deletion are performed asynchronously.
+   * Index Service:
+   * - The index service manages Cloud Datastore composite indexes.
+   * - Index creation and deletion are performed asynchronously.
    * An Operation resource is created for each such asynchronous operation.
    * The state of the operation (including any errors encountered)
    * may be queried via the Operation resource.
-   * # Operation
-   * The Operations collection provides a record of actions performed for the
+   * Operation Service:
+   * - The Operations collection provides a record of actions performed for the
    * specified project (including any operations in progress). Operations are not
    * created directly but through calls on other collections or resources.
-   * An operation that is not yet done may be cancelled. The request to cancel is
-   * asynchronous and the operation may continue to run for some time after the
+   * - An operation that is not yet done may be cancelled. The request to cancel
+   * is asynchronous and the operation may continue to run for some time after the
    * request to cancel is made.
-   * An operation that is done may be deleted so that it is no longer listed as
+   * - An operation that is done may be deleted so that it is no longer listed as
    * part of the Operation collection.
-   * ListOperations returns all pending operations, but not completed operations.
-   * Operations are created by service DatastoreAdmin,
-   * but are accessed via service google.longrunning.Operations.
+   * - ListOperations returns all pending operations, but not completed
+   * operations.
+   * - Operations are created by service DatastoreAdmin, but are accessed via
+   * service google.longrunning.Operations.
    * 
*/ public static final class DatastoreAdminFutureStub @@ -1050,9 +1035,9 @@ protected DatastoreAdminFutureStub build( *
      * 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.
+     * 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.
      * 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
@@ -1076,7 +1061,8 @@ protected DatastoreAdminFutureStub build(
      * 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.
+     * 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
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java
index 7e81988e7..57d21e691 100644
--- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java
+++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequest.java
@@ -299,8 +299,8 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil
    *
    * The resulting files will be nested deeper than the specified URL prefix.
    * The final output URL will be provided in the
-   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-   * value should be used for subsequent ImportEntities operations.
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field. That value should be used for subsequent ImportEntities operations.
    *
    * By nesting the data files deeper, the same Cloud Storage bucket can be used
    * in multiple ExportEntities operations without conflict.
@@ -339,8 +339,8 @@ public java.lang.String getOutputUrlPrefix() {
    *
    * The resulting files will be nested deeper than the specified URL prefix.
    * The final output URL will be provided in the
-   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-   * value should be used for subsequent ImportEntities operations.
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field. That value should be used for subsequent ImportEntities operations.
    *
    * By nesting the data files deeper, the same Cloud Storage bucket can be used
    * in multiple ExportEntities operations without conflict.
@@ -1289,8 +1289,8 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil
      *
      * The resulting files will be nested deeper than the specified URL prefix.
      * The final output URL will be provided in the
-     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-     * value should be used for subsequent ImportEntities operations.
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field. That value should be used for subsequent ImportEntities operations.
      *
      * By nesting the data files deeper, the same Cloud Storage bucket can be used
      * in multiple ExportEntities operations without conflict.
@@ -1328,8 +1328,8 @@ public java.lang.String getOutputUrlPrefix() {
      *
      * The resulting files will be nested deeper than the specified URL prefix.
      * The final output URL will be provided in the
-     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-     * value should be used for subsequent ImportEntities operations.
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field. That value should be used for subsequent ImportEntities operations.
      *
      * By nesting the data files deeper, the same Cloud Storage bucket can be used
      * in multiple ExportEntities operations without conflict.
@@ -1367,8 +1367,8 @@ public com.google.protobuf.ByteString getOutputUrlPrefixBytes() {
      *
      * The resulting files will be nested deeper than the specified URL prefix.
      * The final output URL will be provided in the
-     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-     * value should be used for subsequent ImportEntities operations.
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field. That value should be used for subsequent ImportEntities operations.
      *
      * By nesting the data files deeper, the same Cloud Storage bucket can be used
      * in multiple ExportEntities operations without conflict.
@@ -1405,8 +1405,8 @@ public Builder setOutputUrlPrefix(java.lang.String value) {
      *
      * The resulting files will be nested deeper than the specified URL prefix.
      * The final output URL will be provided in the
-     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-     * value should be used for subsequent ImportEntities operations.
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field. That value should be used for subsequent ImportEntities operations.
      *
      * By nesting the data files deeper, the same Cloud Storage bucket can be used
      * in multiple ExportEntities operations without conflict.
@@ -1439,8 +1439,8 @@ public Builder clearOutputUrlPrefix() {
      *
      * The resulting files will be nested deeper than the specified URL prefix.
      * The final output URL will be provided in the
-     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-     * value should be used for subsequent ImportEntities operations.
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field. That value should be used for subsequent ImportEntities operations.
      *
      * By nesting the data files deeper, the same Cloud Storage bucket can be used
      * in multiple ExportEntities operations without conflict.
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java
index d652ea7a7..c542b562c 100644
--- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java
+++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ExportEntitiesRequestOrBuilder.java
@@ -158,8 +158,8 @@ java.lang.String getLabelsOrDefault(
    *
    * The resulting files will be nested deeper than the specified URL prefix.
    * The final output URL will be provided in the
-   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-   * value should be used for subsequent ImportEntities operations.
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field. That value should be used for subsequent ImportEntities operations.
    *
    * By nesting the data files deeper, the same Cloud Storage bucket can be used
    * in multiple ExportEntities operations without conflict.
@@ -187,8 +187,8 @@ java.lang.String getLabelsOrDefault(
    *
    * The resulting files will be nested deeper than the specified URL prefix.
    * The final output URL will be provided in the
-   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
-   * value should be used for subsequent ImportEntities operations.
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field. That value should be used for subsequent ImportEntities operations.
    *
    * By nesting the data files deeper, the same Cloud Storage bucket can be used
    * in multiple ExportEntities operations without conflict.
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java
index c7f1e40e8..84cd35a26 100644
--- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java
+++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/GetIndexRequest.java
@@ -22,7 +22,8 @@
  *
  *
  * 
- * The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex].
+ * The request for
+ * [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex].
  * 
* * Protobuf type {@code google.datastore.admin.v1.GetIndexRequest} @@ -337,7 +338,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * *
-   * The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex].
+   * The request for
+   * [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex].
    * 
* * Protobuf type {@code google.datastore.admin.v1.GetIndexRequest} diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java index 1b6d92aba..0d1a82b8f 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadata.java @@ -271,7 +271,9 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil * *
    * The location of the import metadata file. This will be the same value as
-   * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+   * the
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field.
    * 
* * string input_url = 5; @@ -295,7 +297,9 @@ public java.lang.String getInputUrl() { * *
    * The location of the import metadata file. This will be the same value as
-   * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+   * the
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field.
    * 
* * string input_url = 5; @@ -1526,7 +1530,9 @@ public com.google.datastore.admin.v1.EntityFilterOrBuilder getEntityFilterOrBuil * *
      * The location of the import metadata file. This will be the same value as
-     * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+     * the
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field.
      * 
* * string input_url = 5; @@ -1549,7 +1555,9 @@ public java.lang.String getInputUrl() { * *
      * The location of the import metadata file. This will be the same value as
-     * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+     * the
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field.
      * 
* * string input_url = 5; @@ -1572,7 +1580,9 @@ public com.google.protobuf.ByteString getInputUrlBytes() { * *
      * The location of the import metadata file. This will be the same value as
-     * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+     * the
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field.
      * 
* * string input_url = 5; @@ -1594,7 +1604,9 @@ public Builder setInputUrl(java.lang.String value) { * *
      * The location of the import metadata file. This will be the same value as
-     * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+     * the
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field.
      * 
* * string input_url = 5; @@ -1612,7 +1624,9 @@ public Builder clearInputUrl() { * *
      * The location of the import metadata file. This will be the same value as
-     * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+     * the
+     * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+     * field.
      * 
* * string input_url = 5; diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java index 8dc5147ec..8dbf67421 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesMetadataOrBuilder.java @@ -168,7 +168,9 @@ public interface ImportEntitiesMetadataOrBuilder * *
    * The location of the import metadata file. This will be the same value as
-   * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+   * the
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field.
    * 
* * string input_url = 5; @@ -181,7 +183,9 @@ public interface ImportEntitiesMetadataOrBuilder * *
    * The location of the import metadata file. This will be the same value as
-   * the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
+   * the
+   * [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
+   * field.
    * 
* * string input_url = 5; diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java index 9ca45ea1c..ee9b39b56 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequest.java @@ -236,8 +236,9 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) { * * *
-   * Required. The full resource URL of the external storage location. Currently, only
-   * Google Cloud Storage is supported. So input_url should be of the form:
+   * Required. The full resource URL of the external storage location.
+   * Currently, only Google Cloud Storage is supported. So input_url should be
+   * of the form:
    * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
    * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
    * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -271,8 +272,9 @@ public java.lang.String getInputUrl() {
    *
    *
    * 
-   * Required. The full resource URL of the external storage location. Currently, only
-   * Google Cloud Storage is supported. So input_url should be of the form:
+   * Required. The full resource URL of the external storage location.
+   * Currently, only Google Cloud Storage is supported. So input_url should be
+   * of the form:
    * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
    * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
    * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -1091,8 +1093,9 @@ public Builder putAllLabels(java.util.Map va
      *
      *
      * 
-     * Required. The full resource URL of the external storage location. Currently, only
-     * Google Cloud Storage is supported. So input_url should be of the form:
+     * Required. The full resource URL of the external storage location.
+     * Currently, only Google Cloud Storage is supported. So input_url should be
+     * of the form:
      * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
      * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
      * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -1125,8 +1128,9 @@ public java.lang.String getInputUrl() {
      *
      *
      * 
-     * Required. The full resource URL of the external storage location. Currently, only
-     * Google Cloud Storage is supported. So input_url should be of the form:
+     * Required. The full resource URL of the external storage location.
+     * Currently, only Google Cloud Storage is supported. So input_url should be
+     * of the form:
      * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
      * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
      * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -1159,8 +1163,9 @@ public com.google.protobuf.ByteString getInputUrlBytes() {
      *
      *
      * 
-     * Required. The full resource URL of the external storage location. Currently, only
-     * Google Cloud Storage is supported. So input_url should be of the form:
+     * Required. The full resource URL of the external storage location.
+     * Currently, only Google Cloud Storage is supported. So input_url should be
+     * of the form:
      * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
      * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
      * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -1192,8 +1197,9 @@ public Builder setInputUrl(java.lang.String value) {
      *
      *
      * 
-     * Required. The full resource URL of the external storage location. Currently, only
-     * Google Cloud Storage is supported. So input_url should be of the form:
+     * Required. The full resource URL of the external storage location.
+     * Currently, only Google Cloud Storage is supported. So input_url should be
+     * of the form:
      * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
      * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
      * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -1221,8 +1227,9 @@ public Builder clearInputUrl() {
      *
      *
      * 
-     * Required. The full resource URL of the external storage location. Currently, only
-     * Google Cloud Storage is supported. So input_url should be of the form:
+     * Required. The full resource URL of the external storage location.
+     * Currently, only Google Cloud Storage is supported. So input_url should be
+     * of the form:
      * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
      * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
      * an optional Cloud Storage namespace path (this is not a Cloud Datastore
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java
index 6a5004067..dcf83c997 100644
--- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java
+++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/ImportEntitiesRequestOrBuilder.java
@@ -110,8 +110,9 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Required. The full resource URL of the external storage location. Currently, only
-   * Google Cloud Storage is supported. So input_url should be of the form:
+   * Required. The full resource URL of the external storage location.
+   * Currently, only Google Cloud Storage is supported. So input_url should be
+   * of the form:
    * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
    * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
    * an optional Cloud Storage namespace path (this is not a Cloud Datastore
@@ -134,8 +135,9 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Required. The full resource URL of the external storage location. Currently, only
-   * Google Cloud Storage is supported. So input_url should be of the form:
+   * Required. The full resource URL of the external storage location.
+   * Currently, only Google Cloud Storage is supported. So input_url should be
+   * of the form:
    * `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
    * `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
    * an optional Cloud Storage namespace path (this is not a Cloud Datastore
diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java
index e03a585f4..57a41fc3e 100644
--- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java
+++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/Index.java
@@ -647,7 +647,8 @@ public interface IndexedPropertyOrBuilder
      *
      *
      * 
-     * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+     * Required. The indexed property's direction.  Must not be
+     * DIRECTION_UNSPECIFIED.
      * 
* * @@ -661,7 +662,8 @@ public interface IndexedPropertyOrBuilder * * *
-     * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+     * Required. The indexed property's direction.  Must not be
+     * DIRECTION_UNSPECIFIED.
      * 
* * @@ -774,7 +776,8 @@ public com.google.protobuf.ByteString getNameBytes() { * * *
-     * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+     * Required. The indexed property's direction.  Must not be
+     * DIRECTION_UNSPECIFIED.
      * 
* * @@ -791,7 +794,8 @@ public int getDirectionValue() { * * *
-     * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+     * Required. The indexed property's direction.  Must not be
+     * DIRECTION_UNSPECIFIED.
      * 
* * @@ -1289,7 +1293,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) { * * *
-       * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+       * Required. The indexed property's direction.  Must not be
+       * DIRECTION_UNSPECIFIED.
        * 
* * @@ -1306,7 +1311,8 @@ public int getDirectionValue() { * * *
-       * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+       * Required. The indexed property's direction.  Must not be
+       * DIRECTION_UNSPECIFIED.
        * 
* * @@ -1326,7 +1332,8 @@ public Builder setDirectionValue(int value) { * * *
-       * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+       * Required. The indexed property's direction.  Must not be
+       * DIRECTION_UNSPECIFIED.
        * 
* * @@ -1345,7 +1352,8 @@ public com.google.datastore.admin.v1.Index.Direction getDirection() { * * *
-       * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+       * Required. The indexed property's direction.  Must not be
+       * DIRECTION_UNSPECIFIED.
        * 
* * @@ -1368,7 +1376,8 @@ public Builder setDirection(com.google.datastore.admin.v1.Index.Direction value) * * *
-       * Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+       * Required. The indexed property's direction.  Must not be
+       * DIRECTION_UNSPECIFIED.
        * 
* * @@ -1607,7 +1616,8 @@ public com.google.protobuf.ByteString getKindBytes() { * * *
-   * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+   * Required. The index's ancestor mode.  Must not be
+   * ANCESTOR_MODE_UNSPECIFIED.
    * 
* * @@ -1624,7 +1634,8 @@ public int getAncestorValue() { * * *
-   * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+   * Required. The index's ancestor mode.  Must not be
+   * ANCESTOR_MODE_UNSPECIFIED.
    * 
* * @@ -1649,6 +1660,10 @@ public com.google.datastore.admin.v1.Index.AncestorMode getAncestor() { * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -1664,6 +1679,10 @@ public java.util.List getPr * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -1680,6 +1699,10 @@ public java.util.List getPr * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -1695,6 +1718,10 @@ public int getPropertiesCount() { * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -1710,6 +1737,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty getProperties(int ind * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -2588,7 +2619,8 @@ public Builder setKindBytes(com.google.protobuf.ByteString value) { * * *
-     * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+     * Required. The index's ancestor mode.  Must not be
+     * ANCESTOR_MODE_UNSPECIFIED.
      * 
* * @@ -2605,7 +2637,8 @@ public int getAncestorValue() { * * *
-     * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+     * Required. The index's ancestor mode.  Must not be
+     * ANCESTOR_MODE_UNSPECIFIED.
      * 
* * @@ -2625,7 +2658,8 @@ public Builder setAncestorValue(int value) { * * *
-     * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+     * Required. The index's ancestor mode.  Must not be
+     * ANCESTOR_MODE_UNSPECIFIED.
      * 
* * @@ -2646,7 +2680,8 @@ public com.google.datastore.admin.v1.Index.AncestorMode getAncestor() { * * *
-     * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+     * Required. The index's ancestor mode.  Must not be
+     * ANCESTOR_MODE_UNSPECIFIED.
      * 
* * @@ -2669,7 +2704,8 @@ public Builder setAncestor(com.google.datastore.admin.v1.Index.AncestorMode valu * * *
-     * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+     * Required. The index's ancestor mode.  Must not be
+     * ANCESTOR_MODE_UNSPECIFIED.
      * 
* * @@ -2708,6 +2744,10 @@ private void ensurePropertiesIsMutable() { * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2726,6 +2766,10 @@ public java.util.List getPr * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2744,6 +2788,10 @@ public int getPropertiesCount() { * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2762,6 +2810,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty getProperties(int ind * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2787,6 +2839,10 @@ public Builder setProperties( * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2809,6 +2865,10 @@ public Builder setProperties( * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2833,6 +2893,10 @@ public Builder addProperties(com.google.datastore.admin.v1.Index.IndexedProperty * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2858,6 +2922,10 @@ public Builder addProperties( * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2880,6 +2948,10 @@ public Builder addProperties( * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2902,6 +2974,10 @@ public Builder addProperties( * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2924,6 +3000,10 @@ public Builder addAllProperties( * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2945,6 +3025,10 @@ public Builder clearProperties() { * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2966,6 +3050,10 @@ public Builder removeProperties(int index) { * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -2981,6 +3069,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty.Builder getProperties * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -3000,6 +3092,10 @@ public com.google.datastore.admin.v1.Index.IndexedPropertyOrBuilder getPropertie * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -3019,6 +3115,10 @@ public com.google.datastore.admin.v1.Index.IndexedPropertyOrBuilder getPropertie * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -3034,6 +3134,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty.Builder addProperties * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * @@ -3051,6 +3155,10 @@ public com.google.datastore.admin.v1.Index.IndexedProperty.Builder addProperties * *
      * Required. An ordered sequence of property names and their index attributes.
+     *
+     * Requires:
+     *
+     * * A maximum of 100 properties.
      * 
* * diff --git a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java index 27e384765..6445c073d 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java +++ b/proto-google-cloud-datastore-admin-v1/src/main/java/com/google/datastore/admin/v1/IndexOrBuilder.java @@ -102,7 +102,8 @@ public interface IndexOrBuilder * * *
-   * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+   * Required. The index's ancestor mode.  Must not be
+   * ANCESTOR_MODE_UNSPECIFIED.
    * 
* * @@ -116,7 +117,8 @@ public interface IndexOrBuilder * * *
-   * Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+   * Required. The index's ancestor mode.  Must not be
+   * ANCESTOR_MODE_UNSPECIFIED.
    * 
* * @@ -132,6 +134,10 @@ public interface IndexOrBuilder * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -144,6 +150,10 @@ public interface IndexOrBuilder * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -156,6 +166,10 @@ public interface IndexOrBuilder * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -168,6 +182,10 @@ public interface IndexOrBuilder * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * @@ -181,6 +199,10 @@ public interface IndexOrBuilder * *
    * Required. An ordered sequence of property names and their index attributes.
+   *
+   * Requires:
+   *
+   * * A maximum of 100 properties.
    * 
* * diff --git a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto index 744d97df7..79ca3df68 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto +++ b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/datastore_admin.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -34,14 +34,10 @@ option ruby_package = "Google::Cloud::Datastore::Admin::V1"; // Google Cloud Datastore Admin API // -// // The Datastore Admin API provides several admin services for Cloud Datastore. // -// ----------------------------------------------------------------------------- -// ## Concepts -// -// Project, namespace, kind, and entity as defined in the Google Cloud Datastore -// API. +// Concepts: Project, namespace, kind, and entity as defined in the Google Cloud +// Datastore API. // // Operation: An Operation represents work being performed in the background. // @@ -49,50 +45,40 @@ option ruby_package = "Google::Cloud::Datastore::Admin::V1"; // specified as a combination of kinds and namespaces (either or both of which // may be all). // -// ----------------------------------------------------------------------------- -// ## Services -// -// # Export/Import +// Export/Import Service: // -// The Export/Import service provides the ability to copy all or a subset of +// - The Export/Import service provides the ability to copy all or a subset of // entities to/from Google Cloud Storage. -// -// Exported data may be imported into Cloud Datastore for any Google Cloud +// - Exported data may be imported into Cloud Datastore for any Google Cloud // Platform project. It is not restricted to the export source project. It is // possible to export from one project and then import into another. -// -// Exported data can also be loaded into Google BigQuery for analysis. -// -// Exports and imports are performed asynchronously. An Operation resource is +// - Exported data can also be loaded into Google BigQuery for analysis. +// - Exports and imports are performed asynchronously. An Operation resource is // created for each export/import. The state (including any errors encountered) // of the export/import may be queried via the Operation resource. // -// # Index +// Index Service: // -// The index service manages Cloud Datastore composite indexes. -// -// Index creation and deletion are performed asynchronously. +// - The index service manages Cloud Datastore composite indexes. +// - Index creation and deletion are performed asynchronously. // An Operation resource is created for each such asynchronous operation. // The state of the operation (including any errors encountered) // may be queried via the Operation resource. // -// # Operation +// Operation Service: // -// The Operations collection provides a record of actions performed for the +// - The Operations collection provides a record of actions performed for the // specified project (including any operations in progress). Operations are not // created directly but through calls on other collections or resources. -// -// An operation that is not yet done may be cancelled. The request to cancel is -// asynchronous and the operation may continue to run for some time after the +// - An operation that is not yet done may be cancelled. The request to cancel +// is asynchronous and the operation may continue to run for some time after the // request to cancel is made. -// -// An operation that is done may be deleted so that it is no longer listed as +// - An operation that is done may be deleted so that it is no longer listed as // part of the Operation collection. -// -// ListOperations returns all pending operations, but not completed operations. -// -// Operations are created by service DatastoreAdmin, -// but are accessed via service google.longrunning.Operations. +// - ListOperations returns all pending operations, but not completed +// operations. +// - Operations are created by service DatastoreAdmin, but are accessed via +// service google.longrunning.Operations. service DatastoreAdmin { option (google.api.default_host) = "datastore.googleapis.com"; option (google.api.oauth_scopes) = @@ -107,12 +93,14 @@ service DatastoreAdmin { // 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. - rpc ExportEntities(ExportEntitiesRequest) returns (google.longrunning.Operation) { + rpc ExportEntities(ExportEntitiesRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/projects/{project_id}:export" body: "*" }; - option (google.api.method_signature) = "project_id,labels,entity_filter,output_url_prefix"; + option (google.api.method_signature) = + "project_id,labels,entity_filter,output_url_prefix"; option (google.longrunning.operation_info) = { response_type: "ExportEntitiesResponse" metadata_type: "ExportEntitiesMetadata" @@ -124,12 +112,14 @@ service DatastoreAdmin { // 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. - rpc ImportEntities(ImportEntitiesRequest) returns (google.longrunning.Operation) { + rpc ImportEntities(ImportEntitiesRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/projects/{project_id}:import" body: "*" }; - option (google.api.method_signature) = "project_id,labels,input_url,entity_filter"; + option (google.api.method_signature) = + "project_id,labels,input_url,entity_filter"; option (google.longrunning.operation_info) = { response_type: "google.protobuf.Empty" metadata_type: "ImportEntitiesMetadata" @@ -138,9 +128,9 @@ service DatastoreAdmin { // 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. + // 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. // // 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 @@ -165,7 +155,8 @@ service DatastoreAdmin { // 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. + // 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 @@ -283,8 +274,8 @@ message ExportEntitiesRequest { // // The resulting files will be nested deeper than the specified URL prefix. // The final output URL will be provided in the - // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That - // value should be used for subsequent ImportEntities operations. + // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + // field. That value should be used for subsequent ImportEntities operations. // // By nesting the data files deeper, the same Cloud Storage bucket can be used // in multiple ExportEntities operations without conflict. @@ -300,8 +291,9 @@ message ImportEntitiesRequest { // Client-assigned labels. map labels = 2; - // Required. The full resource URL of the external storage location. Currently, only - // Google Cloud Storage is supported. So input_url should be of the form: + // Required. The full resource URL of the external storage location. + // Currently, only Google Cloud Storage is supported. So input_url should be + // of the form: // `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where // `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is // an optional Cloud Storage namespace path (this is not a Cloud Datastore @@ -369,7 +361,9 @@ message ImportEntitiesMetadata { EntityFilter entity_filter = 4; // The location of the import metadata file. This will be the same value as - // the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. + // the + // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] + // field. string input_url = 5; } @@ -427,7 +421,8 @@ message DeleteIndexRequest { string index_id = 3; } -// The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. +// The request for +// [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex]. message GetIndexRequest { // Project ID against which to make the request. string project_id = 1; diff --git a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto index 4eeffc7e4..60bb5af5f 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto +++ b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/index.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -60,7 +60,8 @@ message Index { // Required. The property name to index. string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The indexed property's direction. Must not be DIRECTION_UNSPECIFIED. + // Required. The indexed property's direction. Must not be + // DIRECTION_UNSPECIFIED. Direction direction = 2 [(google.api.field_behavior) = REQUIRED]; } @@ -104,11 +105,17 @@ message Index { // Required. The entity kind to which this index applies. string kind = 4 [(google.api.field_behavior) = REQUIRED]; - // Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. + // Required. The index's ancestor mode. Must not be + // ANCESTOR_MODE_UNSPECIFIED. AncestorMode ancestor = 5 [(google.api.field_behavior) = REQUIRED]; // Required. An ordered sequence of property names and their index attributes. - repeated IndexedProperty properties = 6 [(google.api.field_behavior) = REQUIRED]; + // + // Requires: + // + // * A maximum of 100 properties. + repeated IndexedProperty properties = 6 + [(google.api.field_behavior) = REQUIRED]; // Output only. The state of the index. State state = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; diff --git a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto index f47cb70e1..e5f7477da 100644 --- a/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto +++ b/proto-google-cloud-datastore-admin-v1/src/main/proto/google/datastore/admin/v1/migration.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License.