google-cloud-firestore-v1 0.1.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 88a1f66c91c8a804fe6a3931f93b46861e028f5c40f9326703e6400803e94d42
4
- data.tar.gz: 04d2f7235e4e1676665893c0d8de7610c3187572c51d38189072d9cec020511b
3
+ metadata.gz: 4ebf40d668a9641ffff046faf42b210e06953c3a2f15951edde70b1869a79f60
4
+ data.tar.gz: e76cadfae696483c66ed75bc1f2cdc8fc8a19e5a179032c55d8f7ff48a9198aa
5
5
  SHA512:
6
- metadata.gz: 43c504aac61d90f40a456679b1c1490df522a73fad5f372ea6fe945c31770169ab27d90a46fc3314ec613ce1a2e14637f47de1caf7ee37cf835bdc6b7bb2dbb8
7
- data.tar.gz: e17fe3f6e2aceeab6dacc91dd51cdaf07ac2574158b2be8ba5056ab1658f4cc4aed7a27fbc2898883ad870bb22332dc738834c6f3fafbe9e1ca1f39844f08b7d
6
+ metadata.gz: c5a51239b0929bbd14b3fe30c4805cab42864b937c95cf5c535fc18f6b652ccf1a89b0b0920a63ccf845081cf4cd198577cd2ccb4f14970dfb950c4857f29bba
7
+ data.tar.gz: 7942537e54702bc27f2e9a13c1aee3fe3f5f4af86d3ddd54536f66d06b5b8fa3c6b71f3c601fd118cb00fc8b7a6f7fbf8c24b9a8d5e8236626cf982f485b64d2
@@ -75,7 +75,7 @@ module Google
75
75
  initial_delay: 0.1,
76
76
  max_delay: 60.0,
77
77
  multiplier: 1.3,
78
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
78
+ retry_codes: [14, 13, 4]
79
79
  }
80
80
 
81
81
  default_config.rpcs.list_documents.timeout = 60.0
@@ -83,7 +83,7 @@ module Google
83
83
  initial_delay: 0.1,
84
84
  max_delay: 60.0,
85
85
  multiplier: 1.3,
86
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
86
+ retry_codes: [14, 13, 4]
87
87
  }
88
88
 
89
89
  default_config.rpcs.update_document.timeout = 60.0
@@ -91,7 +91,7 @@ module Google
91
91
  initial_delay: 0.1,
92
92
  max_delay: 60.0,
93
93
  multiplier: 1.3,
94
- retry_codes: ["UNAVAILABLE"]
94
+ retry_codes: [14]
95
95
  }
96
96
 
97
97
  default_config.rpcs.delete_document.timeout = 60.0
@@ -99,7 +99,7 @@ module Google
99
99
  initial_delay: 0.1,
100
100
  max_delay: 60.0,
101
101
  multiplier: 1.3,
102
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
102
+ retry_codes: [14, 13, 4]
103
103
  }
104
104
 
105
105
  default_config.rpcs.batch_get_documents.timeout = 300.0
@@ -107,7 +107,7 @@ module Google
107
107
  initial_delay: 0.1,
108
108
  max_delay: 60.0,
109
109
  multiplier: 1.3,
110
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
110
+ retry_codes: [14, 13, 4]
111
111
  }
112
112
 
113
113
  default_config.rpcs.begin_transaction.timeout = 60.0
@@ -115,7 +115,7 @@ module Google
115
115
  initial_delay: 0.1,
116
116
  max_delay: 60.0,
117
117
  multiplier: 1.3,
118
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
118
+ retry_codes: [14, 13, 4]
119
119
  }
120
120
 
121
121
  default_config.rpcs.commit.timeout = 60.0
@@ -123,7 +123,7 @@ module Google
123
123
  initial_delay: 0.1,
124
124
  max_delay: 60.0,
125
125
  multiplier: 1.3,
126
- retry_codes: ["UNAVAILABLE"]
126
+ retry_codes: [14]
127
127
  }
