google-api-ruby-client/generated/google/apis/proximitybeacon_v1beta1/classes.rb

858 lines
36 KiB
Ruby
Raw Normal View History

2015-12-03 01:10:07 +00:00
# Copyright 2015 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
require 'date'
require 'google/apis/core/base_service'
require 'google/apis/core/json_representation'
require 'google/apis/core/hashable'
require 'google/apis/errors'
module Google
module Apis
module ProximitybeaconV1beta1
2017-03-10 21:11:09 +00:00
# Response that contains list beacon results and pagination help.
class ListBeaconsResponse
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-10 21:11:09 +00:00
# An opaque pagination token that the client may provide in their next
# request to retrieve the next page of results.
# Corresponds to the JSON property `nextPageToken`
2015-12-03 01:10:07 +00:00
# @return [String]
2017-03-10 21:11:09 +00:00
attr_accessor :next_page_token
2017-03-27 22:14:47 +00:00
# The beacons that matched the search criteria.
# Corresponds to the JSON property `beacons`
# @return [Array<Google::Apis::ProximitybeaconV1beta1::Beacon>]
attr_accessor :beacons
2017-03-10 21:11:09 +00:00
# Estimate of the total number of beacons matched by the query. Higher
# values may be less accurate.
# Corresponds to the JSON property `totalCount`
# @return [String]
attr_accessor :total_count
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
2017-03-27 22:14:47 +00:00
@beacons = args[:beacons] if args.key?(:beacons)
2017-03-10 21:11:09 +00:00
@total_count = args[:total_count] if args.key?(:total_count)
end
end
# Diagnostics for a single beacon.
class Diagnostics
include Google::Apis::Core::Hashable
2015-12-03 01:10:07 +00:00
2017-03-10 21:11:09 +00:00
# An unordered list of Alerts that the beacon has.
# Corresponds to the JSON property `alerts`
# @return [Array<String>]
attr_accessor :alerts
2017-03-10 21:11:09 +00:00
# Represents a whole calendar date, e.g. date of birth. The time of day and
# time zone are either specified elsewhere or are not significant. The date
# is relative to the Proleptic Gregorian Calendar. The day may be 0 to
# represent a year and month where the day is not significant, e.g. credit card
# expiration date. The year may be 0 to represent a month and day independent
# of year, e.g. anniversary date. Related types are google.type.TimeOfDay
# and `google.protobuf.Timestamp`.
# Corresponds to the JSON property `estimatedLowBatteryDate`
# @return [Google::Apis::ProximitybeaconV1beta1::Date]
attr_accessor :estimated_low_battery_date
2017-03-27 22:14:47 +00:00
# Resource name of the beacon. For Eddystone-EID beacons, this may
# be the beacon's current EID, or the beacon's "stable" Eddystone-UID.
# Corresponds to the JSON property `beaconName`
# @return [String]
attr_accessor :beacon_name
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-10 21:11:09 +00:00
@alerts = args[:alerts] if args.key?(:alerts)
@estimated_low_battery_date = args[:estimated_low_battery_date] if args.key?(:estimated_low_battery_date)
2017-03-27 22:14:47 +00:00
@beacon_name = args[:beacon_name] if args.key?(:beacon_name)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Request for beacon and attachment information about beacons that
# a mobile client has encountered "in the wild".
class GetInfoForObservedBeaconsRequest
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The beacons that the client has encountered.
# At least one must be given.
# Corresponds to the JSON property `observations`
# @return [Array<Google::Apis::ProximitybeaconV1beta1::Observation>]
attr_accessor :observations
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
# Specifies what kind of attachments to include in the response.
# When given, the response will include only attachments of the given types.
# When empty, no attachments will be returned. Must be in the format
# <var>namespace/type</var>. Accepts `*` to specify all types in
# all namespaces owned by the client.
# Optional.
# Corresponds to the JSON property `namespacedTypes`
# @return [Array<String>]
attr_accessor :namespaced_types
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@observations = args[:observations] if args.key?(:observations)
@namespaced_types = args[:namespaced_types] if args.key?(:namespaced_types)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# A generic empty message that you can re-use to avoid defining duplicated
# empty messages in your APIs. A typical example is to use it as the request
# or the response type of an API method. For instance:
# service Foo `
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
# `
# The JSON representation for `Empty` is empty JSON object ````.
class Empty
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
end
end
# Project-specific data associated with a beacon.
class BeaconAttachment
include Google::Apis::Core::Hashable
# Resource name of this attachment. Attachment names have the format:
# <code>beacons/<var>beacon_id</var>/attachments/<var>attachment_id</var></code>.
# Leave this empty on creation.
# Corresponds to the JSON property `attachmentName`
# @return [String]
attr_accessor :attachment_name
# Specifies what kind of attachment this is. Tells a client how to
# interpret the `data` field. Format is <var>namespace/type</var>. Namespace
# provides type separation between clients. Type describes the type of
# `data`, for use by the client when parsing the `data` field.
# Required.
# Corresponds to the JSON property `namespacedType`
# @return [String]
attr_accessor :namespaced_type
# An opaque data container for client-provided data. Must be
# [base64](http://tools.ietf.org/html/rfc4648#section-4) encoded in HTTP
# requests, and will be so encoded (with padding) in responses.
# Required.
# Corresponds to the JSON property `data`
# @return [String]
attr_accessor :data
# The UTC time when this attachment was created, in milliseconds since the
# UNIX epoch.
# Corresponds to the JSON property `creationTimeMs`
# @return [String]
attr_accessor :creation_time_ms
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@attachment_name = args[:attachment_name] if args.key?(:attachment_name)
@namespaced_type = args[:namespaced_type] if args.key?(:namespaced_type)
@data = args[:data] if args.key?(:data)
@creation_time_ms = args[:creation_time_ms] if args.key?(:creation_time_ms)
2015-12-03 01:10:07 +00:00
end
end
2017-03-10 21:11:09 +00:00
# Write-only registration parameters for beacons using Eddystone-EID format.
# Two ways of securely registering an Eddystone-EID beacon with the service
# are supported:
# 1. Perform an ECDH key exchange via this API, including a previous call
# to `GET /v1beta1/eidparams`. In this case the fields
# `beacon_ecdh_public_key` and `service_ecdh_public_key` should be
# populated and `beacon_identity_key` should not be populated. This
# method ensures that only the two parties in the ECDH key exchange can
# compute the identity key, which becomes a secret between them.
# 2. Derive or obtain the beacon's identity key via other secure means
# (perhaps an ECDH key exchange between the beacon and a mobile device
# or any other secure method), and then submit the resulting identity key
# to the service. In this case `beacon_identity_key` field should be
# populated, and neither of `beacon_ecdh_public_key` nor
# `service_ecdh_public_key` fields should be. The security of this method
# depends on how securely the parties involved (in particular the
# bluetooth client) handle the identity key, and obviously on how
# securely the identity key was generated.
# See [the Eddystone specification](https://github.com/google/eddystone/tree/
# master/eddystone-eid) at GitHub.
class EphemeralIdRegistration
include Google::Apis::Core::Hashable
2017-03-10 21:11:09 +00:00
# The initial clock value of the beacon. The beacon's clock must have
# begun counting at this value immediately prior to transmitting this
# value to the resolving service. Significant delay in transmitting this
# value to the service risks registration or resolution failures. If a
# value is not provided, the default is zero.
# Corresponds to the JSON property `initialClockValue`
# @return [String]
2017-03-10 21:11:09 +00:00
attr_accessor :initial_clock_value
2017-03-27 22:14:47 +00:00
# The beacon's public key used for the Elliptic curve Diffie-Hellman
# key exchange. When this field is populated, `service_ecdh_public_key`
2017-03-10 21:11:09 +00:00
# must also be populated, and `beacon_identity_key` must not be.
2017-03-27 22:14:47 +00:00
# Corresponds to the JSON property `beaconEcdhPublicKey`
2017-03-10 21:11:09 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :beacon_ecdh_public_key
2017-03-10 21:11:09 +00:00
# Indicates the nominal period between each rotation of the beacon's
# ephemeral ID. "Nominal" because the beacon should randomize the
# actual interval. See [the spec at github](https://github.com/google/eddystone/
# tree/master/eddystone-eid)
# for details. This value corresponds to a power-of-two scaler on the
# beacon's clock: when the scaler value is K, the beacon will begin
# broadcasting a new ephemeral ID on average every 2^K seconds.
# Corresponds to the JSON property `rotationPeriodExponent`
# @return [Fixnum]
attr_accessor :rotation_period_exponent
2017-03-27 22:14:47 +00:00
# The service's public key used for the Elliptic curve Diffie-Hellman
# key exchange. When this field is populated, `beacon_ecdh_public_key`
# must also be populated, and `beacon_identity_key` must not be.
# Corresponds to the JSON property `serviceEcdhPublicKey`
# @return [String]
attr_accessor :service_ecdh_public_key
# The private key of the beacon. If this field is populated,
# `beacon_ecdh_public_key` and `service_ecdh_public_key` must not be
# populated.
# Corresponds to the JSON property `beaconIdentityKey`
# @return [String]
attr_accessor :beacon_identity_key
2017-03-10 21:11:09 +00:00
# An initial ephemeral ID calculated using the clock value submitted as
# `initial_clock_value`, and the secret key generated by the
# Diffie-Hellman key exchange using `service_ecdh_public_key` and
# `service_ecdh_public_key`. This initial EID value will be used by the
# service to confirm that the key exchange process was successful.
# Corresponds to the JSON property `initialEid`
# @return [String]
attr_accessor :initial_eid
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-10 21:11:09 +00:00
@initial_clock_value = args[:initial_clock_value] if args.key?(:initial_clock_value)
2017-03-27 22:14:47 +00:00
@beacon_ecdh_public_key = args[:beacon_ecdh_public_key] if args.key?(:beacon_ecdh_public_key)
@rotation_period_exponent = args[:rotation_period_exponent] if args.key?(:rotation_period_exponent)
2017-03-27 22:14:47 +00:00
@service_ecdh_public_key = args[:service_ecdh_public_key] if args.key?(:service_ecdh_public_key)
@beacon_identity_key = args[:beacon_identity_key] if args.key?(:beacon_identity_key)
@initial_eid = args[:initial_eid] if args.key?(:initial_eid)
end
end
2017-03-27 22:14:47 +00:00
# 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
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
# standard</a>. 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.
class LatLng
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The latitude in degrees. It must be in the range [-90.0, +90.0].
# Corresponds to the JSON property `latitude`
# @return [Float]
attr_accessor :latitude
2017-03-10 21:11:09 +00:00
2017-03-27 22:14:47 +00:00
# The longitude in degrees. It must be in the range [-180.0, +180.0].
# Corresponds to the JSON property `longitude`
# @return [Float]
attr_accessor :longitude
2017-03-10 21:11:09 +00:00
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@latitude = args[:latitude] if args.key?(:latitude)
@longitude = args[:longitude] if args.key?(:longitude)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Response to `ListBeaconAttachments` that contains the requested attachments.
class ListBeaconAttachmentsResponse
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The attachments that corresponded to the request params.
2017-03-10 21:11:09 +00:00
# Corresponds to the JSON property `attachments`
2017-03-27 22:14:47 +00:00
# @return [Array<Google::Apis::ProximitybeaconV1beta1::BeaconAttachment>]
2017-03-10 21:11:09 +00:00
attr_accessor :attachments
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@attachments = args[:attachments] if args.key?(:attachments)
end
end
# An attachment namespace defines read and write access for all the attachments
# created under it. Each namespace is globally unique, and owned by one
# project which is the only project that can create attachments under it.
class Namespace
include Google::Apis::Core::Hashable
# Resource name of this namespace. Namespaces names have the format:
# <code>namespaces/<var>namespace</var></code>.
# Corresponds to the JSON property `namespaceName`
2015-12-03 01:10:07 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :namespace_name
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
# Specifies what clients may receive attachments under this namespace
# via `beaconinfo.getforobserved`.
# Corresponds to the JSON property `servingVisibility`
# @return [String]
attr_accessor :serving_visibility
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@namespace_name = args[:namespace_name] if args.key?(:namespace_name)
@serving_visibility = args[:serving_visibility] if args.key?(:serving_visibility)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# A subset of attachment information served via the
# `beaconinfo.getforobserved` method, used when your users encounter your
# beacons.
class AttachmentInfo
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# Specifies what kind of attachment this is. Tells a client how to
# interpret the `data` field. Format is <var>namespace/type</var>, for
# example <code>scrupulous-wombat-12345/welcome-message</code>
# Corresponds to the JSON property `namespacedType`
2015-12-03 01:10:07 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :namespaced_type
# An opaque data container for client-provided data.
# Corresponds to the JSON property `data`
# @return [String]
attr_accessor :data
2015-12-03 01:10:07 +00:00
2017-03-10 21:11:09 +00:00
def initialize(**args)
update!(**args)
end
2015-12-03 01:10:07 +00:00
2017-03-10 21:11:09 +00:00
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@namespaced_type = args[:namespaced_type] if args.key?(:namespaced_type)
@data = args[:data] if args.key?(:data)
end
end
# A subset of beacon information served via the `beaconinfo.getforobserved`
# method, which you call when users of your app encounter your beacons.
class BeaconInfo
include Google::Apis::Core::Hashable
# The name under which the beacon is registered.
# Corresponds to the JSON property `beaconName`
# @return [String]
attr_accessor :beacon_name
# Defines a unique identifier of a beacon as broadcast by the device.
# Corresponds to the JSON property `advertisedId`
# @return [Google::Apis::ProximitybeaconV1beta1::AdvertisedId]
attr_accessor :advertised_id
# Attachments matching the type(s) requested.
# May be empty if no attachment types were requested.
# Corresponds to the JSON property `attachments`
# @return [Array<Google::Apis::ProximitybeaconV1beta1::AttachmentInfo>]
attr_accessor :attachments
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@beacon_name = args[:beacon_name] if args.key?(:beacon_name)
@advertised_id = args[:advertised_id] if args.key?(:advertised_id)
@attachments = args[:attachments] if args.key?(:attachments)
2017-03-10 21:11:09 +00:00
end
end
# Information a client needs to provision and register beacons that
# broadcast Eddystone-EID format beacon IDs, using Elliptic curve
# Diffie-Hellman key exchange. See
# [the Eddystone specification](https://github.com/google/eddystone/tree/master/
# eddystone-eid) at GitHub.
class EphemeralIdRegistrationParams
include Google::Apis::Core::Hashable
# The beacon service's public key for use by a beacon to derive its
# Identity Key using Elliptic Curve Diffie-Hellman key exchange.
# Corresponds to the JSON property `serviceEcdhPublicKey`
2015-12-03 01:10:07 +00:00
# @return [String]
2017-03-10 21:11:09 +00:00
attr_accessor :service_ecdh_public_key
# Indicates the minimum rotation period supported by the service.
# See EddystoneEidRegistration.rotation_period_exponent
# Corresponds to the JSON property `minRotationPeriodExponent`
# @return [Fixnum]
attr_accessor :min_rotation_period_exponent
# Indicates the maximum rotation period supported by the service.
# See EddystoneEidRegistration.rotation_period_exponent
# Corresponds to the JSON property `maxRotationPeriodExponent`
# @return [Fixnum]
attr_accessor :max_rotation_period_exponent
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-10 21:11:09 +00:00
@service_ecdh_public_key = args[:service_ecdh_public_key] if args.key?(:service_ecdh_public_key)
@min_rotation_period_exponent = args[:min_rotation_period_exponent] if args.key?(:min_rotation_period_exponent)
@max_rotation_period_exponent = args[:max_rotation_period_exponent] if args.key?(:max_rotation_period_exponent)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Response for a request to delete attachments.
class DeleteAttachmentsResponse
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The number of attachments that were deleted.
# Corresponds to the JSON property `numDeleted`
# @return [Fixnum]
attr_accessor :num_deleted
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@num_deleted = args[:num_deleted] if args.key?(:num_deleted)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Represents one beacon observed once.
class Observation
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The array of telemetry bytes received from the beacon. The server is
# responsible for parsing it. This field may frequently be empty, as
# with a beacon that transmits telemetry only occasionally.
# Corresponds to the JSON property `telemetry`
2017-03-10 21:11:09 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :telemetry
2017-03-10 21:11:09 +00:00
2017-03-27 22:14:47 +00:00
# Time when the beacon was observed.
# Corresponds to the JSON property `timestampMs`
2017-03-10 21:11:09 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :timestamp_ms
# Defines a unique identifier of a beacon as broadcast by the device.
# Corresponds to the JSON property `advertisedId`
# @return [Google::Apis::ProximitybeaconV1beta1::AdvertisedId]
attr_accessor :advertised_id
2017-03-10 21:11:09 +00:00
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@telemetry = args[:telemetry] if args.key?(:telemetry)
@timestamp_ms = args[:timestamp_ms] if args.key?(:timestamp_ms)
@advertised_id = args[:advertised_id] if args.key?(:advertised_id)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Response that contains the requested diagnostics.
class ListDiagnosticsResponse
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The diagnostics matching the given request.
# Corresponds to the JSON property `diagnostics`
# @return [Array<Google::Apis::ProximitybeaconV1beta1::Diagnostics>]
attr_accessor :diagnostics
2017-03-10 21:11:09 +00:00
2017-03-27 22:14:47 +00:00
# Token that can be used for pagination. Returned only if the
# request matches more beacons than can be returned in this response.
# Corresponds to the JSON property `nextPageToken`
2017-03-10 21:11:09 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :next_page_token
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@diagnostics = args[:diagnostics] if args.key?(:diagnostics)
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Information about the requested beacons, optionally including attachment
# data.
class GetInfoForObservedBeaconsResponse
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# Public information about beacons.
# May be empty if the request matched no beacons.
# Corresponds to the JSON property `beacons`
# @return [Array<Google::Apis::ProximitybeaconV1beta1::BeaconInfo>]
attr_accessor :beacons
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
def initialize(**args)
update!(**args)
end
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
# Update properties of this object
def update!(**args)
@beacons = args[:beacons] if args.key?(:beacons)
end
end
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
# Details of a beacon device.
class Beacon
include Google::Apis::Core::Hashable
# Defines a unique identifier of a beacon as broadcast by the device.
# Corresponds to the JSON property `advertisedId`
# @return [Google::Apis::ProximitybeaconV1beta1::AdvertisedId]
attr_accessor :advertised_id
2015-12-03 01:10:07 +00:00
2017-03-10 21:11:09 +00:00
# Write-only registration parameters for beacons using Eddystone-EID format.
# Two ways of securely registering an Eddystone-EID beacon with the service
# are supported:
# 1. Perform an ECDH key exchange via this API, including a previous call
# to `GET /v1beta1/eidparams`. In this case the fields
# `beacon_ecdh_public_key` and `service_ecdh_public_key` should be
# populated and `beacon_identity_key` should not be populated. This
# method ensures that only the two parties in the ECDH key exchange can
# compute the identity key, which becomes a secret between them.
# 2. Derive or obtain the beacon's identity key via other secure means
# (perhaps an ECDH key exchange between the beacon and a mobile device
# or any other secure method), and then submit the resulting identity key
# to the service. In this case `beacon_identity_key` field should be
# populated, and neither of `beacon_ecdh_public_key` nor
# `service_ecdh_public_key` fields should be. The security of this method
# depends on how securely the parties involved (in particular the
# bluetooth client) handle the identity key, and obviously on how
# securely the identity key was generated.
# See [the Eddystone specification](https://github.com/google/eddystone/tree/
# master/eddystone-eid) at GitHub.
# Corresponds to the JSON property `ephemeralIdRegistration`
# @return [Google::Apis::ProximitybeaconV1beta1::EphemeralIdRegistration]
attr_accessor :ephemeral_id_registration
2017-03-27 22:14:47 +00:00
# Some beacons may require a user to provide an authorization key before
# changing any of its configuration (e.g. broadcast frames, transmit power).
# This field provides a place to store and control access to that key.
# This field is populated in responses to `GET /v1beta1/beacons/3!beaconId`
# from users with write access to the given beacon. That is to say: If the
# user is authorized to write the beacon's confidential data in the service,
# the service considers them authorized to configure the beacon. Note
# that this key grants nothing on the service, only on the beacon itself.
# Corresponds to the JSON property `provisioningKey`
# @return [String]
attr_accessor :provisioning_key
# Free text used to identify and describe the beacon. Maximum length 140
# characters.
2017-03-10 21:11:09 +00:00
# Optional.
2017-03-27 22:14:47 +00:00
# Corresponds to the JSON property `description`
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :description
2017-03-10 21:11:09 +00:00
# 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
# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
# standard</a>. 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 `latLng`
# @return [Google::Apis::ProximitybeaconV1beta1::LatLng]
attr_accessor :lat_lng
2017-03-27 22:14:47 +00:00
# The [Google Places API](/places/place-id) Place ID of the place where
# the beacon is deployed. This is given when the beacon is registered or
# updated, not automatically detected in any way.
# Optional.
# Corresponds to the JSON property `placeId`
# @return [String]
attr_accessor :place_id
# Properties of the beacon device, for example battery type or firmware
# version.
# Optional.
# Corresponds to the JSON property `properties`
# @return [Hash<String,String>]
attr_accessor :properties
# Current status of the beacon.
# Required.
# Corresponds to the JSON property `status`
# @return [String]
attr_accessor :status
# Indoor level, a human-readable string as returned by Google Maps APIs,
# useful to indicate which floor of a building a beacon is located on.
# Corresponds to the JSON property `indoorLevel`
# @return [Google::Apis::ProximitybeaconV1beta1::IndoorLevel]
attr_accessor :indoor_level
2017-03-10 21:11:09 +00:00
# Resource name of this beacon. A beacon name has the format
# "beacons/N!beaconId" where the beaconId is the base16 ID broadcast by
# the beacon and N is a code for the beacon's type. Possible values are
# `3` for Eddystone, `1` for iBeacon, or `5` for AltBeacon.
# This field must be left empty when registering. After reading a beacon,
# clients can use the name for future operations.
# Corresponds to the JSON property `beaconName`
# @return [String]
attr_accessor :beacon_name
# Expected location stability. This is set when the beacon is registered or
# updated, not automatically detected in any way.
# Optional.
# Corresponds to the JSON property `expectedStability`
# @return [String]
attr_accessor :expected_stability
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-10 21:11:09 +00:00
@advertised_id = args[:advertised_id] if args.key?(:advertised_id)
2017-03-27 22:14:47 +00:00
@ephemeral_id_registration = args[:ephemeral_id_registration] if args.key?(:ephemeral_id_registration)
@provisioning_key = args[:provisioning_key] if args.key?(:provisioning_key)
@description = args[:description] if args.key?(:description)
2017-03-10 21:11:09 +00:00
@lat_lng = args[:lat_lng] if args.key?(:lat_lng)
2017-03-27 22:14:47 +00:00
@place_id = args[:place_id] if args.key?(:place_id)
@properties = args[:properties] if args.key?(:properties)
@status = args[:status] if args.key?(:status)
@indoor_level = args[:indoor_level] if args.key?(:indoor_level)
2017-03-10 21:11:09 +00:00
@beacon_name = args[:beacon_name] if args.key?(:beacon_name)
@expected_stability = args[:expected_stability] if args.key?(:expected_stability)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Defines a unique identifier of a beacon as broadcast by the device.
class AdvertisedId
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# Specifies the identifier type.
2017-03-10 21:11:09 +00:00
# Required.
2017-03-27 22:14:47 +00:00
# Corresponds to the JSON property `type`
2015-12-03 01:10:07 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :type
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
# The actual beacon identifier, as broadcast by the beacon hardware. Must be
# [base64](http://tools.ietf.org/html/rfc4648#section-4) encoded in HTTP
# requests, and will be so encoded (with padding) in responses. The base64
# encoding should be of the binary byte-stream and not any textual (such as
# hex) representation thereof.
2017-03-10 21:11:09 +00:00
# Required.
2017-03-27 22:14:47 +00:00
# Corresponds to the JSON property `id`
2017-03-10 21:11:09 +00:00
# @return [String]
2017-03-27 22:14:47 +00:00
attr_accessor :id
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@type = args[:type] if args.key?(:type)
@id = args[:id] if args.key?(:id)
2015-12-03 01:10:07 +00:00
end
end
2017-03-10 21:11:09 +00:00
# Represents a whole calendar date, e.g. date of birth. The time of day and
# time zone are either specified elsewhere or are not significant. The date
# is relative to the Proleptic Gregorian Calendar. The day may be 0 to
# represent a year and month where the day is not significant, e.g. credit card
# expiration date. The year may be 0 to represent a month and day independent
# of year, e.g. anniversary date. Related types are google.type.TimeOfDay
# and `google.protobuf.Timestamp`.
class Date
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-10 21:11:09 +00:00
# Year of date. Must be from 1 to 9999, or 0 if specifying a date without
# a year.
# Corresponds to the JSON property `year`
# @return [Fixnum]
attr_accessor :year
2015-12-03 01:10:07 +00:00
2017-03-10 21:11:09 +00:00
# Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
# Corresponds to the JSON property `day`
# @return [Fixnum]
attr_accessor :day
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
# Month of year. Must be from 1 to 12.
# Corresponds to the JSON property `month`
# @return [Fixnum]
attr_accessor :month
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-10 21:11:09 +00:00
@year = args[:year] if args.key?(:year)
@day = args[:day] if args.key?(:day)
2017-03-27 22:14:47 +00:00
@month = args[:month] if args.key?(:month)
2015-12-03 01:10:07 +00:00
end
end
2017-03-27 22:14:47 +00:00
# Indoor level, a human-readable string as returned by Google Maps APIs,
# useful to indicate which floor of a building a beacon is located on.
class IndoorLevel
2015-12-03 01:10:07 +00:00
include Google::Apis::Core::Hashable
2017-03-27 22:14:47 +00:00
# The name of this level.
# Corresponds to the JSON property `name`
# @return [String]
attr_accessor :name
2015-12-03 01:10:07 +00:00
2017-03-27 22:14:47 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@name = args[:name] if args.key?(:name)
end
end
# Response to ListNamespacesRequest that contains all the project's namespaces.
class ListNamespacesResponse
include Google::Apis::Core::Hashable
# The attachments that corresponded to the request params.
# Corresponds to the JSON property `namespaces`
# @return [Array<Google::Apis::ProximitybeaconV1beta1::Namespace>]
attr_accessor :namespaces
2015-12-03 01:10:07 +00:00
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
2017-03-27 22:14:47 +00:00
@namespaces = args[:namespaces] if args.key?(:namespaces)
2015-12-03 01:10:07 +00:00
end
end
end
end
end