google-api-client 0.8.6 → 0.9

data/generated/google/apis/proximitybeacon_v1beta1/representations.rb

@@ -0,0 +1,274 @@
+# 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
+      
+      class Beacon
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class AdvertisedId
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class LatLng
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class IndoorLevel
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Empty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListBeaconsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class BeaconAttachment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListBeaconAttachmentsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class DeleteAttachmentsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListNamespacesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Namespace
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class ListDiagnosticsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Diagnostics
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Date
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class GetInfoForObservedBeaconsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Observation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class GetInfoForObservedBeaconsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class BeaconInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class AttachmentInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      end
+      
+      class Beacon
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :beacon_name, as: 'beaconName'
+          property :advertised_id, as: 'advertisedId', class: Google::Apis::ProximitybeaconV1beta1::AdvertisedId, decorator: Google::Apis::ProximitybeaconV1beta1::AdvertisedId::Representation
+      
+          property :status, as: 'status'
+          property :place_id, as: 'placeId'
+          property :lat_lng, as: 'latLng', class: Google::Apis::ProximitybeaconV1beta1::LatLng, decorator: Google::Apis::ProximitybeaconV1beta1::LatLng::Representation
+      
+          property :indoor_level, as: 'indoorLevel', class: Google::Apis::ProximitybeaconV1beta1::IndoorLevel, decorator: Google::Apis::ProximitybeaconV1beta1::IndoorLevel::Representation
+      
+          property :expected_stability, as: 'expectedStability'
+          property :description, as: 'description'
+          hash :properties, as: 'properties'
+        end
+      end
+      
+      class AdvertisedId
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :type, as: 'type'
+          property :id, :base64 => true, as: 'id'
+        end
+      end
+      
+      class LatLng
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :latitude, as: 'latitude'
+          property :longitude, as: 'longitude'
+        end
+      end
+      
+      class IndoorLevel
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
+      class Empty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class ListBeaconsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :beacons, as: 'beacons', class: Google::Apis::ProximitybeaconV1beta1::Beacon, decorator: Google::Apis::ProximitybeaconV1beta1::Beacon::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+          property :total_count, as: 'totalCount'
+        end
+      end
+      
+      class BeaconAttachment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attachment_name, as: 'attachmentName'
+          property :namespaced_type, as: 'namespacedType'
+          property :data, :base64 => true, as: 'data'
+        end
+      end
+      
+      class ListBeaconAttachmentsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :attachments, as: 'attachments', class: Google::Apis::ProximitybeaconV1beta1::BeaconAttachment, decorator: Google::Apis::ProximitybeaconV1beta1::BeaconAttachment::Representation
+      
+        end
+      end
+      
+      class DeleteAttachmentsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :num_deleted, as: 'numDeleted'
+        end
+      end
+      
+      class ListNamespacesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :namespaces, as: 'namespaces', class: Google::Apis::ProximitybeaconV1beta1::Namespace, decorator: Google::Apis::ProximitybeaconV1beta1::Namespace::Representation
+      
+        end
+      end
+      
+      class Namespace
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :namespace_name, as: 'namespaceName'
+          property :serving_visibility, as: 'servingVisibility'
+        end
+      end
+      
+      class ListDiagnosticsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :diagnostics, as: 'diagnostics', class: Google::Apis::ProximitybeaconV1beta1::Diagnostics, decorator: Google::Apis::ProximitybeaconV1beta1::Diagnostics::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Diagnostics
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :beacon_name, as: 'beaconName'
+          property :estimated_low_battery_date, as: 'estimatedLowBatteryDate', class: Google::Apis::ProximitybeaconV1beta1::Date, decorator: Google::Apis::ProximitybeaconV1beta1::Date::Representation
+      
+          collection :alerts, as: 'alerts'
+        end
+      end
+      
+      class Date
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :year, as: 'year'
+          property :month, as: 'month'
+          property :day, as: 'day'
+        end
+      end
+      
+      class GetInfoForObservedBeaconsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :observations, as: 'observations', class: Google::Apis::ProximitybeaconV1beta1::Observation, decorator: Google::Apis::ProximitybeaconV1beta1::Observation::Representation
+      
+          collection :namespaced_types, as: 'namespacedTypes'
+        end
+      end
+      
+      class Observation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :advertised_id, as: 'advertisedId', class: Google::Apis::ProximitybeaconV1beta1::AdvertisedId, decorator: Google::Apis::ProximitybeaconV1beta1::AdvertisedId::Representation
+      
+          property :telemetry, :base64 => true, as: 'telemetry'
+          property :timestamp_ms, as: 'timestampMs'
+        end
+      end
+      
+      class GetInfoForObservedBeaconsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :beacons, as: 'beacons', class: Google::Apis::ProximitybeaconV1beta1::BeaconInfo, decorator: Google::Apis::ProximitybeaconV1beta1::BeaconInfo::Representation
+      
+        end
+      end
+      
+      class BeaconInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :advertised_id, as: 'advertisedId', class: Google::Apis::ProximitybeaconV1beta1::AdvertisedId, decorator: Google::Apis::ProximitybeaconV1beta1::AdvertisedId::Representation
+      
+          property :beacon_name, as: 'beaconName'
+          property :description, as: 'description'
+          collection :attachments, as: 'attachments', class: Google::Apis::ProximitybeaconV1beta1::AttachmentInfo, decorator: Google::Apis::ProximitybeaconV1beta1::AttachmentInfo::Representation
+      
+        end
+      end
+      
+      class AttachmentInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :namespaced_type, as: 'namespacedType'
+          property :data, :base64 => true, as: 'data'
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/proximitybeacon_v1beta1/service.rb