128
128
 
129
129
  default_config.rpcs.rollback.timeout = 60.0
@@ -131,7 +131,7 @@ module Google
131
131
  initial_delay: 0.1,
132
132
  max_delay: 60.0,
133
133
  multiplier: 1.3,
134
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
134
+ retry_codes: [14, 13, 4]
135
135
  }
136
136
 
137
137
  default_config.rpcs.run_query.timeout = 300.0
@@ -139,7 +139,15 @@ module Google
139
139
  initial_delay: 0.1,
140
140
  max_delay: 60.0,
141
141
  multiplier: 1.3,
142
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
142
+ retry_codes: [14, 13, 4]
143
+ }
144
+
145
+ default_config.rpcs.partition_query.timeout = 300.0
146
+ default_config.rpcs.partition_query.retry_policy = {
147
+ initial_delay: 0.1,
148
+ max_delay: 60.0,
149
+ multiplier: 1.3,
150
+ retry_codes: [14, 13, 4]
143
151
  }
144
152
 
145
153
  default_config.rpcs.write.timeout = 86_400.0
@@ -149,7 +157,7 @@ module Google
149
157
  initial_delay: 0.1,
150
158
  max_delay: 60.0,
151
159
  multiplier: 1.3,
152
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
160
+ retry_codes: [14, 13, 4]
153
161
  }
154
162
 
155
163
  default_config.rpcs.list_collection_ids.timeout = 60.0
@@ -157,7 +165,7 @@ module Google
157
165
  initial_delay: 0.1,
158
166
  max_delay: 60.0,
159
167
  multiplier: 1.3,
160
- retry_codes: ["UNAVAILABLE", "INTERNAL", "DEADLINE_EXCEEDED"]
168
+ retry_codes: [14, 13, 4]
161
169
  }
162
170
 
163
171
  default_config.rpcs.batch_write.timeout = 60.0
@@ -165,7 +173,7 @@ module Google
165
173
  initial_delay: 0.1,
166
174
  max_delay: 60.0,
167
175
  multiplier: 1.3,
168
- retry_codes: ["UNAVAILABLE", "ABORTED"]
176
+ retry_codes: [14, 10]
169
177
  }
170
178
 
171
179
  default_config.rpcs.create_document.timeout = 60.0
@@ -173,7 +181,7 @@ module Google
173
181
  initial_delay: 0.1,
174
182
  max_delay: 60.0,
175
183
  multiplier: 1.3,
176
- retry_codes: ["UNAVAILABLE"]
184
+ retry_codes: [14]
177
185
  }
178
186
 
179
187
  default_config
@@ -997,12 +1005,13 @@ module Google
997
1005
  # can be specified.
998
1006
  # @param structured_query [::Google::Cloud::Firestore::V1::StructuredQuery, ::Hash]
999
1007
  # A structured query.
1000
- # Filters, order bys, limits, offsets, and start/end cursors are not
1001
- # supported.
1008
+ # Query must specify collection with all descendants and be ordered by name
1009
+ # ascending. Other filters, order bys, limits, offsets, and start/end
1010
+ # cursors are not supported.
1002
1011
  # @param partition_count [::Integer]
1003
1012
  # The desired maximum number of partition points.
1004
1013
  # The partitions may be returned across multiple pages of results.
1005
- # The number must be strictly positive. The actual number of partitions
1014
+ # The number must be positive. The actual number of partitions
1006
1015
  # returned may be fewer.
1007
1016
  #
1008
1017
  # For example, this may be set to one fewer than the number of parallel
@@ -1505,7 +1514,7 @@ module Google
1505
1514
 
1506
1515
  config_attr :endpoint, "firestore.googleapis.com", ::String
1507
1516
  config_attr :credentials, nil do |value|
1508
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1517
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1509
1518
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
1510
1519
  allowed.any? { |klass| klass === value }
1511
1520
  end
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Firestore
23
23
  module V1
