diff --git a/google/cloud/datastore_admin/py.typed b/google/cloud/datastore_admin/py.typed index dc48a544..e82a9319 100644 --- a/google/cloud/datastore_admin/py.typed +++ b/google/cloud/datastore_admin/py.typed @@ -1,2 +1,2 @@ # Marker file for PEP 561. -# The google-cloud-datastore-admin package uses inline types. +# The google-cloud-datastore package uses inline types. diff --git a/google/cloud/datastore_admin_v1/py.typed b/google/cloud/datastore_admin_v1/py.typed index dc48a544..e82a9319 100644 --- a/google/cloud/datastore_admin_v1/py.typed +++ b/google/cloud/datastore_admin_v1/py.typed @@ -1,2 +1,2 @@ # Marker file for PEP 561. -# The google-cloud-datastore-admin package uses inline types. +# The google-cloud-datastore package uses inline types. diff --git a/google/cloud/datastore_admin_v1/services/datastore_admin/async_client.py b/google/cloud/datastore_admin_v1/services/datastore_admin/async_client.py index 2dd8c988..fb112508 100644 --- a/google/cloud/datastore_admin_v1/services/datastore_admin/async_client.py +++ b/google/cloud/datastore_admin_v1/services/datastore_admin/async_client.py @@ -58,11 +58,8 @@ class DatastoreAdminAsyncClient: """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. @@ -70,49 +67,45 @@ class DatastoreAdminAsyncClient: 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. - 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. 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 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. + 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 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 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 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 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. """ _client: DatastoreAdminClient diff --git a/google/cloud/datastore_admin_v1/services/datastore_admin/client.py b/google/cloud/datastore_admin_v1/services/datastore_admin/client.py index 9d2ee237..fabdcecf 100644 --- a/google/cloud/datastore_admin_v1/services/datastore_admin/client.py +++ b/google/cloud/datastore_admin_v1/services/datastore_admin/client.py @@ -100,58 +100,54 @@ class DatastoreAdminClient(metaclass=DatastoreAdminClientMeta): """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 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 - - 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 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. + + 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 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 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 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 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. """ @staticmethod diff --git a/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc.py b/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc.py index 79815b25..24ca17c7 100644 --- a/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc.py +++ b/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc.py @@ -38,11 +38,8 @@ class DatastoreAdminGrpcTransport(DatastoreAdminTransport): 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. @@ -50,49 +47,45 @@ class DatastoreAdminGrpcTransport(DatastoreAdminTransport): 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. - 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. 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 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. + 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 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 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 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 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 defines the same methods as the primary client, so the primary client can load the underlying transport implementation diff --git a/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc_asyncio.py b/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc_asyncio.py index 3f1d638e..9c37e074 100644 --- a/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc_asyncio.py +++ b/google/cloud/datastore_admin_v1/services/datastore_admin/transports/grpc_asyncio.py @@ -39,11 +39,8 @@ class DatastoreAdminGrpcAsyncIOTransport(DatastoreAdminTransport): 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. @@ -51,49 +48,45 @@ class DatastoreAdminGrpcAsyncIOTransport(DatastoreAdminTransport): 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. - 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. 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 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. + 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 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 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 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 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 defines the same methods as the primary client, so the primary client can load the underlying transport implementation diff --git a/google/cloud/datastore_admin_v1/services/datastore_admin/transports/rest.py b/google/cloud/datastore_admin_v1/services/datastore_admin/transports/rest.py index eb0f59ef..ee7f7dc0 100644 --- a/google/cloud/datastore_admin_v1/services/datastore_admin/transports/rest.py +++ b/google/cloud/datastore_admin_v1/services/datastore_admin/transports/rest.py @@ -365,11 +365,8 @@ class DatastoreAdminRestTransport(DatastoreAdminTransport): 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. @@ -377,49 +374,45 @@ class DatastoreAdminRestTransport(DatastoreAdminTransport): 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. - 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. 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 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. + 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 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 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 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 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 defines the same methods as the primary client, so the primary client can load the underlying transport implementation diff --git a/google/cloud/datastore_admin_v1/types/index.py b/google/cloud/datastore_admin_v1/types/index.py index c70a13db..dfb44417 100644 --- a/google/cloud/datastore_admin_v1/types/index.py +++ b/google/cloud/datastore_admin_v1/types/index.py @@ -43,8 +43,12 @@ class Index(proto.Message): Required. The index's ancestor mode. Must not be ANCESTOR_MODE_UNSPECIFIED. properties (MutableSequence[google.cloud.datastore_admin_v1.types.Index.IndexedProperty]): - Required. An ordered sequence of property - names and their index attributes. + Required. An ordered sequence of property names and their + index attributes. + + Requires: + + - A maximum of 100 properties. state (google.cloud.datastore_admin_v1.types.Index.State): Output only. The state of the index. """ diff --git a/google/cloud/datastore_v1/types/datastore.py b/google/cloud/datastore_v1/types/datastore.py index b04b73c5..be824c96 100644 --- a/google/cloud/datastore_v1/types/datastore.py +++ b/google/cloud/datastore_v1/types/datastore.py @@ -859,9 +859,12 @@ class ReadOptions(proto.Message): This field is a member of `oneof`_ ``consistency_type``. read_time (google.protobuf.timestamp_pb2.Timestamp): Reads entities as they were at the given - time. This may not be older than 270 seconds. - This value is only supported for Cloud Firestore - in Datastore mode. + time. This value is only supported for Cloud + Firestore in Datastore mode. + This must be a microsecond precision timestamp + within the past one hour, or if Point-in-Time + Recovery is enabled, can additionally be a whole + minute timestamp within the past 7 days. This field is a member of `oneof`_ ``consistency_type``. """ @@ -954,7 +957,10 @@ class ReadOnly(proto.Message): Attributes: read_time (google.protobuf.timestamp_pb2.Timestamp): Reads entities at the given time. - This may not be older than 60 seconds. + This must be a microsecond precision timestamp + within the past one hour, or if Point-in-Time + Recovery is enabled, can additionally be a whole + minute timestamp within the past 7 days. """ read_time: timestamp_pb2.Timestamp = proto.Field( diff --git a/google/cloud/datastore_v1/types/entity.py b/google/cloud/datastore_v1/types/entity.py index 4ab5bc6d..dc3374e4 100644 --- a/google/cloud/datastore_v1/types/entity.py +++ b/google/cloud/datastore_v1/types/entity.py @@ -265,8 +265,8 @@ class Value(proto.Message): entity_value (google.cloud.datastore_v1.types.Entity): An entity value. - May have no key. - - May have a key with an incomplete key path. - - May have a reserved/read-only key. + - May have a key with an incomplete key path. + - May have a reserved/read-only key. This field is a member of `oneof`_ ``value_type``. array_value (google.cloud.datastore_v1.types.ArrayValue): diff --git a/google/cloud/datastore_v1/types/query.py b/google/cloud/datastore_v1/types/query.py index 5fb51d46..67a1c58d 100644 --- a/google/cloud/datastore_v1/types/query.py +++ b/google/cloud/datastore_v1/types/query.py @@ -246,12 +246,25 @@ class AggregationQuery(proto.Message): class Aggregation(proto.Message): r"""Defines an aggregation that produces a single result. + This message has `oneof`_ fields (mutually exclusive fields). + For each oneof, at most one member field can be set at the same time. + Setting any member of the oneof automatically clears all other + members. + .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields Attributes: count (google.cloud.datastore_v1.types.AggregationQuery.Aggregation.Count): Count aggregator. + This field is a member of `oneof`_ ``operator``. + sum (google.cloud.datastore_v1.types.AggregationQuery.Aggregation.Sum): + Sum aggregator. + + This field is a member of `oneof`_ ``operator``. + avg (google.cloud.datastore_v1.types.AggregationQuery.Aggregation.Avg): + Average aggregator. + This field is a member of `oneof`_ ``operator``. alias (str): Optional. Optional name of the property to store the result @@ -328,12 +341,83 @@ class Count(proto.Message): message=wrappers_pb2.Int64Value, ) + class Sum(proto.Message): + r"""Sum of the values of the requested property. + + - Only numeric values will be aggregated. All non-numeric values + including ``NULL`` are skipped. + + - If the aggregated values contain ``NaN``, returns ``NaN``. + Infinity math follows IEEE-754 standards. + + - If the aggregated value set is empty, returns 0. + + - Returns a 64-bit integer if all aggregated numbers are integers + and the sum result does not overflow. Otherwise, the result is + returned as a double. Note that even if all the aggregated values + are integers, the result is returned as a double if it cannot fit + within a 64-bit signed integer. When this occurs, the returned + value will lose precision. + + - When underflow occurs, floating-point aggregation is + non-deterministic. This means that running the same query + repeatedly without any changes to the underlying values could + produce slightly different results each time. In those cases, + values should be stored as integers over floating-point numbers. + + Attributes: + property (google.cloud.datastore_v1.types.PropertyReference): + The property to aggregate on. + """ + + property: "PropertyReference" = proto.Field( + proto.MESSAGE, + number=1, + message="PropertyReference", + ) + + class Avg(proto.Message): + r"""Average of the values of the requested property. + + - Only numeric values will be aggregated. All non-numeric values + including ``NULL`` are skipped. + + - If the aggregated values contain ``NaN``, returns ``NaN``. + Infinity math follows IEEE-754 standards. + + - If the aggregated value set is empty, returns ``NULL``. + + - Always returns the result as a double. + + Attributes: + property (google.cloud.datastore_v1.types.PropertyReference): + The property to aggregate on. + """ + + property: "PropertyReference" = proto.Field( + proto.MESSAGE, + number=1, + message="PropertyReference", + ) + count: "AggregationQuery.Aggregation.Count" = proto.Field( proto.MESSAGE, number=1, oneof="operator", message="AggregationQuery.Aggregation.Count", ) + sum: "AggregationQuery.Aggregation.Sum" = proto.Field( + proto.MESSAGE, + number=2, + oneof="operator", + message="AggregationQuery.Aggregation.Sum", + ) + avg: "AggregationQuery.Aggregation.Avg" = proto.Field( + proto.MESSAGE, + number=3, + oneof="operator", + message="AggregationQuery.Aggregation.Avg", + ) alias: str = proto.Field( proto.STRING, number=7, @@ -565,9 +649,9 @@ class Operator(proto.Enum): Requires: - - That ``value`` is a non-empty ``ArrayValue`` with at most - 10 values. - - No other ``IN`` or ``NOT_IN`` is in the same query. + - That ``value`` is a non-empty ``ArrayValue``, subject to + disjunction limits. + - No ``NOT_IN`` is in the same query. NOT_EQUAL (9): The given ``property`` is not equal to the given ``value``. @@ -583,7 +667,8 @@ class Operator(proto.Enum): Requires: - That ``value`` is an entity key. - - No other ``HAS_ANCESTOR`` is in the same query. + - All evaluated disjunctions must have the same + ``HAS_ANCESTOR`` filter. NOT_IN (13): The value of the ``property`` is not in the given array. @@ -591,8 +676,8 @@ class Operator(proto.Enum): - That ``value`` is a non-empty ``ArrayValue`` with at most 10 values. - - No other ``IN``, ``NOT_IN``, ``NOT_EQUAL`` is in the same - query. + - No other ``OR``, ``IN``, ``NOT_IN``, ``NOT_EQUAL`` is in + the same query. - That ``field`` comes first in the ``order_by``. """ OPERATOR_UNSPECIFIED = 0