Network.Google.Resource.ProximityBeacon.Beacons.List

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. Authenticate using an OAuth access token from a signed-in user with **viewer**, **Is owner** or **Can edit** permissions in the Google Developers Console project.

See: Google Proximity Beacon API Reference for proximitybeacon.beacons.list.

REST Resource

type BeaconsListResource = "v1beta1" :> ("beacons" :> (QueryParam "$.xgafv" Text :> (QueryParam "upload_protocol" Text :> (QueryParam "pp" Bool :> (QueryParam "access_token" Text :> (QueryParam "uploadType" Text :> (QueryParam "q" Text :> (QueryParam "bearer_token" Text :> (QueryParam "pageToken" Text :> (QueryParam "projectId" Text :> (QueryParam "pageSize" (Textual Int32) :> (QueryParam "callback" Text :> (QueryParam "alt" AltJSON :> Get '[JSON] ListBeaconsResponse)))))))))))))

A resource alias for proximitybeacon.beacons.list method which the BeaconsList request conforms to.

Creating a Request

beaconsList :: BeaconsList

Creates a value of BeaconsList with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• blXgafv
• blUploadProtocol
• blPp
• blAccessToken
• blUploadType
• blQ
• blBearerToken
• blPageToken
• blProjectId
• blPageSize
• blCallback

data BeaconsList

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. Authenticate using an OAuth access token from a signed-in user with **viewer**, **Is owner** or **Can edit** permissions in the Google Developers Console project.

See: beaconsList smart constructor.

Instances

Eq BeaconsList

Methods

(==) :: BeaconsList -> BeaconsList -> Bool

(/=) :: BeaconsList -> BeaconsList -> Bool

Data BeaconsList

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> BeaconsList -> c BeaconsList

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c BeaconsList

toConstr :: BeaconsList -> Constr

dataTypeOf :: BeaconsList -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c BeaconsList)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c BeaconsList)

gmapT :: (forall b. Data b => b -> b) -> BeaconsList -> BeaconsList

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> BeaconsList -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> BeaconsList -> r

gmapQ :: (forall d. Data d => d -> u) -> BeaconsList -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> BeaconsList -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> BeaconsList -> m BeaconsList

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> BeaconsList -> m BeaconsList

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> BeaconsList -> m BeaconsList

Show BeaconsList

Methods

showsPrec :: Int -> BeaconsList -> ShowS

show :: BeaconsList -> String

showList :: [BeaconsList] -> ShowS

Generic BeaconsList

Associated Types

type Rep BeaconsList :: * -> *

Methods

from :: BeaconsList -> Rep BeaconsList x

to :: Rep BeaconsList x -> BeaconsList

GoogleRequest BeaconsList

Associated Types

type Rs BeaconsList :: *

type Scopes BeaconsList :: [Symbol]

Methods

requestClient :: BeaconsList -> Client (Rs BeaconsList)

type Rep BeaconsList

type Rep BeaconsList = D1 (MetaData "BeaconsList" "Network.Google.Resource.ProximityBeacon.Beacons.List" "gogol-proximitybeacon-0.1.1-GrTXM8v1LnxEo3VfozzFv1" False) (C1 (MetaCons "BeaconsList'" PrefixI True) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_blXgafv") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_blUploadProtocol") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_blPp") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Bool)) ((:*:) (S1 (MetaSel (Just Symbol "_blAccessToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_blUploadType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_blQ") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_blBearerToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_blPageToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) (S1 (MetaSel (Just Symbol "_blProjectId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_blPageSize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (Textual Int32)))) (S1 (MetaSel (Just Symbol "_blCallback") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))))))

type Scopes BeaconsList

type Scopes BeaconsList = (:) Symbol "https://www.googleapis.com/auth/userlocation.beacon.registry" ([] Symbol)

type Rs BeaconsList

type Rs BeaconsList = ListBeaconsResponse

Request Lenses

blXgafv :: Lens' BeaconsList (Maybe Text)

V1 error format.

blUploadProtocol :: Lens' BeaconsList (Maybe Text)

Upload protocol for media (e.g. "raw", "multipart").

blPp :: Lens' BeaconsList Bool

Pretty-print response.

blAccessToken :: Lens' BeaconsList (Maybe Text)

OAuth access token.

blUploadType :: Lens' BeaconsList (Maybe Text)

Legacy upload protocol for media (e.g. "media", "multipart").

blQ :: Lens' BeaconsList (Maybe Text)

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. 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 between 10 and 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`

blBearerToken :: Lens' BeaconsList (Maybe Text)

OAuth bearer token.

blPageToken :: Lens' BeaconsList (Maybe Text)

A pagination token obtained from a previous request to list beacons.

blProjectId :: Lens' BeaconsList (Maybe Text)

The project id to list beacons under. If not present then the project credential that made the request is used as the project. Optional.

blPageSize :: Lens' BeaconsList (Maybe Int32)

The maximum number of records to return for this request, up to a server-defined upper limit.

blCallback :: Lens' BeaconsList (Maybe Text)

JSONP