24
- VERSION = "0.1.0"
24
+ VERSION = "0.2.2"
25
25
  end
26
26
  end
27
27
  end
@@ -43,36 +43,36 @@ module Google
43
43
  self.service_name = 'google.firestore.v1.Firestore'
44
44
 
45
45
  # Gets a single document.
46
- rpc :GetDocument, Google::Cloud::Firestore::V1::GetDocumentRequest, Google::Cloud::Firestore::V1::Document
46
+ rpc :GetDocument, ::Google::Cloud::Firestore::V1::GetDocumentRequest, ::Google::Cloud::Firestore::V1::Document
47
47
  # Lists documents.
48
- rpc :ListDocuments, Google::Cloud::Firestore::V1::ListDocumentsRequest, Google::Cloud::Firestore::V1::ListDocumentsResponse
48
+ rpc :ListDocuments, ::Google::Cloud::Firestore::V1::ListDocumentsRequest, ::Google::Cloud::Firestore::V1::ListDocumentsResponse
49
49
  # Updates or inserts a document.
50
- rpc :UpdateDocument, Google::Cloud::Firestore::V1::UpdateDocumentRequest, Google::Cloud::Firestore::V1::Document
50
+ rpc :UpdateDocument, ::Google::Cloud::Firestore::V1::UpdateDocumentRequest, ::Google::Cloud::Firestore::V1::Document
51
51
  # Deletes a document.
52
- rpc :DeleteDocument, Google::Cloud::Firestore::V1::DeleteDocumentRequest, Google::Protobuf::Empty
52
+ rpc :DeleteDocument, ::Google::Cloud::Firestore::V1::DeleteDocumentRequest, ::Google::Protobuf::Empty
53
53
  # Gets multiple documents.
54
54
  #
55
55
  # Documents returned by this method are not guaranteed to be returned in the
56
56
  # same order that they were requested.
57
- rpc :BatchGetDocuments, Google::Cloud::Firestore::V1::BatchGetDocumentsRequest, stream(Google::Cloud::Firestore::V1::BatchGetDocumentsResponse)
57
+ rpc :BatchGetDocuments, ::Google::Cloud::Firestore::V1::BatchGetDocumentsRequest, stream(::Google::Cloud::Firestore::V1::BatchGetDocumentsResponse)
58
58
  # Starts a new transaction.
59
- rpc :BeginTransaction, Google::Cloud::Firestore::V1::BeginTransactionRequest, Google::Cloud::Firestore::V1::BeginTransactionResponse
59
+ rpc :BeginTransaction, ::Google::Cloud::Firestore::V1::BeginTransactionRequest, ::Google::Cloud::Firestore::V1::BeginTransactionResponse
60
60
  # Commits a transaction, while optionally updating documents.
61
- rpc :Commit, Google::Cloud::Firestore::V1::CommitRequest, Google::Cloud::Firestore::V1::CommitResponse
61
+ rpc :Commit, ::Google::Cloud::Firestore::V1::CommitRequest, ::Google::Cloud::Firestore::V1::CommitResponse
62
62
  # Rolls back a transaction.
63
- rpc :Rollback, Google::Cloud::Firestore::V1::RollbackRequest, Google::Protobuf::Empty
63
+ rpc :Rollback, ::Google::Cloud::Firestore::V1::RollbackRequest, ::Google::Protobuf::Empty
64
64
  # Runs a query.
65
- rpc :RunQuery, Google::Cloud::Firestore::V1::RunQueryRequest, stream(Google::Cloud::Firestore::V1::RunQueryResponse)
65
+ rpc :RunQuery, ::Google::Cloud::Firestore::V1::RunQueryRequest, stream(::Google::Cloud::Firestore::V1::RunQueryResponse)
66
66
  # Partitions a query by returning partition cursors that can be used to run
67
67
  # the query in parallel. The returned partition cursors are split points that
68
68
  # can be used by RunQuery as starting/end points for the query results.