@@ -0,0 +1,591 @@
+# 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 '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
+      # Google Proximity Beacon API
+      #
+      # This API provides services to register, manage, index, and search beacons.
+      #
+      # @example
+      #    require 'google/apis/proximitybeacon_v1beta1'
+      #
+      #    Proximitybeacon = Google::Apis::ProximitybeaconV1beta1 # Alias the module
+      #    service = Proximitybeacon::ProximitybeaconService.new
+      #
+      # @see https://developers.google.com/beacons/proximity/
+      class ProximitybeaconService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://proximitybeacon.googleapis.com/', '')
+        end
+        
+        # Registers a previously unregistered beacon given its `advertisedId`. These IDs
+        # are unique within the system. An ID can be registered only once.
+        # @param [Google::Apis::ProximitybeaconV1beta1::Beacon] beacon_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Beacon] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Beacon]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def register_beacon(beacon_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/beacons:register', options)
+          command.request_representation = Google::Apis::ProximitybeaconV1beta1::Beacon::Representation
+          command.request_object = beacon_object
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Beacon::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Beacon
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Decommissions the specified beacon in the service. This beacon will no longer
+        # be returned from `beaconinfo.getforobserved`. This operation is permanent --
+        # you will not be able to re-register a beacon with this ID again.
+        # @param [String] beacon_name
+        #   Beacon that should be decommissioned. Required.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def decommission_beacon(beacon_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/{+beaconName}:decommission', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Empty::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Empty
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns detailed information about the specified beacon.
+        # @param [String] beacon_name
+        #   Beacon that is requested.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Beacon] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Beacon]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_beacon(beacon_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta1/{+beaconName}', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Beacon::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Beacon
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Searches the beacon registry for beacons that match the given search criteria.
+        # Only those beacons that the client has permission to list will be returned.
+        # @param [String] q
+        #   Filter query string that supports the following field filters: * `description:"
+        #   "` For example: `description:"Room 3"` Returns beacons whose description
+        #   matches tokens in the string "Room 3" (not necessarily that exact string). The
+        #   string must be double-quoted. * `status:` For example: `status:active` Returns
+        #   beacons whose status matches the given value. Values must be one of the Beacon.
+        #   Status enum values (case insensitive). Accepts multiple filters which will be
+        #   combined with OR logic. * `stability:` For example: `stability:mobile` Returns
+        #   beacons whose expected stability matches the given value. Values must be one
+        #   of the Beacon.Stability enum values (case insensitive). Accepts multiple
+        #   filters which will be combined with OR logic. * `place_id:""` For example: `
+        #   place_id:"ChIJVSZzVR8FdkgRXGmmm6SslKw="` Returns beacons explicitly registered
+        #   at the given place, expressed as a Place ID obtained from [Google Places API](/
+        #   places/place-id). Does not match places inside the given place. Does not
+        #   consider the beacon's actual location (which may be different from its
+        #   registered place). Accepts multiple filters that will be combined with OR
+        #   logic. The place ID must be double-quoted. * `registration_time[|=]` For
+        #   example: `registration_time>=1433116800` Returns beacons whose registration
+        #   time matches the given filter. Supports the operators: , =. Timestamp must be
+        #   expressed as an integer number of seconds since midnight January 1, 1970 UTC.
+        #   Accepts at most two filters that will be combined with AND logic, to support "
+        #   between" semantics. If more than two are supplied, the latter ones are ignored.
+        #   * `lat: lng: radius:` For example: `lat:51.1232343 lng:-1.093852 radius:1000`
+        #   Returns beacons whose registered location is within the given circle. When any
+        #   of these fields are given, all are required. Latitude and longitude must be
+        #   decimal degrees between -90.0 and 90.0 and between -180.0 and 180.0
+        #   respectively. Radius must be an integer number of meters less than 1,000,000 (
+        #   1000 km). * `property:"="` For example: `property:"battery-type=CR2032"`
+        #   Returns beacons which have a property of the given name and value. Supports
+        #   multiple filters which will be combined with OR logic. The entire name=value
+        #   string must be double-quoted as one string. * `attachment_type:""` For example:
+        #   `attachment_type:"my-namespace/my-type"` Returns beacons having at least one
+        #   attachment of the given namespaced type. Supports "any within this namespace"
+        #   via the partial wildcard syntax: "my-namespace/*". Supports multiple filters
+        #   which will be combined with OR logic. The string must be double-quoted.
+        #   Multiple filters on the same field are combined with OR logic (except
+        #   registration_time which is combined with AND logic). Multiple filters on
+        #   different fields are combined with AND logic. Filters should be separated by
+        #   spaces. As with any HTTP query string parameter, the whole filter expression
+        #   must be URL-encoded. Example REST request: `GET /v1beta1/beacons?q=status:
+        #   active%20lat:51.123%20lng:-1.095%20radius:1000`
+        # @param [String] page_token
+        #   A pagination token obtained from a previous request to list beacons.
+        # @param [Fixnum] page_size
+        #   The maximum number of records to return for this request, up to a server-
+        #   defined upper limit.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::ListBeaconsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::ListBeaconsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_beacons(q: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta1/beacons', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::ListBeaconsResponse::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::ListBeaconsResponse
+          command.query['q'] = q unless q.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the information about the specified beacon. **Any field that you do
+        # not populate in the submitted beacon will be permanently erased**, so you
+        # should follow the "read, modify, write" pattern to avoid inadvertently
+        # destroying data. Changes to the beacon status via this method will be silently
+        # ignored. To update beacon status, use the separate methods on this API for (de)
+        # activation and decommissioning.
+        # @param [String] beacon_name
+        #   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.
+        # @param [Google::Apis::ProximitybeaconV1beta1::Beacon] beacon_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Beacon] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Beacon]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_beacon(beacon_name, beacon_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'v1beta1/{+beaconName}', options)
+          command.request_representation = Google::Apis::ProximitybeaconV1beta1::Beacon::Representation
+          command.request_object = beacon_object
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Beacon::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Beacon
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # (Re)activates a beacon. A beacon that is active will return information and
+        # attachment data when queried via `beaconinfo.getforobserved`. Calling this
+        # method on an already active beacon will do nothing (but will return a
+        # successful response code).
+        # @param [String] beacon_name
+        #   The beacon to activate. Required.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def activate_beacon(beacon_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/{+beaconName}:activate', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Empty::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Empty
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deactivates a beacon. Once deactivated, the API will not return information
+        # nor attachment data for the beacon when queried via `beaconinfo.getforobserved`
+        # . Calling this method on an already inactive beacon will do nothing (but will
+        # return a successful response code).
+        # @param [String] beacon_name
+        #   The beacon name of this beacon.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def deactivate_beacon(beacon_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/{+beaconName}:deactivate', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Empty::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Empty
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Associates the given data with the specified beacon. Attachment data must
+        # contain two parts:
+        # - A namespaced type.
+        # - The actual attachment data itself.  The namespaced type consists of two
+        # parts, the namespace and the type. The namespace must be one of the values
+        # returned by the `namespaces` endpoint, while the type can be a string of any
+        # characters except for the forward slash (`/`) up to 100 characters in length.
+        # Attachment data can be up to 1024 bytes long.
+        # @param [String] beacon_name
+        #   The beacon on which the attachment should be created. Required.
+        # @param [Google::Apis::ProximitybeaconV1beta1::BeaconAttachment] beacon_attachment_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::BeaconAttachment] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::BeaconAttachment]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_beacon_attachment(beacon_name, beacon_attachment_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/{+beaconName}/attachments', options)
+          command.request_representation = Google::Apis::ProximitybeaconV1beta1::BeaconAttachment::Representation
+          command.request_object = beacon_attachment_object
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::BeaconAttachment::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::BeaconAttachment
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns the attachments for the specified beacon that match the specified
+        # namespaced-type pattern. To control which namespaced types are returned, you
+        # add the `namespacedType` query parameter to the request. You must either use `*
+        # /*`, to return all attachments, or the namespace must be one of the ones
+        # returned from the `namespaces` endpoint.
+        # @param [String] beacon_name
+        #   The beacon whose attachments are to be fetched. Required.
+        # @param [String] namespaced_type
+        #   Specifies the namespace and type of attachment to include in response in
+        #   namespace/type format. Accepts `*/*` to specify "all types in all namespaces".
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::ListBeaconAttachmentsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::ListBeaconAttachmentsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_beacon_attachments(beacon_name, namespaced_type: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta1/{+beaconName}/attachments', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::ListBeaconAttachmentsResponse::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::ListBeaconAttachmentsResponse
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['namespacedType'] = namespaced_type unless namespaced_type.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes the specified attachment for the given beacon. Each attachment has a
+        # unique attachment name (`attachmentName`) which is returned when you fetch the
+        # attachment data via this API. You specify this with the delete request to
+        # control which attachment is removed. This operation cannot be undone.
+        # @param [String] attachment_name
+        #   The attachment name (`attachmentName`) of the attachment to remove. For
+        #   example: `beacons/3!893737abc9/attachments/c5e937-af0-494-959-ec49d12738`
+        #   Required.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_beacon_attachment(attachment_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1beta1/{+attachmentName}', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::Empty::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::Empty
+          command.params['attachmentName'] = attachment_name unless attachment_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes multiple attachments on a given beacon. This operation is permanent
+        # and cannot be undone. You can optionally specify `namespacedType` to choose
+        # which attachments should be deleted. If you do not specify `namespacedType`,
+        # all your attachments on the given beacon will be deleted. You also may
+        # explicitly specify `*/*` to delete all.
+        # @param [String] beacon_name
+        #   The beacon whose attachments are to be deleted. Required.
+        # @param [String] namespaced_type
+        #   Specifies the namespace and type of attachments to delete in `namespace/type`
+        #   format. Accepts `*/*` to specify "all types in all namespaces". Optional.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::DeleteAttachmentsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::DeleteAttachmentsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def batch_beacon_attachment_delete(beacon_name, namespaced_type: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/{+beaconName}/attachments:batchDelete', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::DeleteAttachmentsResponse::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::DeleteAttachmentsResponse
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['namespacedType'] = namespaced_type unless namespaced_type.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List the diagnostics for a single beacon. You can also list diagnostics for
+        # all the beacons owned by your Google Developers Console project by using the
+        # beacon name `beacons/-`.
+        # @param [String] beacon_name
+        #   Beacon that the diagnostics are for.
+        # @param [Fixnum] page_size
+        #   Specifies the maximum number of results to return. Defaults to 10. Maximum
+        #   1000. Optional.
+        # @param [String] page_token
+        #   Requests results that occur after the `page_token`, obtained from the response
+        #   to a previous request. Optional.
+        # @param [String] alert_filter
+        #   Requests only beacons that have the given alert. For example, to find beacons
+        #   that have low batteries use `alert_filter=LOW_BATTERY`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::ListDiagnosticsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::ListDiagnosticsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_beacon_diagnostics(beacon_name, page_size: nil, page_token: nil, alert_filter: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta1/{+beaconName}/diagnostics', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::ListDiagnosticsResponse::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::ListDiagnosticsResponse
+          command.params['beaconName'] = beacon_name unless beacon_name.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['alertFilter'] = alert_filter unless alert_filter.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all attachment namespaces owned by your Google Developers Console
+        # project. Attachment data associated with a beacon must include a namespaced
+        # type, and the namespace must be owned by your project.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::ListNamespacesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::ListNamespacesResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_namespaces(fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1beta1/namespaces', options)
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::ListNamespacesResponse::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::ListNamespacesResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Given one or more beacon observations, returns any beacon information and
+        # attachments accessible to your application.
+        # @param [Google::Apis::ProximitybeaconV1beta1::GetInfoForObservedBeaconsRequest] get_info_for_observed_beacons_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ProximitybeaconV1beta1::GetInfoForObservedBeaconsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProximitybeaconV1beta1::GetInfoForObservedBeaconsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def getforobserved_beaconinfo(get_info_for_observed_beacons_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1beta1/beaconinfo:getforobserved', options)
+          command.request_representation = Google::Apis::ProximitybeaconV1beta1::GetInfoForObservedBeaconsRequest::Representation
+          command.request_object = get_info_for_observed_beacons_request_object
+          command.response_representation = Google::Apis::ProximitybeaconV1beta1::GetInfoForObservedBeaconsResponse::Representation
+          command.response_class = Google::Apis::ProximitybeaconV1beta1::GetInfoForObservedBeaconsResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end