Class: Google::Apis::DatastoreV1::Value
- Inherits:
-
Object
- Object
- Google::Apis::DatastoreV1::Value
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- generated/google/apis/datastore_v1/classes.rb,
generated/google/apis/datastore_v1/representations.rb,
generated/google/apis/datastore_v1/representations.rb
Overview
A message that can hold any of the supported value types and associated metadata.
Instance Attribute Summary collapse
-
#array_value ⇒ Google::Apis::DatastoreV1::ArrayValue
An array value.
-
#blob_value ⇒ String
A blob value.
-
#boolean_value ⇒ Boolean
(also: #boolean_value?)
A boolean value.
-
#double_value ⇒ Float
A double value.
-
#entity_value ⇒ Google::Apis::DatastoreV1::Entity
A Datastore data object.
-
#exclude_from_indexes ⇒ Boolean
(also: #exclude_from_indexes?)
If the value should be excluded from all indexes including those defined explicitly.
-
#geo_point_value ⇒ Google::Apis::DatastoreV1::LatLng
An object representing a latitude/longitude pair.
-
#integer_value ⇒ String
An integer value.
-
#key_value ⇒ Google::Apis::DatastoreV1::Key
A unique identifier for an entity.
-
#meaning ⇒ Fixnum
The
meaningfield should only be populated for backwards compatibility. -
#null_value ⇒ String
A null value.
-
#string_value ⇒ String
A UTF-8 encoded string value.
-
#timestamp_value ⇒ String
A timestamp value.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Value
constructor
A new instance of Value.
-
#update!(**args) ⇒ Object
Update properties of this object.
Methods included from Core::JsonObjectSupport
Methods included from Core::Hashable
Constructor Details
#initialize(**args) ⇒ Value
Returns a new instance of Value
424 425 426 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 424 def initialize(**args) update!(**args) end |
Instance Attribute Details
#array_value ⇒ Google::Apis::DatastoreV1::ArrayValue
An array value.
Corresponds to the JSON property arrayValue
422 423 424 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 422 def array_value @array_value end |
#blob_value ⇒ String
A blob value.
May have at most 1,000,000 bytes.
When exclude_from_indexes is false, may have at most 1500 bytes.
In JSON requests, must be base64-encoded.
Corresponds to the JSON property blobValue
NOTE: Values are automatically base64 encoded/decoded in the client library.
412 413 414 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 412 def blob_value @blob_value end |
#boolean_value ⇒ Boolean Also known as: boolean_value?
A boolean value.
Corresponds to the JSON property booleanValue
397 398 399 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 397 def boolean_value @boolean_value end |
#double_value ⇒ Float
A double value.
Corresponds to the JSON property doubleValue
385 386 387 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 385 def double_value @double_value end |
#entity_value ⇒ Google::Apis::DatastoreV1::Entity
A Datastore data object.
An entity is limited to 1 megabyte when stored. That roughly
corresponds to a limit of 1 megabyte for the serialized form of this
message.
Corresponds to the JSON property entityValue
311 312 313 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 311 def entity_value @entity_value end |
#exclude_from_indexes ⇒ Boolean Also known as: exclude_from_indexes?
If the value should be excluded from all indexes including those defined
explicitly.
Corresponds to the JSON property excludeFromIndexes
379 380 381 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 379 def exclude_from_indexes @exclude_from_indexes end |
#geo_point_value ⇒ Google::Apis::DatastoreV1::LatLng
An object representing a latitude/longitude pair. This is expressed as a pair
of doubles representing degrees latitude and degrees longitude. Unless
specified otherwise, this must conform to the
WGS84
standard. Values must be within normalized ranges.
Example of normalization code in Python:
def NormalizeLongitude(longitude):
"""Wraps decimal degrees longitude to [-180.0, 180.0]."""
q, r = divmod(longitude, 360.0)
if r > 180.0 or (r == 180.0 and q <= -1.0):
return r - 360.0
return r
def NormalizeLatLng(latitude, longitude):
"""Wraps decimal degrees latitude and longitude to
[-90.0, 90.0] and [-180.0, 180.0], respectively."""
r = latitude % 360.0
if r <= 90.0:
return r, NormalizeLongitude(longitude)
elif r >= 270.0:
return r - 360, NormalizeLongitude(longitude)
else:
return 180 - r, NormalizeLongitude(longitude + 180.0)
assert 180.0 == NormalizeLongitude(180.0)
assert -180.0 == NormalizeLongitude(-180.0)
assert -179.0 == NormalizeLongitude(181.0)
assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)
assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)
assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)
assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)
assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)
assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)
assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)
assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)
assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)
assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
The code in logs/storage/validator/logs_validator_traits.cc treats this type
as if it were annotated as ST_LOCATION.
Corresponds to the JSON property geoPointValue
352 353 354 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 352 def geo_point_value @geo_point_value end |
#integer_value ⇒ String
An integer value.
Corresponds to the JSON property integerValue
365 366 367 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 365 def integer_value @integer_value end |
#key_value ⇒ Google::Apis::DatastoreV1::Key
A unique identifier for an entity.
If a key's partition ID or any of its path kinds or names are
reserved/read-only, the key is reserved/read-only.
A reserved/read-only key is forbidden in certain documented contexts.
Corresponds to the JSON property keyValue
360 361 362 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 360 def key_value @key_value end |
#meaning ⇒ Fixnum
The meaning field should only be populated for backwards compatibility.
Corresponds to the JSON property meaning
417 418 419 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 417 def meaning @meaning end |
#null_value ⇒ String
A null value.
Corresponds to the JSON property nullValue
403 404 405 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 403 def null_value @null_value end |
#string_value ⇒ String
A UTF-8 encoded string value.
When exclude_from_indexes is false (it is indexed) , may have at most 1500
bytes.
Otherwise, may be set to at least 1,000,000 bytes.
Corresponds to the JSON property stringValue
373 374 375 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 373 def string_value @string_value end |
#timestamp_value ⇒ String
A timestamp value.
When stored in the Datastore, precise only to microseconds;
any additional precision is rounded down.
Corresponds to the JSON property timestampValue
392 393 394 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 392 def @timestamp_value end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 |
# File 'generated/google/apis/datastore_v1/classes.rb', line 429 def update!(**args) @entity_value = args[:entity_value] if args.key?(:entity_value) @geo_point_value = args[:geo_point_value] if args.key?(:geo_point_value) @key_value = args[:key_value] if args.key?(:key_value) @integer_value = args[:integer_value] if args.key?(:integer_value) @string_value = args[:string_value] if args.key?(:string_value) @exclude_from_indexes = args[:exclude_from_indexes] if args.key?(:exclude_from_indexes) @double_value = args[:double_value] if args.key?(:double_value) @timestamp_value = args[:timestamp_value] if args.key?(:timestamp_value) @boolean_value = args[:boolean_value] if args.key?(:boolean_value) @null_value = args[:null_value] if args.key?(:null_value) @blob_value = args[:blob_value] if args.key?(:blob_value) @meaning = args[:meaning] if args.key?(:meaning) @array_value = args[:array_value] if args.key?(:array_value) end |