69
- rpc :PartitionQuery, Google::Cloud::Firestore::V1::PartitionQueryRequest, Google::Cloud::Firestore::V1::PartitionQueryResponse
69
+ rpc :PartitionQuery, ::Google::Cloud::Firestore::V1::PartitionQueryRequest, ::Google::Cloud::Firestore::V1::PartitionQueryResponse
70
70
  # Streams batches of document updates and deletes, in order.
71
- rpc :Write, stream(Google::Cloud::Firestore::V1::WriteRequest), stream(Google::Cloud::Firestore::V1::WriteResponse)
71
+ rpc :Write, stream(::Google::Cloud::Firestore::V1::WriteRequest), stream(::Google::Cloud::Firestore::V1::WriteResponse)
72
72
  # Listens to changes.
73
- rpc :Listen, stream(Google::Cloud::Firestore::V1::ListenRequest), stream(Google::Cloud::Firestore::V1::ListenResponse)
73
+ rpc :Listen, stream(::Google::Cloud::Firestore::V1::ListenRequest), stream(::Google::Cloud::Firestore::V1::ListenResponse)
74
74
  # Lists all the collection IDs underneath a document.
75
- rpc :ListCollectionIds, Google::Cloud::Firestore::V1::ListCollectionIdsRequest, Google::Cloud::Firestore::V1::ListCollectionIdsResponse
75
+ rpc :ListCollectionIds, ::Google::Cloud::Firestore::V1::ListCollectionIdsRequest, ::Google::Cloud::Firestore::V1::ListCollectionIdsResponse
76
76
  # Applies a batch of write operations.
77
77
  #
78
78
  # The BatchWrite method does not apply the write operations atomically
@@ -82,9 +82,9 @@ module Google
82
82
  #
83
83
  # If you require an atomically applied set of writes, use
84
84
  # [Commit][google.firestore.v1.Firestore.Commit] instead.
85
- rpc :BatchWrite, Google::Cloud::Firestore::V1::BatchWriteRequest, Google::Cloud::Firestore::V1::BatchWriteResponse
85
+ rpc :BatchWrite, ::Google::Cloud::Firestore::V1::BatchWriteRequest, ::Google::Cloud::Firestore::V1::BatchWriteResponse
86
86
  # Creates a new document.
87
- rpc :CreateDocument, Google::Cloud::Firestore::V1::CreateDocumentRequest, Google::Cloud::Firestore::V1::Document
87
+ rpc :CreateDocument, ::Google::Cloud::Firestore::V1::CreateDocumentRequest, ::Google::Cloud::Firestore::V1::Document
88
88
  end
89
89
 
90
90
  Stub = Service.rpc_stub_class
@@ -49,9 +49,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
49
49
  value :GREATER_THAN, 3
50
50
  value :GREATER_THAN_OR_EQUAL, 4
51
51
  value :EQUAL, 5
52
+ value :NOT_EQUAL, 6
52
53
  value :ARRAY_CONTAINS, 7
53
54
  value :IN, 8
54
55
  value :ARRAY_CONTAINS_ANY, 9
56
+ value :NOT_IN, 10
55
57
  end
56
58
  add_message "google.firestore.v1.StructuredQuery.UnaryFilter" do
57
59
  optional :op, :enum, 1, "google.firestore.v1.StructuredQuery.UnaryFilter.Operator"
@@ -63,6 +65,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
63
65
  value :OPERATOR_UNSPECIFIED, 0
64
66
  value :IS_NAN, 2
65
67
  value :IS_NULL, 3
68
+ value :IS_NOT_NAN, 4
69
+ value :IS_NOT_NULL, 5
70
+ end
71
+ add_message "google.firestore.v1.StructuredQuery.Order" do
72
+ optional :field, :message, 1, "google.firestore.v1.StructuredQuery.FieldReference"
73
+ optional :direction, :enum, 2, "google.firestore.v1.StructuredQuery.Direction"
66
74
  end
67
75
  add_message "google.firestore.v1.StructuredQuery.FieldReference" do
68
76
  optional :field_path, :string, 2
@@ -70,10 +78,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
70
78
  add_message "google.firestore.v1.StructuredQuery.Projection" do
71
79
  repeated :fields, :message, 2, "google.firestore.v1.StructuredQuery.FieldReference"
72
80
  end
73
- add_message "google.firestore.v1.StructuredQuery.Order" do
74
- optional :field, :message, 1, "google.firestore.v1.StructuredQuery.FieldReference"
75
- optional :direction, :enum, 2, "google.firestore.v1.StructuredQuery.Direction"
76
- end
77
81
  add_enum "google.firestore.v1.StructuredQuery.Direction" do
78
82
  value :DIRECTION_UNSPECIFIED, 0
79
83
  value :ASCENDING, 1
@@ -99,9 +103,9 @@ module Google
99
103
  StructuredQuery::FieldFilter::Operator = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.FieldFilter.Operator").enummodule
100
104
  StructuredQuery::UnaryFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.UnaryFilter").msgclass
101
105
  StructuredQuery::UnaryFilter::Operator = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.UnaryFilter.Operator").enummodule
106
+ StructuredQuery::Order = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Order").msgclass
102
107
  StructuredQuery::FieldReference = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.FieldReference").msgclass
103
108
  StructuredQuery::Projection = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Projection").msgclass
104
- StructuredQuery::Order = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Order").msgclass
105
109
  StructuredQuery::Direction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Direction").enummodule
106
110
  Cursor = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.Cursor").msgclass
107
111
  end
@@ -43,12 +43,12 @@ module Google
43
43
  #
44
44
  # The ResourceDescriptor Yaml config will look like:
45
45
  #
46
- # resources:
47
- # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/\\{project}/topics/\\{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/\\{project}"
46
+ # resources:
47
+ # - type: "pubsub.googleapis.com/Topic"
48
+ # name_descriptor:
49
+ # - pattern: "projects/{project}/topics/{topic}"
50
+ # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
+ # parent_name_extractor: "projects/{project}"
52
52
  #
53
53
  # Sometimes, resources have multiple patterns, typically because they can
54
54
  # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
183
183
  # }
184
184
  # @!attribute [rw] plural
185
185
  # @return [::String]
186
- # The plural name used in the resource name, such as 'projects' for
187
- # the name of 'projects/\\{project}'. It is the same concept of the `plural`
188
- # field in k8s CRD spec
186
+ # The plural name used in the resource name and permission names, such as
187
+ # 'projects' for the resource name of 'projects/\\{project}' and the permission
188
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
189
+ # concept of the `plural` field in k8s CRD spec
189
190
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
191
+ #
192
+ # Note: The plural form is required even for singleton resources. See
193
+ # https://aip.dev/156
190
194
  # @!attribute [rw] singular
191
195
  # @return [::String]
192
196
  # The same concept of the `singular` field in k8s CRD spec
193
197
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
194
198
  # Such as "project" for the `resourcemanager.googleapis.com/Project` type.
199
+ # @!attribute [rw] style
200
+ # @return [::Array<::Google::Api::ResourceDescriptor::Style>]
201
+ # Style flag(s) for this resource.
202
+ # These indicate that a resource is expected to conform to a given
203
+ # style. See the specific style flags for additional information.
195
204
  class ResourceDescriptor
196
205
  include ::Google::Protobuf::MessageExts
197
206
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
211
220
  # that from being necessary once there are multiple patterns.)
212
221
  FUTURE_MULTI_PATTERN = 2
213
222
  end
223
+
224
+ # A flag representing a specific style that a resource claims to conform to.
225
+ module Style
226
+ # The unspecified value. Do not use.
227
+ STYLE_UNSPECIFIED = 0
228
+
229
+ # This resource is intended to be "declarative-friendly".
230
+ #
231
+ # Declarative-friendly resources must be more strictly consistent, and
232
+ # setting this to true communicates to tools that this resource should
233
+ # adhere to declarative-friendly expectations.
234
+ #
235
+ # Note: This is used by the API linter (linter.aip.dev) to enable
236
+ # additional checks.
237
+ DECLARATIVE_FRIENDLY = 1
238
+ end
214
239
  end
215
240
 
216
241
  # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
226
251
  # type: "pubsub.googleapis.com/Topic"
227
252
  # }];
228
253
  # }
254
+ #
255
+ # Occasionally, a field may reference an arbitrary resource. In this case,
256
+ # APIs use the special value * in their resource reference.
257
+ #
258
+ # Example:
259
+ #
260
+ # message GetIamPolicyRequest {
261
+ # string resource = 2 [(google.api.resource_reference) = {
262
+ # type: "*"
263
+ # }];
264
+ # }
229
265
  # @!attribute [rw] child_type
230
266
  # @return [::String]
231
267
  # The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
234
270
  #
235
271
  # Example:
236
272
  #
237
- # message ListLogEntriesRequest {
238
- # string parent = 1 [(google.api.resource_reference) = {
239
- # child_type: "logging.googleapis.com/LogEntry"
240
- # };
241
- # }
273
+ # message ListLogEntriesRequest {
274
+ # string parent = 1 [(google.api.resource_reference) = {
275
+ # child_type: "logging.googleapis.com/LogEntry"
276
+ # };
277
+ # }
242
278
  class ResourceReference
243
279
  include ::Google::Protobuf::MessageExts
244
280
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -374,13 +374,14 @@ module Google
374
374
  # @!attribute [rw] structured_query
375
375
  # @return [::Google::Cloud::Firestore::V1::StructuredQuery]
376
376
  # A structured query.
377
- # Filters, order bys, limits, offsets, and start/end cursors are not
378
- # supported.
377
+ # Query must specify collection with all descendants and be ordered by name
378
+ # ascending. Other filters, order bys, limits, offsets, and start/end
379
+ # cursors are not supported.
379
380
  # @!attribute [rw] partition_count
380
381
  # @return [::Integer]
381
382
  # The desired maximum number of partition points.
382
383
  # The partitions may be returned across multiple pages of results.
383
- # The number must be strictly positive. The actual number of partitions
384
+ # The number must be positive. The actual number of partitions
384
385
  # returned may be fewer.
385
386
  #
386
387
  # For example, this may be set to one fewer than the number of parallel
@@ -432,6 +433,9 @@ module Google
432
433
  # * query, end_at A
433
434
  # * query, start_at A, end_at B
434
435
  # * query, start_at B
436
+ #
437
+ # An empty result may indicate that the query has too few results to be
438
+ # partitioned.
435
439
  # @!attribute [rw] next_page_token
436
440
  # @return [::String]
437
441
  # A page token that may be used to request an additional set of results, up
@@ -175,6 +175,14 @@ module Google
175
175
  # The given `field` is equal to the given `value`.
176
176
  EQUAL = 5
177
177
 
178
+ # The given `field` is not equal to the given `value`.
179
+ #
180
+ # Requires:
181
+ #
182
+ # * No other `NOT_EQUAL`, `NOT_IN`, `IS_NOT_NULL`, or `IS_NOT_NAN`.
183
+ # * That `field` comes first in the `order_by`.
184
+ NOT_EQUAL = 6
185
+
178
186
  # The given `field` is an array that contains the given `value`.
179
187
  ARRAY_CONTAINS = 7
180
188
 
@@ -183,7 +191,7 @@ module Google
183
191
  # Requires:
184
192
  #
185
193
  # * That `value` is a non-empty `ArrayValue` with at most 10 values.
186
- # * No other `IN`, `ARRAY_CONTAINS_ANY`, or `NOT_IN`.
194
+ # * No other `IN` or `ARRAY_CONTAINS_ANY` or `NOT_IN`.
187
195
  IN = 8
188
196
 
189
197
  # The given `field` is an array that contains any of the values in the
@@ -192,8 +200,18 @@ module Google
192
200
  # Requires:
193
201
  #
194
202
  # * That `value` is a non-empty `ArrayValue` with at most 10 values.
195
- # * No other `IN`, `ARRAY_CONTAINS_ANY`, or `NOT_IN`.
203
+ # * No other `IN` or `ARRAY_CONTAINS_ANY` or `NOT_IN`.
196
204
  ARRAY_CONTAINS_ANY = 9
205
+
206
+ # The value of the `field` is not in the given array.
207
+ #
208
+ # Requires:
209
+ #
210
+ # * That `value` is a non-empty `ArrayValue` with at most 10 values.
211
+ # * No other `IN`, `ARRAY_CONTAINS_ANY`, `NOT_IN`, `NOT_EQUAL`,
212
+ # `IS_NOT_NULL`, or `IS_NOT_NAN`.
213
+ # * That `field` comes first in the `order_by`.
214
+ NOT_IN = 10
197
215
  end
198
216
  end
199
217
 
@@ -218,9 +236,37 @@ module Google
218
236
 
219
237
  # The given `field` is equal to `NULL`.
220
238
  IS_NULL = 3
239
+
240
+ # The given `field` is not equal to `NaN`.
241
+ #
242
+ # Requires:
243
+ #
244
+ # * No other `NOT_EQUAL`, `NOT_IN`, `IS_NOT_NULL`, or `IS_NOT_NAN`.
245
+ # * That `field` comes first in the `order_by`.
246
+ IS_NOT_NAN = 4
247
+
248
+ # The given `field` is not equal to `NULL`.
249
+ #
250
+ # Requires:
251
+ #
252
+ # * A single `NOT_EQUAL`, `NOT_IN`, `IS_NOT_NULL`, or `IS_NOT_NAN`.
253
+ # * That `field` comes first in the `order_by`.
254
+ IS_NOT_NULL = 5
221
255
  end
222
256
  end
223
257
 
258
+ # An order on a field.
259
+ # @!attribute [rw] field
260
+ # @return [::Google::Cloud::Firestore::V1::StructuredQuery::FieldReference]
261
+ # The field to order by.
262
+ # @!attribute [rw] direction
263
+ # @return [::Google::Cloud::Firestore::V1::StructuredQuery::Direction]
264
+ # The direction to order by. Defaults to `ASCENDING`.
265
+ class Order
266
+ include ::Google::Protobuf::MessageExts
267
+ extend ::Google::Protobuf::MessageExts::ClassMethods
268
+ end
269
+
224
270
  # A reference to a field, such as `max(messages.time) as max_time`.
225
271
  # @!attribute [rw] field_path
226
272
  # @return [::String]
@@ -241,18 +287,6 @@ module Google
241
287
  extend ::Google::Protobuf::MessageExts::ClassMethods
242
288
  end
243
289
 
244
- # An order on a field.
245
- # @!attribute [rw] field
246
- # @return [::Google::Cloud::Firestore::V1::StructuredQuery::FieldReference]
247
- # The field to order by.
248
- # @!attribute [rw] direction
249
- # @return [::Google::Cloud::Firestore::V1::StructuredQuery::Direction]
250
- # The direction to order by. Defaults to `ASCENDING`.
251
- class Order
252
- include ::Google::Protobuf::MessageExts
253
- extend ::Google::Protobuf::MessageExts::ClassMethods
254
- end
255
-
256
290
  # A sort direction.
257
291
  module Direction
258
292
  # Unspecified.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-firestore-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.2.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-08-03 00:00:00.000000000 Z
11
+ date: 2020-10-26 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -207,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
207
207
  - !ruby/object:Gem::Version
208
208
  version: '0'
209
209
  requirements: []
210
- rubygems_version: 3.1.3
210
+ rubygems_version: 3.1.4
211
211
  signing_key:
212
212
  specification_version: 4
213
213
  summary: API Client library for the Cloud Firestore V1 API