OLD | NEW |
1 { | 1 { |
2 "auth": { | 2 "auth": { |
3 "oauth2": { | 3 "oauth2": { |
4 "scopes": { | 4 "scopes": { |
5 "https://www.googleapis.com/auth/userlocation.beacon.registry":
{ | 5 "https://www.googleapis.com/auth/userlocation.beacon.registry":
{ |
6 "description": "View and modify your beacons" | 6 "description": "View and modify your beacons" |
7 } | 7 } |
8 } | 8 } |
9 } | 9 } |
10 }, | 10 }, |
11 "basePath": "", | 11 "basePath": "", |
12 "baseUrl": "https://proximitybeacon.googleapis.com/", | 12 "baseUrl": "https://proximitybeacon.googleapis.com/", |
13 "batchPath": "batch", | 13 "batchPath": "batch", |
14 "description": "Registers, manages, indexes, and searches beacons.", | 14 "description": "Registers, manages, indexes, and searches beacons.", |
15 "discoveryVersion": "v1", | 15 "discoveryVersion": "v1", |
16 "documentationLink": "https://developers.google.com/beacons/proximity/", | 16 "documentationLink": "https://developers.google.com/beacons/proximity/", |
17 "icons": { | 17 "icons": { |
18 "x16": "http://www.google.com/images/icons/product/search-16.gif", | 18 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
19 "x32": "http://www.google.com/images/icons/product/search-32.gif" | 19 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
20 }, | 20 }, |
21 "id": "proximitybeacon:v1beta1", | 21 "id": "proximitybeacon:v1beta1", |
22 "kind": "discovery#restDescription", | 22 "kind": "discovery#restDescription", |
23 "name": "proximitybeacon", | 23 "name": "proximitybeacon", |
24 "ownerDomain": "google.com", | 24 "ownerDomain": "google.com", |
25 "ownerName": "Google", | 25 "ownerName": "Google", |
26 "parameters": { | 26 "parameters": { |
| 27 "access_token": { |
| 28 "description": "OAuth access token.", |
| 29 "location": "query", |
| 30 "type": "string" |
| 31 }, |
| 32 "key": { |
| 33 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", |
| 34 "location": "query", |
| 35 "type": "string" |
| 36 }, |
27 "quotaUser": { | 37 "quotaUser": { |
28 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", | 38 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", |
29 "location": "query", | 39 "location": "query", |
30 "type": "string" | 40 "type": "string" |
31 }, | 41 }, |
32 "pp": { | 42 "pp": { |
33 "default": "true", | 43 "default": "true", |
34 "description": "Pretty-print response.", | 44 "description": "Pretty-print response.", |
35 "location": "query", | 45 "location": "query", |
36 "type": "boolean" | 46 "type": "boolean" |
37 }, | 47 }, |
| 48 "bearer_token": { |
| 49 "description": "OAuth bearer token.", |
| 50 "location": "query", |
| 51 "type": "string" |
| 52 }, |
38 "oauth_token": { | 53 "oauth_token": { |
39 "description": "OAuth 2.0 token for the current user.", | 54 "description": "OAuth 2.0 token for the current user.", |
40 "location": "query", | 55 "location": "query", |
41 "type": "string" | 56 "type": "string" |
42 }, | 57 }, |
43 "bearer_token": { | |
44 "description": "OAuth bearer token.", | |
45 "location": "query", | |
46 "type": "string" | |
47 }, | |
48 "upload_protocol": { | 58 "upload_protocol": { |
49 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 59 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
50 "location": "query", | 60 "location": "query", |
51 "type": "string" | 61 "type": "string" |
52 }, | 62 }, |
53 "prettyPrint": { | 63 "prettyPrint": { |
54 "default": "true", | 64 "default": "true", |
55 "description": "Returns response with indentations and line breaks."
, | 65 "description": "Returns response with indentations and line breaks."
, |
56 "location": "query", | 66 "location": "query", |
57 "type": "boolean" | 67 "type": "boolean" |
58 }, | 68 }, |
| 69 "uploadType": { |
| 70 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", |
| 71 "location": "query", |
| 72 "type": "string" |
| 73 }, |
59 "fields": { | 74 "fields": { |
60 "description": "Selector specifying which fields to include in a par
tial response.", | 75 "description": "Selector specifying which fields to include in a par
tial response.", |
61 "location": "query", | 76 "location": "query", |
62 "type": "string" | 77 "type": "string" |
63 }, | 78 }, |
64 "uploadType": { | |
65 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", | |
66 "location": "query", | |
67 "type": "string" | |
68 }, | |
69 "callback": { | |
70 "description": "JSONP", | |
71 "location": "query", | |
72 "type": "string" | |
73 }, | |
74 "$.xgafv": { | 79 "$.xgafv": { |
75 "description": "V1 error format.", | 80 "description": "V1 error format.", |
76 "enum": [ | 81 "enum": [ |
77 "1", | 82 "1", |
78 "2" | 83 "2" |
79 ], | 84 ], |
80 "enumDescriptions": [ | 85 "enumDescriptions": [ |
81 "v1 error format", | 86 "v1 error format", |
82 "v2 error format" | 87 "v2 error format" |
83 ], | 88 ], |
84 "location": "query", | 89 "location": "query", |
85 "type": "string" | 90 "type": "string" |
86 }, | 91 }, |
| 92 "callback": { |
| 93 "description": "JSONP", |
| 94 "location": "query", |
| 95 "type": "string" |
| 96 }, |
87 "alt": { | 97 "alt": { |
88 "default": "json", | 98 "default": "json", |
89 "description": "Data format for response.", | 99 "description": "Data format for response.", |
90 "enum": [ | 100 "enum": [ |
91 "json", | 101 "json", |
92 "media", | 102 "media", |
93 "proto" | 103 "proto" |
94 ], | 104 ], |
95 "enumDescriptions": [ | 105 "enumDescriptions": [ |
96 "Responses with Content-Type of application/json", | 106 "Responses with Content-Type of application/json", |
97 "Media download with context-dependent Content-Type", | 107 "Media download with context-dependent Content-Type", |
98 "Responses with Content-Type of application/x-protobuf" | 108 "Responses with Content-Type of application/x-protobuf" |
99 ], | 109 ], |
100 "location": "query", | 110 "location": "query", |
101 "type": "string" | 111 "type": "string" |
102 }, | |
103 "access_token": { | |
104 "description": "OAuth access token.", | |
105 "location": "query", | |
106 "type": "string" | |
107 }, | |
108 "key": { | |
109 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", | |
110 "location": "query", | |
111 "type": "string" | |
112 } | 112 } |
113 }, | 113 }, |
114 "protocol": "rest", | 114 "protocol": "rest", |
115 "resources": { | 115 "resources": { |
116 "beaconinfo": { | 116 "beaconinfo": { |
117 "methods": { | 117 "methods": { |
118 "getforobserved": { | 118 "getforobserved": { |
119 "description": "Given one or more beacon observations, retur
ns any beacon information\nand attachments accessible to your application. Autho
rize by using the\n[API key](https://developers.google.com/beacons/proximity/get
-started#request_a_browser_api_key)\nfor the application.", | 119 "description": "Given one or more beacon observations, retur
ns any beacon information\nand attachments accessible to your application. Autho
rize by using the\n[API key](https://developers.google.com/beacons/proximity/get
-started#request_a_browser_api_key)\nfor the application.", |
120 "httpMethod": "POST", | 120 "httpMethod": "POST", |
121 "id": "proximitybeacon.beaconinfo.getforobserved", | 121 "id": "proximitybeacon.beaconinfo.getforobserved", |
(...skipping 12 matching lines...) Expand all Loading... |
134 "namespaces": { | 134 "namespaces": { |
135 "methods": { | 135 "methods": { |
136 "update": { | 136 "update": { |
137 "description": "Updates the information about the specified
namespace. Only the namespace\nvisibility can be updated.", | 137 "description": "Updates the information about the specified
namespace. Only the namespace\nvisibility can be updated.", |
138 "httpMethod": "PUT", | 138 "httpMethod": "PUT", |
139 "id": "proximitybeacon.namespaces.update", | 139 "id": "proximitybeacon.namespaces.update", |
140 "parameterOrder": [ | 140 "parameterOrder": [ |
141 "namespaceName" | 141 "namespaceName" |
142 ], | 142 ], |
143 "parameters": { | 143 "parameters": { |
144 "projectId": { | |
145 "description": "The project id of the namespace to u
pdate. If the project id is not\nspecified then the project making the request i
s used. The project id\nmust match the project that owns the beacon.\nOptional."
, | |
146 "location": "query", | |
147 "type": "string" | |
148 }, | |
149 "namespaceName": { | 144 "namespaceName": { |
150 "description": "Resource name of this namespace. Nam
espaces names have the format:\n<code>namespaces/<var>namespace</var></code>.", | 145 "description": "Resource name of this namespace. Nam
espaces names have the format:\n<code>namespaces/<var>namespace</var></code>.", |
151 "location": "path", | 146 "location": "path", |
152 "pattern": "^namespaces/[^/]+$", | 147 "pattern": "^namespaces/[^/]+$", |
153 "required": true, | 148 "required": true, |
154 "type": "string" | 149 "type": "string" |
| 150 }, |
| 151 "projectId": { |
| 152 "description": "The project id of the namespace to u
pdate. If the project id is not\nspecified then the project making the request i
s used. The project id\nmust match the project that owns the beacon.\nOptional."
, |
| 153 "location": "query", |
| 154 "type": "string" |
155 } | 155 } |
156 }, | 156 }, |
157 "path": "v1beta1/{+namespaceName}", | 157 "path": "v1beta1/{+namespaceName}", |
158 "request": { | 158 "request": { |
159 "$ref": "Namespace" | 159 "$ref": "Namespace" |
160 }, | 160 }, |
161 "response": { | 161 "response": { |
162 "$ref": "Namespace" | 162 "$ref": "Namespace" |
163 }, | 163 }, |
164 "scopes": [ | 164 "scopes": [ |
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
200 "$ref": "EphemeralIdRegistrationParams" | 200 "$ref": "EphemeralIdRegistrationParams" |
201 }, | 201 }, |
202 "scopes": [ | 202 "scopes": [ |
203 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | 203 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
204 ] | 204 ] |
205 } | 205 } |
206 } | 206 } |
207 }, | 207 }, |
208 "beacons": { | 208 "beacons": { |
209 "methods": { | 209 "methods": { |
210 "deactivate": { | 210 "activate": { |
211 "description": "Deactivates a beacon. Once deactivated, the
API will not return\ninformation nor attachment data for the beacon when queried
via\n`beaconinfo.getforobserved`. Calling this method on an already inactive\nb
eacon will do nothing (but will return a successful response code).\n\nAuthentic
ate using an [OAuth access token](https://developers.google.com/identity/protoco
ls/OAuth2)\nfrom a signed-in user with **Is owner** or **Can edit** permissions
in the\nGoogle Developers Console project.", | 211 "description": "Activates a beacon. A beacon that is active
will return information\nand attachment data when queried via `beaconinfo.getfor
observed`.\nCalling this method on an already active beacon will do nothing (but
\nwill return a successful response code).\n\nAuthenticate using an [OAuth acces
s token](https://developers.google.com/identity/protocols/OAuth2)\nfrom a signed
-in user with **Is owner** or **Can edit** permissions in the\nGoogle Developers
Console project.", |
212 "httpMethod": "POST", | 212 "httpMethod": "POST", |
213 "id": "proximitybeacon.beacons.deactivate", | 213 "id": "proximitybeacon.beacons.activate", |
214 "parameterOrder": [ | 214 "parameterOrder": [ |
215 "beaconName" | 215 "beaconName" |
216 ], | 216 ], |
217 "parameters": { | 217 "parameters": { |
| 218 "projectId": { |
| 219 "description": "The project id of the beacon to acti
vate. If the project id is not\nspecified then the project making the request is
used. The project id\nmust match the project that owns the beacon.\nOptional.", |
| 220 "location": "query", |
| 221 "type": "string" |
| 222 }, |
218 "beaconName": { | 223 "beaconName": { |
219 "description": "Beacon that should be deactivated. A
beacon name has the format\n\"beacons/N!beaconId\" where the beaconId is the ba
se16 ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible
values are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `
5`\nfor AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EI
D or the beacon's \"stable\" UID.\nRequired.", | 224 "description": "Beacon that should be activated. A b
eacon name has the format\n\"beacons/N!beaconId\" where the beaconId is the base
16 ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible v
alues are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `5`
\nfor AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EID
or the beacon's \"stable\" UID.\nRequired.", |
220 "location": "path", | 225 "location": "path", |
221 "pattern": "^beacons/[^/]+$", | 226 "pattern": "^beacons/[^/]+$", |
222 "required": true, | 227 "required": true, |
223 "type": "string" | 228 "type": "string" |
224 }, | |
225 "projectId": { | |
226 "description": "The project id of the beacon to deac
tivate. If the project id is not\nspecified then the project making the request
is used. The project id must\nmatch the project that owns the beacon.\nOptional.
", | |
227 "location": "query", | |
228 "type": "string" | |
229 } | 229 } |
230 }, | 230 }, |
231 "path": "v1beta1/{+beaconName}:deactivate", | 231 "path": "v1beta1/{+beaconName}:activate", |
232 "response": { | 232 "response": { |
233 "$ref": "Empty" | 233 "$ref": "Empty" |
234 }, | 234 }, |
235 "scopes": [ | 235 "scopes": [ |
236 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | 236 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
237 ] | 237 ] |
238 }, | 238 }, |
239 "delete": { | 239 "get": { |
240 "description": "Deletes the specified beacon including all d
iagnostics data for the beacon\nas well as any attachments on the beacon (includ
ing those belonging to\nother projects). This operation cannot be undone.\n\nAut
henticate using an [OAuth access token](https://developers.google.com/identity/p
rotocols/OAuth2)\nfrom a signed-in user with **Is owner** or **Can edit** permis
sions in the\nGoogle Developers Console project.", | 240 "description": "Returns detailed information about the speci
fied beacon.\n\nAuthenticate using an [OAuth access token](https://developers.go
ogle.com/identity/protocols/OAuth2)\nfrom a signed-in user with **viewer**, **Is
owner** or **Can edit**\npermissions in the Google Developers Console project.\
n\nRequests may supply an Eddystone-EID beacon name in the form:\n`beacons/4!bea
conId` where the `beaconId` is the base16 ephemeral ID\nbroadcast by the beacon.
The returned `Beacon` object will contain the\nbeacon's stable Eddystone-UID. C
lients not authorized to resolve the\nbeacon's ephemeral Eddystone-EID broadcast
will receive an error.", |
241 "httpMethod": "DELETE", | 241 "httpMethod": "GET", |
242 "id": "proximitybeacon.beacons.delete", | 242 "id": "proximitybeacon.beacons.get", |
| 243 "parameterOrder": [ |
| 244 "beaconName" |
| 245 ], |
| 246 "parameters": { |
| 247 "beaconName": { |
| 248 "description": "Resource name of this beacon. A beac
on name has the format\n\"beacons/N!beaconId\" where the beaconId is the base16
ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible valu
es are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `5`\nf
or AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EID or
the beacon's \"stable\" UID.\nRequired.", |
| 249 "location": "path", |
| 250 "pattern": "^beacons/[^/]+$", |
| 251 "required": true, |
| 252 "type": "string" |
| 253 }, |
| 254 "projectId": { |
| 255 "description": "The project id of the beacon to requ
est. If the project id is not specified\nthen the project making the request is
used. The project id must match the\nproject that owns the beacon.\nOptional.", |
| 256 "location": "query", |
| 257 "type": "string" |
| 258 } |
| 259 }, |
| 260 "path": "v1beta1/{+beaconName}", |
| 261 "response": { |
| 262 "$ref": "Beacon" |
| 263 }, |
| 264 "scopes": [ |
| 265 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
| 266 ] |
| 267 }, |
| 268 "update": { |
| 269 "description": "Updates the information about the specified
beacon. **Any field that you do\nnot populate in the submitted beacon will be pe
rmanently erased**, so you\nshould follow the \"read, modify, write\" pattern to
avoid inadvertently\ndestroying data.\n\nChanges to the beacon status via this
method will be silently ignored.\nTo update beacon status, use the separate met
hods on this API for\nactivation, deactivation, and decommissioning.\nAuthentica
te using an [OAuth access token](https://developers.google.com/identity/protocol
s/OAuth2)\nfrom a signed-in user with **Is owner** or **Can edit** permissions i
n the\nGoogle Developers Console project.", |
| 270 "httpMethod": "PUT", |
| 271 "id": "proximitybeacon.beacons.update", |
243 "parameterOrder": [ | 272 "parameterOrder": [ |
244 "beaconName" | 273 "beaconName" |
245 ], | 274 ], |
246 "parameters": { | 275 "parameters": { |
247 "projectId": { | 276 "projectId": { |
248 "description": "The project id of the beacon to dele
te. If not provided, the project\nthat is making the request is used.\nOptional.
", | 277 "description": "The project id of the beacon to upda
te. If the project id is not\nspecified then the project making the request is u
sed. The project id\nmust match the project that owns the beacon.\nOptional.", |
249 "location": "query", | 278 "location": "query", |
250 "type": "string" | 279 "type": "string" |
251 }, | 280 }, |
252 "beaconName": { | 281 "beaconName": { |
253 "description": "Beacon that should be deleted. A bea
con name has the format\n\"beacons/N!beaconId\" where the beaconId is the base16
ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible val
ues are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `5`\n
for AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EID or
the beacon's \"stable\" UID.\nRequired.", | 282 "description": "Resource name of this beacon. A beac
on name has the format\n\"beacons/N!beaconId\" where the beaconId is the base16
ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible valu
es are\n`3` for Eddystone, `1` for iBeacon, or `5` for AltBeacon.\n\nThis field
must be left empty when registering. After reading a beacon,\nclients can use th
e name for future operations.", |
254 "location": "path", | 283 "location": "path", |
255 "pattern": "^beacons/[^/]+$", | 284 "pattern": "^beacons/[^/]+$", |
256 "required": true, | 285 "required": true, |
257 "type": "string" | 286 "type": "string" |
258 } | 287 } |
259 }, | 288 }, |
260 "path": "v1beta1/{+beaconName}", | 289 "path": "v1beta1/{+beaconName}", |
261 "response": { | |
262 "$ref": "Empty" | |
263 }, | |
264 "scopes": [ | |
265 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | |
266 ] | |
267 }, | |
268 "register": { | |
269 "description": "Registers a previously unregistered beacon g
iven its `advertisedId`.\nThese IDs are unique within the system. An ID can be r
egistered only once.\n\nAuthenticate using an [OAuth access token](https://devel
opers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user with **Is own
er** or **Can edit** permissions in the\nGoogle Developers Console project.", | |
270 "httpMethod": "POST", | |
271 "id": "proximitybeacon.beacons.register", | |
272 "parameterOrder": [], | |
273 "parameters": { | |
274 "projectId": { | |
275 "description": "The project id of the project the be
acon will be registered to. If\nthe project id is not specified then the project
making the request\nis used.\nOptional.", | |
276 "location": "query", | |
277 "type": "string" | |
278 } | |
279 }, | |
280 "path": "v1beta1/beacons:register", | |
281 "request": { | 290 "request": { |
282 "$ref": "Beacon" | 291 "$ref": "Beacon" |
283 }, | 292 }, |
284 "response": { | 293 "response": { |
285 "$ref": "Beacon" | 294 "$ref": "Beacon" |
286 }, | 295 }, |
287 "scopes": [ | 296 "scopes": [ |
288 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | 297 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
289 ] | 298 ] |
290 }, | 299 }, |
291 "list": { | 300 "decommission": { |
292 "description": "Searches the beacon registry for beacons tha
t match the given search\ncriteria. Only those beacons that the client has permi
ssion to list\nwill be returned.\n\nAuthenticate using an [OAuth access token](h
ttps://developers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user w
ith **viewer**, **Is owner** or **Can edit**\npermissions in the Google Develope
rs Console project.", | 301 "description": "Decommissions the specified beacon in the se
rvice. This beacon will no\nlonger be returned from `beaconinfo.getforobserved`.
This operation is\npermanent -- you will not be able to re-register a beacon wi
th this ID\nagain.\n\nAuthenticate using an [OAuth access token](https://develop
ers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user with **Is owner
** or **Can edit** permissions in the\nGoogle Developers Console project.", |
293 "httpMethod": "GET", | |
294 "id": "proximitybeacon.beacons.list", | |
295 "parameterOrder": [], | |
296 "parameters": { | |
297 "pageToken": { | |
298 "description": "A pagination token obtained from a p
revious request to list beacons.", | |
299 "location": "query", | |
300 "type": "string" | |
301 }, | |
302 "pageSize": { | |
303 "description": "The maximum number of records to ret
urn for this request, up to a\nserver-defined upper limit.", | |
304 "format": "int32", | |
305 "location": "query", | |
306 "type": "integer" | |
307 }, | |
308 "q": { | |
309 "description": "Filter query string that supports th
e following field filters:\n\n* **description:`\"<string>\"`**\n For example: *
*description:\"Room 3\"**\n Returns beacons whose description matches tokens in
the string \"Room 3\"\n (not necessarily that exact string).\n The string mus
t be double-quoted.\n* **status:`<enum>`**\n For example: **status:active**\n
Returns beacons whose status matches the given value. Values must be\n one of t
he Beacon.Status enum values (case insensitive). Accepts\n multiple filters whi
ch will be combined with OR logic.\n* **stability:`<enum>`**\n For example: **s
tability:mobile**\n Returns beacons whose expected stability matches the given
value.\n Values must be one of the Beacon.Stability enum values (case\n insens
itive). Accepts multiple filters which will be combined with\n OR logic.\n* **p
lace\\_id:`\"<string>\"`**\n For example: **place\\_id:\"ChIJVSZzVR8FdkgRXGmmm6
SslKw=\"**\n Returns beacons explicitly registered at the given place, expresse
d as\n a Place ID obtained from [Google Places API](/places/place-id). Does not
\n match places inside the given place. Does not consider the beacon's\n actua
l location (which may be different from its registered place).\n Accepts multip
le filters that will be combined with OR logic. The place\n ID must be double-q
uoted.\n* **registration\\_time`[<|>|<=|>=]<integer>`**\n For example: **regist
ration\\_time>=1433116800**\n Returns beacons whose registration time matches t
he given filter.\n Supports the operators: <, >, <=, and >=. Timestamp must be
expressed as\n an integer number of seconds since midnight January 1, 1970 UTC.
Accepts\n at most two filters that will be combined with AND logic, to support
\n \"between\" semantics. If more than two are supplied, the latter ones are\n
ignored.\n* **lat:`<double> lng:<double> radius:<integer>`**\n For example: **
lat:51.1232343 lng:-1.093852 radius:1000**\n Returns beacons whose registered l
ocation is within the given circle.\n When any of these fields are given, all a
re required. Latitude and\n longitude must be decimal degrees between -90.0 and
90.0 and between\n -180.0 and 180.0 respectively. Radius must be an integer nu
mber of\n meters between 10 and 1,000,000 (1000 km).\n* **property:`\"<string>=
<string>\"`**\n For example: **property:\"battery-type=CR2032\"**\n Returns be
acons which have a property of the given name and value.\n Supports multiple fi
lters which will be combined with OR logic.\n The entire name=value string must
be double-quoted as one string.\n* **attachment\\_type:`\"<string>\"`**\n For
example: **attachment_type:\"my-namespace/my-type\"**\n Returns beacons having
at least one attachment of the given namespaced\n type. Supports \"any within t
his namespace\" via the partial wildcard\n syntax: \"my-namespace/*\". Supports
multiple filters which will be\n combined with OR logic. The string must be do
uble-quoted.\n* **indoor\\_level:`\"<string>\"`**\n For example: **indoor\\_lev
el:\"1\"**\n Returns beacons which are located on the given indoor level. Accep
ts\n multiple filters that will be combined with OR logic.\n\nMultiple filters
on the same field are combined with OR logic (except\nregistration_time which is
combined with AND logic).\nMultiple filters on different fields are combined wi
th AND logic.\nFilters should be separated by spaces.\n\nAs with any HTTP query
string parameter, the whole filter expression must\nbe URL-encoded.\n\nExample R
EST request:\n`GET /v1beta1/beacons?q=status:active%20lat:51.123%20lng:-1.095%20
radius:1000`", | |
310 "location": "query", | |
311 "type": "string" | |
312 }, | |
313 "projectId": { | |
314 "description": "The project id to list beacons under
. If not present then the project\ncredential that made the request is used as t
he project.\nOptional.", | |
315 "location": "query", | |
316 "type": "string" | |
317 } | |
318 }, | |
319 "path": "v1beta1/beacons", | |
320 "response": { | |
321 "$ref": "ListBeaconsResponse" | |
322 }, | |
323 "scopes": [ | |
324 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | |
325 ] | |
326 }, | |
327 "activate": { | |
328 "description": "Activates a beacon. A beacon that is active
will return information\nand attachment data when queried via `beaconinfo.getfor
observed`.\nCalling this method on an already active beacon will do nothing (but
\nwill return a successful response code).\n\nAuthenticate using an [OAuth acces
s token](https://developers.google.com/identity/protocols/OAuth2)\nfrom a signed
-in user with **Is owner** or **Can edit** permissions in the\nGoogle Developers
Console project.", | |
329 "httpMethod": "POST", | 302 "httpMethod": "POST", |
330 "id": "proximitybeacon.beacons.activate", | 303 "id": "proximitybeacon.beacons.decommission", |
331 "parameterOrder": [ | 304 "parameterOrder": [ |
332 "beaconName" | 305 "beaconName" |
333 ], | 306 ], |
334 "parameters": { | 307 "parameters": { |
335 "beaconName": { | 308 "beaconName": { |
336 "description": "Beacon that should be activated. A b
eacon name has the format\n\"beacons/N!beaconId\" where the beaconId is the base
16 ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible v
alues are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `5`
\nfor AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EID
or the beacon's \"stable\" UID.\nRequired.", | 309 "description": "Beacon that should be decommissioned
. A beacon name has the format\n\"beacons/N!beaconId\" where the beaconId is the
base16 ID broadcast by\nthe beacon and N is a code for the beacon's type. Possi
ble values are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, o
r `5`\nfor AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent
EID of the beacon's \"stable\" UID.\nRequired.", |
337 "location": "path", | 310 "location": "path", |
338 "pattern": "^beacons/[^/]+$", | 311 "pattern": "^beacons/[^/]+$", |
339 "required": true, | 312 "required": true, |
340 "type": "string" | 313 "type": "string" |
341 }, | 314 }, |
342 "projectId": { | 315 "projectId": { |
343 "description": "The project id of the beacon to acti
vate. If the project id is not\nspecified then the project making the request is
used. The project id\nmust match the project that owns the beacon.\nOptional.", | 316 "description": "The project id of the beacon to deco
mmission. If the project id is not\nspecified then the project making the reques
t is used. The project id\nmust match the project that owns the beacon.\nOptiona
l.", |
344 "location": "query", | 317 "location": "query", |
345 "type": "string" | 318 "type": "string" |
346 } | 319 } |
347 }, | 320 }, |
348 "path": "v1beta1/{+beaconName}:activate", | 321 "path": "v1beta1/{+beaconName}:decommission", |
349 "response": { | 322 "response": { |
350 "$ref": "Empty" | 323 "$ref": "Empty" |
351 }, | 324 }, |
| 325 "scopes": [ |
| 326 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
| 327 ] |
| 328 }, |
| 329 "deactivate": { |
| 330 "description": "Deactivates a beacon. Once deactivated, the
API will not return\ninformation nor attachment data for the beacon when queried
via\n`beaconinfo.getforobserved`. Calling this method on an already inactive\nb
eacon will do nothing (but will return a successful response code).\n\nAuthentic
ate using an [OAuth access token](https://developers.google.com/identity/protoco
ls/OAuth2)\nfrom a signed-in user with **Is owner** or **Can edit** permissions
in the\nGoogle Developers Console project.", |
| 331 "httpMethod": "POST", |
| 332 "id": "proximitybeacon.beacons.deactivate", |
| 333 "parameterOrder": [ |
| 334 "beaconName" |
| 335 ], |
| 336 "parameters": { |
| 337 "beaconName": { |
| 338 "description": "Beacon that should be deactivated. A
beacon name has the format\n\"beacons/N!beaconId\" where the beaconId is the ba
se16 ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible
values are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `
5`\nfor AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EI
D or the beacon's \"stable\" UID.\nRequired.", |
| 339 "location": "path", |
| 340 "pattern": "^beacons/[^/]+$", |
| 341 "required": true, |
| 342 "type": "string" |
| 343 }, |
| 344 "projectId": { |
| 345 "description": "The project id of the beacon to deac
tivate. If the project id is not\nspecified then the project making the request
is used. The project id must\nmatch the project that owns the beacon.\nOptional.
", |
| 346 "location": "query", |
| 347 "type": "string" |
| 348 } |
| 349 }, |
| 350 "path": "v1beta1/{+beaconName}:deactivate", |
| 351 "response": { |
| 352 "$ref": "Empty" |
| 353 }, |
352 "scopes": [ | 354 "scopes": [ |
353 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | 355 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
354 ] | 356 ] |
355 }, | 357 }, |
356 "get": { | 358 "delete": { |
357 "description": "Returns detailed information about the speci
fied beacon.\n\nAuthenticate using an [OAuth access token](https://developers.go
ogle.com/identity/protocols/OAuth2)\nfrom a signed-in user with **viewer**, **Is
owner** or **Can edit**\npermissions in the Google Developers Console project.\
n\nRequests may supply an Eddystone-EID beacon name in the form:\n`beacons/4!bea
conId` where the `beaconId` is the base16 ephemeral ID\nbroadcast by the beacon.
The returned `Beacon` object will contain the\nbeacon's stable Eddystone-UID. C
lients not authorized to resolve the\nbeacon's ephemeral Eddystone-EID broadcast
will receive an error.", | 359 "description": "Deletes the specified beacon including all d
iagnostics data for the beacon\nas well as any attachments on the beacon (includ
ing those belonging to\nother projects). This operation cannot be undone.\n\nAut
henticate using an [OAuth access token](https://developers.google.com/identity/p
rotocols/OAuth2)\nfrom a signed-in user with **Is owner** or **Can edit** permis
sions in the\nGoogle Developers Console project.", |
358 "httpMethod": "GET", | 360 "httpMethod": "DELETE", |
359 "id": "proximitybeacon.beacons.get", | 361 "id": "proximitybeacon.beacons.delete", |
360 "parameterOrder": [ | |
361 "beaconName" | |
362 ], | |
363 "parameters": { | |
364 "projectId": { | |
365 "description": "The project id of the beacon to requ
est. If the project id is not specified\nthen the project making the request is
used. The project id must match the\nproject that owns the beacon.\nOptional.", | |
366 "location": "query", | |
367 "type": "string" | |
368 }, | |
369 "beaconName": { | |
370 "description": "Resource name of this beacon. A beac
on name has the format\n\"beacons/N!beaconId\" where the beaconId is the base16
ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible valu
es are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `5`\nf
or AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EID or
the beacon's \"stable\" UID.\nRequired.", | |
371 "location": "path", | |
372 "pattern": "^beacons/[^/]+$", | |
373 "required": true, | |
374 "type": "string" | |
375 } | |
376 }, | |
377 "path": "v1beta1/{+beaconName}", | |
378 "response": { | |
379 "$ref": "Beacon" | |
380 }, | |
381 "scopes": [ | |
382 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | |
383 ] | |
384 }, | |
385 "update": { | |
386 "description": "Updates the information about the specified
beacon. **Any field that you do\nnot populate in the submitted beacon will be pe
rmanently erased**, so you\nshould follow the \"read, modify, write\" pattern to
avoid inadvertently\ndestroying data.\n\nChanges to the beacon status via this
method will be silently ignored.\nTo update beacon status, use the separate met
hods on this API for\nactivation, deactivation, and decommissioning.\nAuthentica
te using an [OAuth access token](https://developers.google.com/identity/protocol
s/OAuth2)\nfrom a signed-in user with **Is owner** or **Can edit** permissions i
n the\nGoogle Developers Console project.", | |
387 "httpMethod": "PUT", | |
388 "id": "proximitybeacon.beacons.update", | |
389 "parameterOrder": [ | 362 "parameterOrder": [ |
390 "beaconName" | 363 "beaconName" |
391 ], | 364 ], |
392 "parameters": { | 365 "parameters": { |
393 "beaconName": { | 366 "beaconName": { |
394 "description": "Resource name of this beacon. A beac
on name has the format\n\"beacons/N!beaconId\" where the beaconId is the base16
ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible valu
es are\n`3` for Eddystone, `1` for iBeacon, or `5` for AltBeacon.\n\nThis field
must be left empty when registering. After reading a beacon,\nclients can use th
e name for future operations.", | 367 "description": "Beacon that should be deleted. A bea
con name has the format\n\"beacons/N!beaconId\" where the beaconId is the base16
ID broadcast by\nthe beacon and N is a code for the beacon's type. Possible val
ues are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, or `5`\n
for AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent EID or
the beacon's \"stable\" UID.\nRequired.", |
395 "location": "path", | 368 "location": "path", |
396 "pattern": "^beacons/[^/]+$", | 369 "pattern": "^beacons/[^/]+$", |
397 "required": true, | 370 "required": true, |
398 "type": "string" | 371 "type": "string" |
399 }, | 372 }, |
400 "projectId": { | 373 "projectId": { |
401 "description": "The project id of the beacon to upda
te. If the project id is not\nspecified then the project making the request is u
sed. The project id\nmust match the project that owns the beacon.\nOptional.", | 374 "description": "The project id of the beacon to dele
te. If not provided, the project\nthat is making the request is used.\nOptional.
", |
402 "location": "query", | 375 "location": "query", |
403 "type": "string" | 376 "type": "string" |
404 } | 377 } |
405 }, | 378 }, |
406 "path": "v1beta1/{+beaconName}", | 379 "path": "v1beta1/{+beaconName}", |
| 380 "response": { |
| 381 "$ref": "Empty" |
| 382 }, |
| 383 "scopes": [ |
| 384 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
| 385 ] |
| 386 }, |
| 387 "register": { |
| 388 "description": "Registers a previously unregistered beacon g
iven its `advertisedId`.\nThese IDs are unique within the system. An ID can be r
egistered only once.\n\nAuthenticate using an [OAuth access token](https://devel
opers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user with **Is own
er** or **Can edit** permissions in the\nGoogle Developers Console project.", |
| 389 "httpMethod": "POST", |
| 390 "id": "proximitybeacon.beacons.register", |
| 391 "parameterOrder": [], |
| 392 "parameters": { |
| 393 "projectId": { |
| 394 "description": "The project id of the project the be
acon will be registered to. If\nthe project id is not specified then the project
making the request\nis used.\nOptional.", |
| 395 "location": "query", |
| 396 "type": "string" |
| 397 } |
| 398 }, |
| 399 "path": "v1beta1/beacons:register", |
407 "request": { | 400 "request": { |
408 "$ref": "Beacon" | 401 "$ref": "Beacon" |
409 }, | 402 }, |
410 "response": { | 403 "response": { |
411 "$ref": "Beacon" | 404 "$ref": "Beacon" |
412 }, | 405 }, |
413 "scopes": [ | 406 "scopes": [ |
414 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | 407 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
415 ] | 408 ] |
416 }, | 409 }, |
417 "decommission": { | 410 "list": { |
418 "description": "Decommissions the specified beacon in the se
rvice. This beacon will no\nlonger be returned from `beaconinfo.getforobserved`.
This operation is\npermanent -- you will not be able to re-register a beacon wi
th this ID\nagain.\n\nAuthenticate using an [OAuth access token](https://develop
ers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user with **Is owner
** or **Can edit** permissions in the\nGoogle Developers Console project.", | 411 "description": "Searches the beacon registry for beacons tha
t match the given search\ncriteria. Only those beacons that the client has permi
ssion to list\nwill be returned.\n\nAuthenticate using an [OAuth access token](h
ttps://developers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user w
ith **viewer**, **Is owner** or **Can edit**\npermissions in the Google Develope
rs Console project.", |
419 "httpMethod": "POST", | 412 "httpMethod": "GET", |
420 "id": "proximitybeacon.beacons.decommission", | 413 "id": "proximitybeacon.beacons.list", |
421 "parameterOrder": [ | 414 "parameterOrder": [], |
422 "beaconName" | |
423 ], | |
424 "parameters": { | 415 "parameters": { |
425 "projectId": { | 416 "projectId": { |
426 "description": "The project id of the beacon to deco
mmission. If the project id is not\nspecified then the project making the reques
t is used. The project id\nmust match the project that owns the beacon.\nOptiona
l.", | 417 "description": "The project id to list beacons under
. If not present then the project\ncredential that made the request is used as t
he project.\nOptional.", |
427 "location": "query", | 418 "location": "query", |
428 "type": "string" | 419 "type": "string" |
429 }, | 420 }, |
430 "beaconName": { | 421 "pageToken": { |
431 "description": "Beacon that should be decommissioned
. A beacon name has the format\n\"beacons/N!beaconId\" where the beaconId is the
base16 ID broadcast by\nthe beacon and N is a code for the beacon's type. Possi
ble values are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1` for iBeacon, o
r `5`\nfor AltBeacon. For Eddystone-EID beacons, you may use either the\ncurrent
EID of the beacon's \"stable\" UID.\nRequired.", | 422 "description": "A pagination token obtained from a p
revious request to list beacons.", |
432 "location": "path", | 423 "location": "query", |
433 "pattern": "^beacons/[^/]+$", | 424 "type": "string" |
434 "required": true, | 425 }, |
| 426 "pageSize": { |
| 427 "description": "The maximum number of records to ret
urn for this request, up to a\nserver-defined upper limit.", |
| 428 "format": "int32", |
| 429 "location": "query", |
| 430 "type": "integer" |
| 431 }, |
| 432 "q": { |
| 433 "description": "Filter query string that supports th
e following field filters:\n\n* **description:`\"<string>\"`**\n For example: *
*description:\"Room 3\"**\n Returns beacons whose description matches tokens in
the string \"Room 3\"\n (not necessarily that exact string).\n The string mus
t be double-quoted.\n* **status:`<enum>`**\n For example: **status:active**\n
Returns beacons whose status matches the given value. Values must be\n one of t
he Beacon.Status enum values (case insensitive). Accepts\n multiple filters whi
ch will be combined with OR logic.\n* **stability:`<enum>`**\n For example: **s
tability:mobile**\n Returns beacons whose expected stability matches the given
value.\n Values must be one of the Beacon.Stability enum values (case\n insens
itive). Accepts multiple filters which will be combined with\n OR logic.\n* **p
lace\\_id:`\"<string>\"`**\n For example: **place\\_id:\"ChIJVSZzVR8FdkgRXGmmm6
SslKw=\"**\n Returns beacons explicitly registered at the given place, expresse
d as\n a Place ID obtained from [Google Places API](/places/place-id). Does not
\n match places inside the given place. Does not consider the beacon's\n actua
l location (which may be different from its registered place).\n Accepts multip
le filters that will be combined with OR logic. The place\n ID must be double-q
uoted.\n* **registration\\_time`[<|>|<=|>=]<integer>`**\n For example: **regist
ration\\_time>=1433116800**\n Returns beacons whose registration time matches t
he given filter.\n Supports the operators: <, >, <=, and >=. Timestamp must be
expressed as\n an integer number of seconds since midnight January 1, 1970 UTC.
Accepts\n at most two filters that will be combined with AND logic, to support
\n \"between\" semantics. If more than two are supplied, the latter ones are\n
ignored.\n* **lat:`<double> lng:<double> radius:<integer>`**\n For example: **
lat:51.1232343 lng:-1.093852 radius:1000**\n Returns beacons whose registered l
ocation is within the given circle.\n When any of these fields are given, all a
re required. Latitude and\n longitude must be decimal degrees between -90.0 and
90.0 and between\n -180.0 and 180.0 respectively. Radius must be an integer nu
mber of\n meters between 10 and 1,000,000 (1000 km).\n* **property:`\"<string>=
<string>\"`**\n For example: **property:\"battery-type=CR2032\"**\n Returns be
acons which have a property of the given name and value.\n Supports multiple fi
lters which will be combined with OR logic.\n The entire name=value string must
be double-quoted as one string.\n* **attachment\\_type:`\"<string>\"`**\n For
example: **attachment_type:\"my-namespace/my-type\"**\n Returns beacons having
at least one attachment of the given namespaced\n type. Supports \"any within t
his namespace\" via the partial wildcard\n syntax: \"my-namespace/*\". Supports
multiple filters which will be\n combined with OR logic. The string must be do
uble-quoted.\n* **indoor\\_level:`\"<string>\"`**\n For example: **indoor\\_lev
el:\"1\"**\n Returns beacons which are located on the given indoor level. Accep
ts\n multiple filters that will be combined with OR logic.\n\nMultiple filters
on the same field are combined with OR logic (except\nregistration_time which is
combined with AND logic).\nMultiple filters on different fields are combined wi
th AND logic.\nFilters should be separated by spaces.\n\nAs with any HTTP query
string parameter, the whole filter expression must\nbe URL-encoded.\n\nExample R
EST request:\n`GET /v1beta1/beacons?q=status:active%20lat:51.123%20lng:-1.095%20
radius:1000`", |
| 434 "location": "query", |
435 "type": "string" | 435 "type": "string" |
436 } | 436 } |
437 }, | 437 }, |
438 "path": "v1beta1/{+beaconName}:decommission", | 438 "path": "v1beta1/beacons", |
439 "response": { | 439 "response": { |
440 "$ref": "Empty" | 440 "$ref": "ListBeaconsResponse" |
441 }, | 441 }, |
442 "scopes": [ | 442 "scopes": [ |
443 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" | 443 "https://www.googleapis.com/auth/userlocation.beacon.reg
istry" |
444 ] | 444 ] |
445 } | 445 } |
446 }, | 446 }, |
447 "resources": { | 447 "resources": { |
448 "diagnostics": { | 448 "diagnostics": { |
449 "methods": { | 449 "methods": { |
450 "list": { | 450 "list": { |
451 "description": "List the diagnostics for a single be
acon. You can also list diagnostics for\nall the beacons owned by your Google De
velopers Console project by using\nthe beacon name `beacons/-`.\n\nAuthenticate
using an [OAuth access token](https://developers.google.com/identity/protocols/O
Auth2)\nfrom a signed-in user with **viewer**, **Is owner** or **Can edit**\nper
missions in the Google Developers Console project.", | 451 "description": "List the diagnostics for a single be
acon. You can also list diagnostics for\nall the beacons owned by your Google De
velopers Console project by using\nthe beacon name `beacons/-`.\n\nAuthenticate
using an [OAuth access token](https://developers.google.com/identity/protocols/O
Auth2)\nfrom a signed-in user with **viewer**, **Is owner** or **Can edit**\nper
missions in the Google Developers Console project.", |
452 "httpMethod": "GET", | 452 "httpMethod": "GET", |
453 "id": "proximitybeacon.beacons.diagnostics.list", | 453 "id": "proximitybeacon.beacons.diagnostics.list", |
454 "parameterOrder": [ | 454 "parameterOrder": [ |
455 "beaconName" | 455 "beaconName" |
456 ], | 456 ], |
457 "parameters": { | 457 "parameters": { |
458 "beaconName": { | |
459 "description": "Beacon that the diagnostics
are for.", | |
460 "location": "path", | |
461 "pattern": "^beacons/[^/]+$", | |
462 "required": true, | |
463 "type": "string" | |
464 }, | |
465 "pageToken": { | |
466 "description": "Requests results that occur
after the `page_token`, obtained from the\nresponse to a previous request. Optio
nal.", | |
467 "location": "query", | |
468 "type": "string" | |
469 }, | |
470 "alertFilter": { | 458 "alertFilter": { |
471 "description": "Requests only beacons that h
ave the given alert. For example, to find\nbeacons that have low batteries use `
alert_filter=LOW_BATTERY`.", | 459 "description": "Requests only beacons that h
ave the given alert. For example, to find\nbeacons that have low batteries use `
alert_filter=LOW_BATTERY`.", |
472 "enum": [ | 460 "enum": [ |
473 "ALERT_UNSPECIFIED", | 461 "ALERT_UNSPECIFIED", |
474 "WRONG_LOCATION", | 462 "WRONG_LOCATION", |
475 "LOW_BATTERY" | 463 "LOW_BATTERY" |
476 ], | 464 ], |
477 "location": "query", | 465 "location": "query", |
478 "type": "string" | 466 "type": "string" |
479 }, | 467 }, |
480 "pageSize": { | 468 "pageSize": { |
481 "description": "Specifies the maximum number
of results to return. Defaults to\n10. Maximum 1000. Optional.", | 469 "description": "Specifies the maximum number
of results to return. Defaults to\n10. Maximum 1000. Optional.", |
482 "format": "int32", | 470 "format": "int32", |
483 "location": "query", | 471 "location": "query", |
484 "type": "integer" | 472 "type": "integer" |
485 }, | 473 }, |
486 "projectId": { | 474 "projectId": { |
487 "description": "Requests only diagnostic rec
ords for the given project id. If not set,\nthen the project making the request
will be used for looking up\ndiagnostic records. Optional.", | 475 "description": "Requests only diagnostic rec
ords for the given project id. If not set,\nthen the project making the request
will be used for looking up\ndiagnostic records. Optional.", |
488 "location": "query", | 476 "location": "query", |
489 "type": "string" | 477 "type": "string" |
| 478 }, |
| 479 "beaconName": { |
| 480 "description": "Beacon that the diagnostics
are for.", |
| 481 "location": "path", |
| 482 "pattern": "^beacons/[^/]+$", |
| 483 "required": true, |
| 484 "type": "string" |
| 485 }, |
| 486 "pageToken": { |
| 487 "description": "Requests results that occur
after the `page_token`, obtained from the\nresponse to a previous request. Optio
nal.", |
| 488 "location": "query", |
| 489 "type": "string" |
490 } | 490 } |
491 }, | 491 }, |
492 "path": "v1beta1/{+beaconName}/diagnostics", | 492 "path": "v1beta1/{+beaconName}/diagnostics", |
493 "response": { | 493 "response": { |
494 "$ref": "ListDiagnosticsResponse" | 494 "$ref": "ListDiagnosticsResponse" |
495 }, | 495 }, |
496 "scopes": [ | 496 "scopes": [ |
497 "https://www.googleapis.com/auth/userlocation.be
acon.registry" | 497 "https://www.googleapis.com/auth/userlocation.be
acon.registry" |
498 ] | 498 ] |
499 } | 499 } |
500 } | 500 } |
501 }, | 501 }, |
502 "attachments": { | 502 "attachments": { |
503 "methods": { | 503 "methods": { |
504 "delete": { | 504 "delete": { |
505 "description": "Deletes the specified attachment for
the given beacon. Each attachment has\na unique attachment name (`attachmentNam
e`) which is returned when you\nfetch the attachment data via this API. You spec
ify this with the delete\nrequest to control which attachment is removed. This o
peration cannot be\nundone.\n\nAuthenticate using an [OAuth access token](https:
//developers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user with *
*Is owner** or **Can edit** permissions in the\nGoogle Developers Console projec
t.", | 505 "description": "Deletes the specified attachment for
the given beacon. Each attachment has\na unique attachment name (`attachmentNam
e`) which is returned when you\nfetch the attachment data via this API. You spec
ify this with the delete\nrequest to control which attachment is removed. This o
peration cannot be\nundone.\n\nAuthenticate using an [OAuth access token](https:
//developers.google.com/identity/protocols/OAuth2)\nfrom a signed-in user with *
*Is owner** or **Can edit** permissions in the\nGoogle Developers Console projec
t.", |
506 "httpMethod": "DELETE", | 506 "httpMethod": "DELETE", |
507 "id": "proximitybeacon.beacons.attachments.delete", | 507 "id": "proximitybeacon.beacons.attachments.delete", |
508 "parameterOrder": [ | 508 "parameterOrder": [ |
509 "attachmentName" | 509 "attachmentName" |
510 ], | 510 ], |
511 "parameters": { | 511 "parameters": { |
| 512 "projectId": { |
| 513 "description": "The project id of the attach
ment to delete. If not provided, the project\nthat is making the request is used
.\nOptional.", |
| 514 "location": "query", |
| 515 "type": "string" |
| 516 }, |
512 "attachmentName": { | 517 "attachmentName": { |
513 "description": "The attachment name (`attach
mentName`) of\nthe attachment to remove. For example:\n`beacons/3!893737abc9/att
achments/c5e937-af0-494-959-ec49d12738`. For\nEddystone-EID beacons, the beacon
ID portion (`3!893737abc9`) may be the\nbeacon's current EID, or its \"stable\"
Eddystone-UID.\nRequired.", | 518 "description": "The attachment name (`attach
mentName`) of\nthe attachment to remove. For example:\n`beacons/3!893737abc9/att
achments/c5e937-af0-494-959-ec49d12738`. For\nEddystone-EID beacons, the beacon
ID portion (`3!893737abc9`) may be the\nbeacon's current EID, or its \"stable\"
Eddystone-UID.\nRequired.", |
514 "location": "path", | 519 "location": "path", |
515 "pattern": "^beacons/[^/]+/attachments/[^/]+
$", | 520 "pattern": "^beacons/[^/]+/attachments/[^/]+
$", |
516 "required": true, | 521 "required": true, |
517 "type": "string" | 522 "type": "string" |
518 }, | |
519 "projectId": { | |
520 "description": "The project id of the attach
ment to delete. If not provided, the project\nthat is making the request is used
.\nOptional.", | |
521 "location": "query", | |
522 "type": "string" | |
523 } | 523 } |
524 }, | 524 }, |
525 "path": "v1beta1/{+attachmentName}", | 525 "path": "v1beta1/{+attachmentName}", |
526 "response": { | 526 "response": { |
527 "$ref": "Empty" | 527 "$ref": "Empty" |
528 }, | 528 }, |
529 "scopes": [ | 529 "scopes": [ |
530 "https://www.googleapis.com/auth/userlocation.be
acon.registry" | 530 "https://www.googleapis.com/auth/userlocation.be
acon.registry" |
531 ] | 531 ] |
532 }, | 532 }, |
533 "list": { | 533 "list": { |
534 "description": "Returns the attachments for the spec
ified beacon that match the specified\nnamespaced-type pattern.\n\nTo control wh
ich namespaced types are returned, you add the\n`namespacedType` query parameter
to the request. You must either use\n`*/*`, to return all attachments, or the n
amespace must be one of\nthe ones returned from the `namespaces` endpoint.\n\nA
uthenticate using an [OAuth access token](https://developers.google.com/identity
/protocols/OAuth2)\nfrom a signed-in user with **viewer**, **Is owner** or **Can
edit**\npermissions in the Google Developers Console project.", | 534 "description": "Returns the attachments for the spec
ified beacon that match the specified\nnamespaced-type pattern.\n\nTo control wh
ich namespaced types are returned, you add the\n`namespacedType` query parameter
to the request. You must either use\n`*/*`, to return all attachments, or the n
amespace must be one of\nthe ones returned from the `namespaces` endpoint.\n\nA
uthenticate using an [OAuth access token](https://developers.google.com/identity
/protocols/OAuth2)\nfrom a signed-in user with **viewer**, **Is owner** or **Can
edit**\npermissions in the Google Developers Console project.", |
535 "httpMethod": "GET", | 535 "httpMethod": "GET", |
536 "id": "proximitybeacon.beacons.attachments.list", | 536 "id": "proximitybeacon.beacons.attachments.list", |
537 "parameterOrder": [ | 537 "parameterOrder": [ |
538 "beaconName" | 538 "beaconName" |
539 ], | 539 ], |
540 "parameters": { | 540 "parameters": { |
| 541 "projectId": { |
| 542 "description": "The project id to list beaco
n attachments under. This field can be\nused when \"*\" is specified to mean all
attachment namespaces. Projects\nmay have multiple attachments with multiple na
mespaces. If \"*\" is\nspecified and the projectId string is empty, then the pro
ject\nmaking the request is used.\nOptional.", |
| 543 "location": "query", |
| 544 "type": "string" |
| 545 }, |
541 "namespacedType": { | 546 "namespacedType": { |
542 "description": "Specifies the namespace and
type of attachment to include in response in\n<var>namespace/type</var> format.
Accepts `*/*` to specify\n\"all types in all namespaces\".", | 547 "description": "Specifies the namespace and
type of attachment to include in response in\n<var>namespace/type</var> format.
Accepts `*/*` to specify\n\"all types in all namespaces\".", |
543 "location": "query", | 548 "location": "query", |
544 "type": "string" | 549 "type": "string" |
545 }, | 550 }, |
546 "beaconName": { | 551 "beaconName": { |
547 "description": "Beacon whose attachments sho
uld be fetched. A beacon name has the\nformat \"beacons/N!beaconId\" where the b
eaconId is the base16 ID broadcast\nby the beacon and N is a code for the beacon
's type. Possible values are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1`
for iBeacon, or `5`\nfor AltBeacon. For Eddystone-EID beacons, you may use eithe
r the\ncurrent EID or the beacon's \"stable\" UID.\nRequired.", | 552 "description": "Beacon whose attachments sho
uld be fetched. A beacon name has the\nformat \"beacons/N!beaconId\" where the b
eaconId is the base16 ID broadcast\nby the beacon and N is a code for the beacon
's type. Possible values are\n`3` for Eddystone-UID, `4` for Eddystone-EID, `1`
for iBeacon, or `5`\nfor AltBeacon. For Eddystone-EID beacons, you may use eithe
r the\ncurrent EID or the beacon's \"stable\" UID.\nRequired.", |
548 "location": "path", | 553 "location": "path", |
549 "pattern": "^beacons/[^/]+$", | 554 "pattern": "^beacons/[^/]+$", |
550 "required": true, | 555 "required": true, |
551 "type": "string" | 556 "type": "string" |
552 }, | |
553 "projectId": { | |
554 "description": "The project id to list beaco
n attachments under. This field can be\nused when \"*\" is specified to mean all
attachment namespaces. Projects\nmay have multiple attachments with multiple na
mespaces. If \"*\" is\nspecified and the projectId string is empty, then the pro
ject\nmaking the request is used.\nOptional.", | |
555 "location": "query", | |
556 "type": "string" | |
557 } | 557 } |
558 }, | 558 }, |
559 "path": "v1beta1/{+beaconName}/attachments", | 559 "path": "v1beta1/{+beaconName}/attachments", |
560 "response": { | 560 "response": { |
561 "$ref": "ListBeaconAttachmentsResponse" | 561 "$ref": "ListBeaconAttachmentsResponse" |
562 }, | 562 }, |
563 "scopes": [ | 563 "scopes": [ |
564 "https://www.googleapis.com/auth/userlocation.be
acon.registry" | 564 "https://www.googleapis.com/auth/userlocation.be
acon.registry" |
565 ] | 565 ] |
566 }, | 566 }, |
(...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
628 }, | 628 }, |
629 "scopes": [ | 629 "scopes": [ |
630 "https://www.googleapis.com/auth/userlocation.be
acon.registry" | 630 "https://www.googleapis.com/auth/userlocation.be
acon.registry" |
631 ] | 631 ] |
632 } | 632 } |
633 } | 633 } |
634 } | 634 } |
635 } | 635 } |
636 } | 636 } |
637 }, | 637 }, |
638 "revision": "20170717", | 638 "revision": "20170815", |
639 "rootUrl": "https://proximitybeacon.googleapis.com/", | 639 "rootUrl": "https://proximitybeacon.googleapis.com/", |
640 "schemas": { | 640 "schemas": { |
| 641 "Date": { |
| 642 "description": "Represents a whole calendar date, e.g. date of birth
. The time of day and\ntime zone are either specified elsewhere or are not signi
ficant. The date\nis relative to the Proleptic Gregorian Calendar. The day may b
e 0 to\nrepresent a year and month where the day is not significant, e.g. credit
card\nexpiration date. The year may be 0 to represent a month and day independe
nt\nof year, e.g. anniversary date. Related types are google.type.TimeOfDay\nand
`google.protobuf.Timestamp`.", |
| 643 "id": "Date", |
| 644 "properties": { |
| 645 "day": { |
| 646 "description": "Day of month. Must be from 1 to 31 and valid
for the year and month, or 0\nif specifying a year/month where the day is not s
ignificant.", |
| 647 "format": "int32", |
| 648 "type": "integer" |
| 649 }, |
| 650 "year": { |
| 651 "description": "Year of date. Must be from 1 to 9999, or 0 i
f specifying a date without\na year.", |
| 652 "format": "int32", |
| 653 "type": "integer" |
| 654 }, |
| 655 "month": { |
| 656 "description": "Month of year. Must be from 1 to 12.", |
| 657 "format": "int32", |
| 658 "type": "integer" |
| 659 } |
| 660 }, |
| 661 "type": "object" |
| 662 }, |
| 663 "IndoorLevel": { |
| 664 "description": "Indoor level, a human-readable string as returned by
Google Maps APIs,\nuseful to indicate which floor of a building a beacon is loc
ated on.", |
| 665 "id": "IndoorLevel", |
| 666 "properties": { |
| 667 "name": { |
| 668 "description": "The name of this level.", |
| 669 "type": "string" |
| 670 } |
| 671 }, |
| 672 "type": "object" |
| 673 }, |
| 674 "ListNamespacesResponse": { |
| 675 "description": "Response to ListNamespacesRequest that contains all
the project's namespaces.", |
| 676 "id": "ListNamespacesResponse", |
| 677 "properties": { |
| 678 "namespaces": { |
| 679 "description": "The attachments that corresponded to the req
uest params.", |
| 680 "items": { |
| 681 "$ref": "Namespace" |
| 682 }, |
| 683 "type": "array" |
| 684 } |
| 685 }, |
| 686 "type": "object" |
| 687 }, |
| 688 "ListBeaconsResponse": { |
| 689 "description": "Response that contains list beacon results and pagin
ation help.", |
| 690 "id": "ListBeaconsResponse", |
| 691 "properties": { |
| 692 "nextPageToken": { |
| 693 "description": "An opaque pagination token that the client m
ay provide in their next\nrequest to retrieve the next page of results.", |
| 694 "type": "string" |
| 695 }, |
| 696 "totalCount": { |
| 697 "description": "Estimate of the total number of beacons matc
hed by the query. Higher\nvalues may be less accurate.", |
| 698 "format": "int64", |
| 699 "type": "string" |
| 700 }, |
| 701 "beacons": { |
| 702 "description": "The beacons that matched the search criteria
.", |
| 703 "items": { |
| 704 "$ref": "Beacon" |
| 705 }, |
| 706 "type": "array" |
| 707 } |
| 708 }, |
| 709 "type": "object" |
| 710 }, |
| 711 "Diagnostics": { |
| 712 "description": "Diagnostics for a single beacon.", |
| 713 "id": "Diagnostics", |
| 714 "properties": { |
| 715 "alerts": { |
| 716 "description": "An unordered list of Alerts that the beacon
has.", |
| 717 "enumDescriptions": [ |
| 718 "Invalid value. Should never appear.", |
| 719 "The beacon has been reported in a location different th
an its registered\nlocation. This may indicate that the beacon has been moved. T
his signal\nis not 100% accurate, but indicates that further investigation is wo
rth\nwhile.", |
| 720 "The battery level for the beacon is low enough that, gi
ven the beacon's\ncurrent use, its battery will run out with in the next 60 days
. This\nindicates that the battery should be replaced soon." |
| 721 ], |
| 722 "items": { |
| 723 "enum": [ |
| 724 "ALERT_UNSPECIFIED", |
| 725 "WRONG_LOCATION", |
| 726 "LOW_BATTERY" |
| 727 ], |
| 728 "type": "string" |
| 729 }, |
| 730 "type": "array" |
| 731 }, |
| 732 "estimatedLowBatteryDate": { |
| 733 "$ref": "Date", |
| 734 "description": "The date when the battery is expected to be
low. If the value is missing\nthen there is no estimate for when the battery wil
l be low.\nThis value is only an estimate, not an exact date." |
| 735 }, |
| 736 "beaconName": { |
| 737 "description": "Resource name of the beacon. For Eddystone-E
ID beacons, this may\nbe the beacon's current EID, or the beacon's \"stable\" Ed
dystone-UID.", |
| 738 "type": "string" |
| 739 } |
| 740 }, |
| 741 "type": "object" |
| 742 }, |
| 743 "Empty": { |
| 744 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", |
| 745 "id": "Empty", |
| 746 "properties": {}, |
| 747 "type": "object" |
| 748 }, |
| 749 "GetInfoForObservedBeaconsRequest": { |
| 750 "description": "Request for beacon and attachment information about
beacons that\na mobile client has encountered \"in the wild\".", |
| 751 "id": "GetInfoForObservedBeaconsRequest", |
| 752 "properties": { |
| 753 "observations": { |
| 754 "description": "The beacons that the client has encountered.
\nAt least one must be given.", |
| 755 "items": { |
| 756 "$ref": "Observation" |
| 757 }, |
| 758 "type": "array" |
| 759 }, |
| 760 "namespacedTypes": { |
| 761 "description": "Specifies what kind of attachments to includ
e in the response.\nWhen given, the response will include only attachments of th
e given types.\nWhen empty, no attachments will be returned. Must be in the form
at\n<var>namespace/type</var>. Accepts `*` to specify all types in\nall namespac
es owned by the client.\nOptional.", |
| 762 "items": { |
| 763 "type": "string" |
| 764 }, |
| 765 "type": "array" |
| 766 } |
| 767 }, |
| 768 "type": "object" |
| 769 }, |
| 770 "BeaconAttachment": { |
| 771 "description": "Project-specific data associated with a beacon.", |
| 772 "id": "BeaconAttachment", |
| 773 "properties": { |
| 774 "attachmentName": { |
| 775 "description": "Resource name of this attachment. Attachment
names have the format:\n<code>beacons/<var>beacon_id</var>/attachments/<var>att
achment_id</var></code>.\nLeave this empty on creation.", |
| 776 "type": "string" |
| 777 }, |
| 778 "namespacedType": { |
| 779 "description": "Specifies what kind of attachment this is. T
ells a client how to\ninterpret the `data` field. Format is <var>namespace/type<
/var>. Namespace\nprovides type separation between clients. Type describes the t
ype of\n`data`, for use by the client when parsing the `data` field.\nRequired."
, |
| 780 "type": "string" |
| 781 }, |
| 782 "data": { |
| 783 "description": "An opaque data container for client-provided
data. Must be\n[base64](http://tools.ietf.org/html/rfc4648#section-4) encoded i
n HTTP\nrequests, and will be so encoded (with padding) in responses.\nRequired.
", |
| 784 "format": "byte", |
| 785 "type": "string" |
| 786 }, |
| 787 "creationTimeMs": { |
| 788 "description": "The UTC time when this attachment was create
d, in milliseconds since the\nUNIX epoch.", |
| 789 "format": "google-datetime", |
| 790 "type": "string" |
| 791 } |
| 792 }, |
| 793 "type": "object" |
| 794 }, |
| 795 "EphemeralIdRegistration": { |
| 796 "description": "Write-only registration parameters for beacons using
Eddystone-EID format.\nTwo ways of securely registering an Eddystone-EID beacon
with the service\nare supported:\n\n1. Perform an ECDH key exchange via this AP
I, including a previous call\n to `GET /v1beta1/eidparams`. In this case the f
ields\n `beacon_ecdh_public_key` and `service_ecdh_public_key` should be\n p
opulated and `beacon_identity_key` should not be populated. This\n method ensu
res that only the two parties in the ECDH key exchange can\n compute the ident
ity key, which becomes a secret between them.\n2. Derive or obtain the beacon's
identity key via other secure means\n (perhaps an ECDH key exchange between th
e beacon and a mobile device\n or any other secure method), and then submit th
e resulting identity key\n to the service. In this case `beacon_identity_key`
field should be\n populated, and neither of `beacon_ecdh_public_key` nor\n `
service_ecdh_public_key` fields should be. The security of this method\n depen
ds on how securely the parties involved (in particular the\n bluetooth client)
handle the identity key, and obviously on how\n securely the identity key was
generated.\n\nSee [the Eddystone specification](https://github.com/google/eddys
tone/tree/master/eddystone-eid) at GitHub.", |
| 797 "id": "EphemeralIdRegistration", |
| 798 "properties": { |
| 799 "rotationPeriodExponent": { |
| 800 "description": "Indicates the nominal period between each ro
tation of the beacon's\nephemeral ID. \"Nominal\" because the beacon should rand
omize the\nactual interval. See [the spec at github](https://github.com/google/e
ddystone/tree/master/eddystone-eid)\nfor details. This value corresponds to a po
wer-of-two scaler on the\nbeacon's clock: when the scaler value is K, the beacon
will begin\nbroadcasting a new ephemeral ID on average every 2^K seconds.", |
| 801 "format": "uint32", |
| 802 "type": "integer" |
| 803 }, |
| 804 "serviceEcdhPublicKey": { |
| 805 "description": "The service's public key used for the Ellipt
ic curve Diffie-Hellman\nkey exchange. When this field is populated, `beacon_ecd
h_public_key`\nmust also be populated, and `beacon_identity_key` must not be.", |
| 806 "format": "byte", |
| 807 "type": "string" |
| 808 }, |
| 809 "beaconIdentityKey": { |
| 810 "description": "The private key of the beacon. If this field
is populated,\n`beacon_ecdh_public_key` and `service_ecdh_public_key` must not
be\npopulated.", |
| 811 "format": "byte", |
| 812 "type": "string" |
| 813 }, |
| 814 "initialEid": { |
| 815 "description": "An initial ephemeral ID calculated using the
clock value submitted as\n`initial_clock_value`, and the secret key generated b
y the\nDiffie-Hellman key exchange using `service_ecdh_public_key` and\n`service
_ecdh_public_key`. This initial EID value will be used by the\nservice to confir
m that the key exchange process was successful.", |
| 816 "format": "byte", |
| 817 "type": "string" |
| 818 }, |
| 819 "initialClockValue": { |
| 820 "description": "The initial clock value of the beacon. The b
eacon's clock must have\nbegun counting at this value immediately prior to trans
mitting this\nvalue to the resolving service. Significant delay in transmitting
this\nvalue to the service risks registration or resolution failures. If a\nvalu
e is not provided, the default is zero.", |
| 821 "format": "uint64", |
| 822 "type": "string" |
| 823 }, |
| 824 "beaconEcdhPublicKey": { |
| 825 "description": "The beacon's public key used for the Ellipti
c curve Diffie-Hellman\nkey exchange. When this field is populated, `service_ecd
h_public_key`\nmust also be populated, and `beacon_identity_key` must not be.", |
| 826 "format": "byte", |
| 827 "type": "string" |
| 828 } |
| 829 }, |
| 830 "type": "object" |
| 831 }, |
| 832 "LatLng": { |
| 833 "description": "An object representing a latitude/longitude pair. Th
is is expressed as a pair\nof doubles representing degrees latitude and degrees
longitude. Unless\nspecified otherwise, this must conform to the\n<a href=\"http
://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf\">WGS84\nstandard</a>. Values
must be within normalized ranges.\n\nExample of normalization code in Python:\n
\n def NormalizeLongitude(longitude):\n \"\"\"Wraps decimal degrees long
itude to [-180.0, 180.0].\"\"\"\n q, r = divmod(longitude, 360.0)\n if
r > 180.0 or (r == 180.0 and q <= -1.0):\n return r - 360.0\n retur
n r\n\n def NormalizeLatLng(latitude, longitude):\n \"\"\"Wraps decimal
degrees latitude and longitude to\n [-90.0, 90.0] and [-180.0, 180.0], resp
ectively.\"\"\"\n r = latitude % 360.0\n if r <= 90.0:\n return
r, NormalizeLongitude(longitude)\n elif r >= 270.0:\n return r - 36
0, NormalizeLongitude(longitude)\n else:\n return 180 - r, Normalize
Longitude(longitude + 180.0)\n\n assert 180.0 == NormalizeLongitude(180.0)\n
assert -180.0 == NormalizeLongitude(-180.0)\n assert -179.0 == NormalizeLo
ngitude(181.0)\n assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)\n assert
(0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)\n assert (85.0, 180.0) == Normali
zeLatLng(95.0, 0.0)\n assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)\
n assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)\n assert (-90.0, -10.
0) == NormalizeLatLng(-90.0, -10.0)\n assert (0.0, -170.0) == NormalizeLatLng
(-180.0, 10.0)\n assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)\n as
sert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)\n assert (90.0, 10.0) == N
ormalizeLatLng(-270.0, 10.0)", |
| 834 "id": "LatLng", |
| 835 "properties": { |
| 836 "latitude": { |
| 837 "description": "The latitude in degrees. It must be in the r
ange [-90.0, +90.0].", |
| 838 "format": "double", |
| 839 "type": "number" |
| 840 }, |
| 841 "longitude": { |
| 842 "description": "The longitude in degrees. It must be in the
range [-180.0, +180.0].", |
| 843 "format": "double", |
| 844 "type": "number" |
| 845 } |
| 846 }, |
| 847 "type": "object" |
| 848 }, |
| 849 "ListBeaconAttachmentsResponse": { |
| 850 "description": "Response to `ListBeaconAttachments` that contains th
e requested attachments.", |
| 851 "id": "ListBeaconAttachmentsResponse", |
| 852 "properties": { |
| 853 "attachments": { |
| 854 "description": "The attachments that corresponded to the req
uest params.", |
| 855 "items": { |
| 856 "$ref": "BeaconAttachment" |
| 857 }, |
| 858 "type": "array" |
| 859 } |
| 860 }, |
| 861 "type": "object" |
| 862 }, |
641 "Namespace": { | 863 "Namespace": { |
642 "description": "An attachment namespace defines read and write acces
s for all the attachments\ncreated under it. Each namespace is globally unique,
and owned by one\nproject which is the only project that can create attachments
under it.", | 864 "description": "An attachment namespace defines read and write acces
s for all the attachments\ncreated under it. Each namespace is globally unique,
and owned by one\nproject which is the only project that can create attachments
under it.", |
643 "id": "Namespace", | 865 "id": "Namespace", |
644 "properties": { | 866 "properties": { |
645 "namespaceName": { | |
646 "description": "Resource name of this namespace. Namespaces
names have the format:\n<code>namespaces/<var>namespace</var></code>.", | |
647 "type": "string" | |
648 }, | |
649 "servingVisibility": { | 867 "servingVisibility": { |
650 "description": "Specifies what clients may receive attachmen
ts under this namespace\nvia `beaconinfo.getforobserved`.", | 868 "description": "Specifies what clients may receive attachmen
ts under this namespace\nvia `beaconinfo.getforobserved`.", |
651 "enum": [ | 869 "enum": [ |
652 "VISIBILITY_UNSPECIFIED", | 870 "VISIBILITY_UNSPECIFIED", |
653 "UNLISTED", | 871 "UNLISTED", |
654 "PUBLIC" | 872 "PUBLIC" |
655 ], | 873 ], |
656 "enumDescriptions": [ | 874 "enumDescriptions": [ |
657 "Do not use this value.", | 875 "Do not use this value.", |
658 "Served only to the project that owns the namespace.", | 876 "Served only to the project that owns the namespace.", |
659 "Any project can subscribe to attachments under the name
space." | 877 "Any project can subscribe to attachments under the name
space." |
660 ], | 878 ], |
661 "type": "string" | 879 "type": "string" |
| 880 }, |
| 881 "namespaceName": { |
| 882 "description": "Resource name of this namespace. Namespaces
names have the format:\n<code>namespaces/<var>namespace</var></code>.", |
| 883 "type": "string" |
662 } | 884 } |
663 }, | 885 }, |
664 "type": "object" | 886 "type": "object" |
665 }, | 887 }, |
666 "AttachmentInfo": { | 888 "AttachmentInfo": { |
667 "description": "A subset of attachment information served via the\n`
beaconinfo.getforobserved` method, used when your users encounter your\nbeacons.
", | 889 "description": "A subset of attachment information served via the\n`
beaconinfo.getforobserved` method, used when your users encounter your\nbeacons.
", |
668 "id": "AttachmentInfo", | 890 "id": "AttachmentInfo", |
669 "properties": { | 891 "properties": { |
670 "data": { | 892 "data": { |
671 "description": "An opaque data container for client-provided
data.", | 893 "description": "An opaque data container for client-provided
data.", |
(...skipping 22 matching lines...) Expand all Loading... |
694 }, | 916 }, |
695 "type": "array" | 917 "type": "array" |
696 }, | 918 }, |
697 "advertisedId": { | 919 "advertisedId": { |
698 "$ref": "AdvertisedId", | 920 "$ref": "AdvertisedId", |
699 "description": "The ID advertised by the beacon." | 921 "description": "The ID advertised by the beacon." |
700 } | 922 } |
701 }, | 923 }, |
702 "type": "object" | 924 "type": "object" |
703 }, | 925 }, |
| 926 "DeleteAttachmentsResponse": { |
| 927 "description": "Response for a request to delete attachments.", |
| 928 "id": "DeleteAttachmentsResponse", |
| 929 "properties": { |
| 930 "numDeleted": { |
| 931 "description": "The number of attachments that were deleted.
", |
| 932 "format": "int32", |
| 933 "type": "integer" |
| 934 } |
| 935 }, |
| 936 "type": "object" |
| 937 }, |
704 "EphemeralIdRegistrationParams": { | 938 "EphemeralIdRegistrationParams": { |
705 "description": "Information a client needs to provision and register
beacons that\nbroadcast Eddystone-EID format beacon IDs, using Elliptic curve\n
Diffie-Hellman key exchange. See\n[the Eddystone specification](https://github.c
om/google/eddystone/tree/master/eddystone-eid) at GitHub.", | 939 "description": "Information a client needs to provision and register
beacons that\nbroadcast Eddystone-EID format beacon IDs, using Elliptic curve\n
Diffie-Hellman key exchange. See\n[the Eddystone specification](https://github.c
om/google/eddystone/tree/master/eddystone-eid) at GitHub.", |
706 "id": "EphemeralIdRegistrationParams", | 940 "id": "EphemeralIdRegistrationParams", |
707 "properties": { | 941 "properties": { |
| 942 "serviceEcdhPublicKey": { |
| 943 "description": "The beacon service's public key for use by a
beacon to derive its\nIdentity Key using Elliptic Curve Diffie-Hellman key exch
ange.", |
| 944 "format": "byte", |
| 945 "type": "string" |
| 946 }, |
708 "maxRotationPeriodExponent": { | 947 "maxRotationPeriodExponent": { |
709 "description": "Indicates the maximum rotation period suppor
ted by the service.\nSee EddystoneEidRegistration.rotation_period_exponent", | 948 "description": "Indicates the maximum rotation period suppor
ted by the service.\nSee EddystoneEidRegistration.rotation_period_exponent", |
710 "format": "uint32", | 949 "format": "uint32", |
711 "type": "integer" | 950 "type": "integer" |
712 }, | 951 }, |
713 "minRotationPeriodExponent": { | 952 "minRotationPeriodExponent": { |
714 "description": "Indicates the minimum rotation period suppor
ted by the service.\nSee EddystoneEidRegistration.rotation_period_exponent", | 953 "description": "Indicates the minimum rotation period suppor
ted by the service.\nSee EddystoneEidRegistration.rotation_period_exponent", |
715 "format": "uint32", | 954 "format": "uint32", |
716 "type": "integer" | 955 "type": "integer" |
717 }, | |
718 "serviceEcdhPublicKey": { | |
719 "description": "The beacon service's public key for use by a
beacon to derive its\nIdentity Key using Elliptic Curve Diffie-Hellman key exch
ange.", | |
720 "format": "byte", | |
721 "type": "string" | |
722 } | |
723 }, | |
724 "type": "object" | |
725 }, | |
726 "DeleteAttachmentsResponse": { | |
727 "description": "Response for a request to delete attachments.", | |
728 "id": "DeleteAttachmentsResponse", | |
729 "properties": { | |
730 "numDeleted": { | |
731 "description": "The number of attachments that were deleted.
", | |
732 "format": "int32", | |
733 "type": "integer" | |
734 } | 956 } |
735 }, | 957 }, |
736 "type": "object" | 958 "type": "object" |
737 }, | 959 }, |
738 "Observation": { | 960 "Observation": { |
739 "description": "Represents one beacon observed once.", | 961 "description": "Represents one beacon observed once.", |
740 "id": "Observation", | 962 "id": "Observation", |
741 "properties": { | 963 "properties": { |
742 "telemetry": { | 964 "telemetry": { |
743 "description": "The array of telemetry bytes received from t
he beacon. The server is\nresponsible for parsing it. This field may frequently
be empty, as\nwith a beacon that transmits telemetry only occasionally.", | 965 "description": "The array of telemetry bytes received from t
he beacon. The server is\nresponsible for parsing it. This field may frequently
be empty, as\nwith a beacon that transmits telemetry only occasionally.", |
744 "format": "byte", | 966 "format": "byte", |
745 "type": "string" | 967 "type": "string" |
746 }, | 968 }, |
747 "timestampMs": { | 969 "timestampMs": { |
748 "description": "Time when the beacon was observed.", | 970 "description": "Time when the beacon was observed.", |
749 "format": "google-datetime", | 971 "format": "google-datetime", |
750 "type": "string" | 972 "type": "string" |
751 }, | 973 }, |
752 "advertisedId": { | 974 "advertisedId": { |
753 "$ref": "AdvertisedId", | 975 "$ref": "AdvertisedId", |
754 "description": "The ID advertised by the beacon the client h
as encountered.\n\nIf the submitted `advertised_id` type is Eddystone-EID, then
the client\nmust be authorized to resolve the given beacon. Otherwise no data wi
ll be\nreturned for that beacon.\nRequired." | 976 "description": "The ID advertised by the beacon the client h
as encountered.\n\nIf the submitted `advertised_id` type is Eddystone-EID, then
the client\nmust be authorized to resolve the given beacon. Otherwise no data wi
ll be\nreturned for that beacon.\nRequired." |
755 } | 977 } |
756 }, | 978 }, |
757 "type": "object" | 979 "type": "object" |
758 }, | 980 }, |
759 "ListDiagnosticsResponse": { | 981 "ListDiagnosticsResponse": { |
760 "description": "Response that contains the requested diagnostics.", | 982 "description": "Response that contains the requested diagnostics.", |
761 "id": "ListDiagnosticsResponse", | 983 "id": "ListDiagnosticsResponse", |
762 "properties": { | 984 "properties": { |
| 985 "nextPageToken": { |
| 986 "description": "Token that can be used for pagination. Retur
ned only if the\nrequest matches more beacons than can be returned in this respo
nse.", |
| 987 "type": "string" |
| 988 }, |
763 "diagnostics": { | 989 "diagnostics": { |
764 "description": "The diagnostics matching the given request."
, | 990 "description": "The diagnostics matching the given request."
, |
765 "items": { | 991 "items": { |
766 "$ref": "Diagnostics" | 992 "$ref": "Diagnostics" |
767 }, | 993 }, |
768 "type": "array" | 994 "type": "array" |
769 }, | |
770 "nextPageToken": { | |
771 "description": "Token that can be used for pagination. Retur
ned only if the\nrequest matches more beacons than can be returned in this respo
nse.", | |
772 "type": "string" | |
773 } | 995 } |
774 }, | 996 }, |
775 "type": "object" | 997 "type": "object" |
776 }, | 998 }, |
777 "GetInfoForObservedBeaconsResponse": { | 999 "GetInfoForObservedBeaconsResponse": { |
778 "description": "Information about the requested beacons, optionally
including attachment\ndata.", | 1000 "description": "Information about the requested beacons, optionally
including attachment\ndata.", |
779 "id": "GetInfoForObservedBeaconsResponse", | 1001 "id": "GetInfoForObservedBeaconsResponse", |
780 "properties": { | 1002 "properties": { |
781 "beacons": { | 1003 "beacons": { |
782 "description": "Public information about beacons.\nMay be em
pty if the request matched no beacons.", | 1004 "description": "Public information about beacons.\nMay be em
pty if the request matched no beacons.", |
783 "items": { | 1005 "items": { |
784 "$ref": "BeaconInfo" | 1006 "$ref": "BeaconInfo" |
785 }, | 1007 }, |
786 "type": "array" | 1008 "type": "array" |
787 } | 1009 } |
788 }, | 1010 }, |
789 "type": "object" | 1011 "type": "object" |
790 }, | 1012 }, |
791 "Beacon": { | 1013 "Beacon": { |
792 "description": "Details of a beacon device.", | 1014 "description": "Details of a beacon device.", |
793 "id": "Beacon", | 1015 "id": "Beacon", |
794 "properties": { | 1016 "properties": { |
| 1017 "advertisedId": { |
| 1018 "$ref": "AdvertisedId", |
| 1019 "description": "The identifier of a beacon as advertised by
it. This field must be\npopulated when registering. It may be empty when updatin
g a beacon\nrecord because it is ignored in updates.\n\nWhen registering a beaco
n that broadcasts Eddystone-EID, this field\nshould contain a \"stable\" Eddysto
ne-UID that identifies the beacon and\nlinks it to its attachments. The stable E
ddystone-UID is only used for\nadministering the beacon." |
| 1020 }, |
| 1021 "provisioningKey": { |
| 1022 "description": "Some beacons may require a user to provide a
n authorization key before\nchanging any of its configuration (e.g. broadcast fr
ames, transmit power).\nThis field provides a place to store and control access
to that key.\nThis field is populated in responses to `GET /v1beta1/beacons/3!be
aconId`\nfrom users with write access to the given beacon. That is to say: If th
e\nuser is authorized to write the beacon's confidential data in the service,\nt
he service considers them authorized to configure the beacon. Note\nthat this ke
y grants nothing on the service, only on the beacon itself.", |
| 1023 "format": "byte", |
| 1024 "type": "string" |
| 1025 }, |
| 1026 "ephemeralIdRegistration": { |
| 1027 "$ref": "EphemeralIdRegistration", |
| 1028 "description": "Write-only registration parameters for beaco
ns using Eddystone-EID\n(remotely resolved ephemeral ID) format. This informatio
n will not be\npopulated in API responses. When submitting this data, the `adver
tised_id`\nfield must contain an ID of type Eddystone-UID. Any other ID type wil
l\nresult in an error." |
| 1029 }, |
| 1030 "latLng": { |
| 1031 "$ref": "LatLng", |
| 1032 "description": "The location of the beacon, expressed as a l
atitude and longitude pair.\nThis location is given when the beacon is registere
d or updated. It does\nnot necessarily indicate the actual current location of t
he beacon.\nOptional." |
| 1033 }, |
| 1034 "placeId": { |
| 1035 "description": "The [Google Places API](/places/place-id) Pl
ace ID of the place where\nthe beacon is deployed. This is given when the beacon
is registered or\nupdated, not automatically detected in any way.\nOptional.", |
| 1036 "type": "string" |
| 1037 }, |
| 1038 "description": { |
| 1039 "description": "Free text used to identify and describe the
beacon. Maximum length 140\ncharacters.\nOptional.", |
| 1040 "type": "string" |
| 1041 }, |
795 "properties": { | 1042 "properties": { |
796 "additionalProperties": { | 1043 "additionalProperties": { |
797 "type": "string" | 1044 "type": "string" |
798 }, | 1045 }, |
799 "description": "Properties of the beacon device, for example
battery type or firmware\nversion.\nOptional.", | 1046 "description": "Properties of the beacon device, for example
battery type or firmware\nversion.\nOptional.", |
800 "type": "object" | 1047 "type": "object" |
801 }, | 1048 }, |
802 "indoorLevel": { | |
803 "$ref": "IndoorLevel", | |
804 "description": "The indoor level information for this beacon
, if known. As returned by the\nGoogle Maps API.\nOptional." | |
805 }, | |
806 "status": { | 1049 "status": { |
807 "description": "Current status of the beacon.\nRequired.", | 1050 "description": "Current status of the beacon.\nRequired.", |
808 "enum": [ | 1051 "enum": [ |
809 "STATUS_UNSPECIFIED", | 1052 "STATUS_UNSPECIFIED", |
810 "ACTIVE", | 1053 "ACTIVE", |
811 "DECOMMISSIONED", | 1054 "DECOMMISSIONED", |
812 "INACTIVE" | 1055 "INACTIVE" |
813 ], | 1056 ], |
814 "enumDescriptions": [ | 1057 "enumDescriptions": [ |
815 "Do not use this value.", | 1058 "Do not use this value.", |
816 "The \"normal\" in-use state of a beacon.", | 1059 "The \"normal\" in-use state of a beacon.", |
817 "Beacon should no longer be used for any purpose. This i
s irreversible.", | 1060 "Beacon should no longer be used for any purpose. This i
s irreversible.", |
818 "The beacon should not be visible to mobile devices. Thi
s is reversible." | 1061 "The beacon should not be visible to mobile devices. Thi
s is reversible." |
819 ], | 1062 ], |
820 "type": "string" | 1063 "type": "string" |
821 }, | 1064 }, |
| 1065 "indoorLevel": { |
| 1066 "$ref": "IndoorLevel", |
| 1067 "description": "The indoor level information for this beacon
, if known. As returned by the\nGoogle Maps API.\nOptional." |
| 1068 }, |
822 "beaconName": { | 1069 "beaconName": { |
823 "description": "Resource name of this beacon. A beacon name
has the format\n\"beacons/N!beaconId\" where the beaconId is the base16 ID broad
cast by\nthe beacon and N is a code for the beacon's type. Possible values are\n
`3` for Eddystone, `1` for iBeacon, or `5` for AltBeacon.\n\nThis field must be
left empty when registering. After reading a beacon,\nclients can use the name f
or future operations.", | 1070 "description": "Resource name of this beacon. A beacon name
has the format\n\"beacons/N!beaconId\" where the beaconId is the base16 ID broad
cast by\nthe beacon and N is a code for the beacon's type. Possible values are\n
`3` for Eddystone, `1` for iBeacon, or `5` for AltBeacon.\n\nThis field must be
left empty when registering. After reading a beacon,\nclients can use the name f
or future operations.", |
824 "type": "string" | 1071 "type": "string" |
825 }, | 1072 }, |
826 "expectedStability": { | 1073 "expectedStability": { |
827 "description": "Expected location stability. This is set whe
n the beacon is registered or\nupdated, not automatically detected in any way.\n
Optional.", | 1074 "description": "Expected location stability. This is set whe
n the beacon is registered or\nupdated, not automatically detected in any way.\n
Optional.", |
828 "enum": [ | 1075 "enum": [ |
829 "STABILITY_UNSPECIFIED", | 1076 "STABILITY_UNSPECIFIED", |
830 "STABLE", | 1077 "STABLE", |
831 "PORTABLE", | 1078 "PORTABLE", |
832 "MOBILE", | 1079 "MOBILE", |
833 "ROVING" | 1080 "ROVING" |
834 ], | 1081 ], |
835 "enumDescriptions": [ | 1082 "enumDescriptions": [ |
836 "Do not use this value.", | 1083 "Do not use this value.", |
837 "Not expected to move, for example a store's front door.
", | 1084 "Not expected to move, for example a store's front door.
", |
838 "Usually stable but may move rarely, usually within a si
ngle place,\nfor example a store display.", | 1085 "Usually stable but may move rarely, usually within a si
ngle place,\nfor example a store display.", |
839 "Moves frequently, for example a personal item or food t
ruck.", | 1086 "Moves frequently, for example a personal item or food t
ruck.", |
840 "Moves continuously in service, for example a bus or tra
in." | 1087 "Moves continuously in service, for example a bus or tra
in." |
841 ], | 1088 ], |
842 "type": "string" | 1089 "type": "string" |
843 }, | |
844 "advertisedId": { | |
845 "$ref": "AdvertisedId", | |
846 "description": "The identifier of a beacon as advertised by
it. This field must be\npopulated when registering. It may be empty when updatin
g a beacon\nrecord because it is ignored in updates.\n\nWhen registering a beaco
n that broadcasts Eddystone-EID, this field\nshould contain a \"stable\" Eddysto
ne-UID that identifies the beacon and\nlinks it to its attachments. The stable E
ddystone-UID is only used for\nadministering the beacon." | |
847 }, | |
848 "provisioningKey": { | |
849 "description": "Some beacons may require a user to provide a
n authorization key before\nchanging any of its configuration (e.g. broadcast fr
ames, transmit power).\nThis field provides a place to store and control access
to that key.\nThis field is populated in responses to `GET /v1beta1/beacons/3!be
aconId`\nfrom users with write access to the given beacon. That is to say: If th
e\nuser is authorized to write the beacon's confidential data in the service,\nt
he service considers them authorized to configure the beacon. Note\nthat this ke
y grants nothing on the service, only on the beacon itself.", | |
850 "format": "byte", | |
851 "type": "string" | |
852 }, | |
853 "ephemeralIdRegistration": { | |
854 "$ref": "EphemeralIdRegistration", | |
855 "description": "Write-only registration parameters for beaco
ns using Eddystone-EID\n(remotely resolved ephemeral ID) format. This informatio
n will not be\npopulated in API responses. When submitting this data, the `adver
tised_id`\nfield must contain an ID of type Eddystone-UID. Any other ID type wil
l\nresult in an error." | |
856 }, | |
857 "latLng": { | |
858 "$ref": "LatLng", | |
859 "description": "The location of the beacon, expressed as a l
atitude and longitude pair.\nThis location is given when the beacon is registere
d or updated. It does\nnot necessarily indicate the actual current location of t
he beacon.\nOptional." | |
860 }, | |
861 "placeId": { | |
862 "description": "The [Google Places API](/places/place-id) Pl
ace ID of the place where\nthe beacon is deployed. This is given when the beacon
is registered or\nupdated, not automatically detected in any way.\nOptional.", | |
863 "type": "string" | |
864 }, | |
865 "description": { | |
866 "description": "Free text used to identify and describe the
beacon. Maximum length 140\ncharacters.\nOptional.", | |
867 "type": "string" | |
868 } | 1090 } |
869 }, | 1091 }, |
870 "type": "object" | 1092 "type": "object" |
871 }, | 1093 }, |
872 "AdvertisedId": { | 1094 "AdvertisedId": { |
873 "description": "Defines a unique identifier of a beacon as broadcast
by the device.", | 1095 "description": "Defines a unique identifier of a beacon as broadcast
by the device.", |
874 "id": "AdvertisedId", | 1096 "id": "AdvertisedId", |
875 "properties": { | 1097 "properties": { |
876 "type": { | 1098 "type": { |
877 "description": "Specifies the identifier type.\nRequired.", | 1099 "description": "Specifies the identifier type.\nRequired.", |
(...skipping 13 matching lines...) Expand all Loading... |
891 ], | 1113 ], |
892 "type": "string" | 1114 "type": "string" |
893 }, | 1115 }, |
894 "id": { | 1116 "id": { |
895 "description": "The actual beacon identifier, as broadcast b
y the beacon hardware. Must be\n[base64](http://tools.ietf.org/html/rfc4648#sect
ion-4) encoded in HTTP\nrequests, and will be so encoded (with padding) in respo
nses. The base64\nencoding should be of the binary byte-stream and not any textu
al (such as\nhex) representation thereof.\nRequired.", | 1117 "description": "The actual beacon identifier, as broadcast b
y the beacon hardware. Must be\n[base64](http://tools.ietf.org/html/rfc4648#sect
ion-4) encoded in HTTP\nrequests, and will be so encoded (with padding) in respo
nses. The base64\nencoding should be of the binary byte-stream and not any textu
al (such as\nhex) representation thereof.\nRequired.", |
896 "format": "byte", | 1118 "format": "byte", |
897 "type": "string" | 1119 "type": "string" |
898 } | 1120 } |
899 }, | 1121 }, |
900 "type": "object" | 1122 "type": "object" |
901 }, | |
902 "IndoorLevel": { | |
903 "description": "Indoor level, a human-readable string as returned by
Google Maps APIs,\nuseful to indicate which floor of a building a beacon is loc
ated on.", | |
904 "id": "IndoorLevel", | |
905 "properties": { | |
906 "name": { | |
907 "description": "The name of this level.", | |
908 "type": "string" | |
909 } | |
910 }, | |
911 "type": "object" | |
912 }, | |
913 "Date": { | |
914 "description": "Represents a whole calendar date, e.g. date of birth
. The time of day and\ntime zone are either specified elsewhere or are not signi
ficant. The date\nis relative to the Proleptic Gregorian Calendar. The day may b
e 0 to\nrepresent a year and month where the day is not significant, e.g. credit
card\nexpiration date. The year may be 0 to represent a month and day independe
nt\nof year, e.g. anniversary date. Related types are google.type.TimeOfDay\nand
`google.protobuf.Timestamp`.", | |
915 "id": "Date", | |
916 "properties": { | |
917 "month": { | |
918 "description": "Month of year. Must be from 1 to 12.", | |
919 "format": "int32", | |
920 "type": "integer" | |
921 }, | |
922 "day": { | |
923 "description": "Day of month. Must be from 1 to 31 and valid
for the year and month, or 0\nif specifying a year/month where the day is not s
ignificant.", | |
924 "format": "int32", | |
925 "type": "integer" | |
926 }, | |
927 "year": { | |
928 "description": "Year of date. Must be from 1 to 9999, or 0 i
f specifying a date without\na year.", | |
929 "format": "int32", | |
930 "type": "integer" | |
931 } | |
932 }, | |
933 "type": "object" | |
934 }, | |
935 "ListNamespacesResponse": { | |
936 "description": "Response to ListNamespacesRequest that contains all
the project's namespaces.", | |
937 "id": "ListNamespacesResponse", | |
938 "properties": { | |
939 "namespaces": { | |
940 "description": "The attachments that corresponded to the req
uest params.", | |
941 "items": { | |
942 "$ref": "Namespace" | |
943 }, | |
944 "type": "array" | |
945 } | |
946 }, | |
947 "type": "object" | |
948 }, | |
949 "Diagnostics": { | |
950 "description": "Diagnostics for a single beacon.", | |
951 "id": "Diagnostics", | |
952 "properties": { | |
953 "alerts": { | |
954 "description": "An unordered list of Alerts that the beacon
has.", | |
955 "enumDescriptions": [ | |
956 "Invalid value. Should never appear.", | |
957 "The beacon has been reported in a location different th
an its registered\nlocation. This may indicate that the beacon has been moved. T
his signal\nis not 100% accurate, but indicates that further investigation is wo
rth\nwhile.", | |
958 "The battery level for the beacon is low enough that, gi
ven the beacon's\ncurrent use, its battery will run out with in the next 60 days
. This\nindicates that the battery should be replaced soon." | |
959 ], | |
960 "items": { | |
961 "enum": [ | |
962 "ALERT_UNSPECIFIED", | |
963 "WRONG_LOCATION", | |
964 "LOW_BATTERY" | |
965 ], | |
966 "type": "string" | |
967 }, | |
968 "type": "array" | |
969 }, | |
970 "estimatedLowBatteryDate": { | |
971 "$ref": "Date", | |
972 "description": "The date when the battery is expected to be
low. If the value is missing\nthen there is no estimate for when the battery wil
l be low.\nThis value is only an estimate, not an exact date." | |
973 }, | |
974 "beaconName": { | |
975 "description": "Resource name of the beacon. For Eddystone-E
ID beacons, this may\nbe the beacon's current EID, or the beacon's \"stable\" Ed
dystone-UID.", | |
976 "type": "string" | |
977 } | |
978 }, | |
979 "type": "object" | |
980 }, | |
981 "ListBeaconsResponse": { | |
982 "description": "Response that contains list beacon results and pagin
ation help.", | |
983 "id": "ListBeaconsResponse", | |
984 "properties": { | |
985 "totalCount": { | |
986 "description": "Estimate of the total number of beacons matc
hed by the query. Higher\nvalues may be less accurate.", | |
987 "format": "int64", | |
988 "type": "string" | |
989 }, | |
990 "beacons": { | |
991 "description": "The beacons that matched the search criteria
.", | |
992 "items": { | |
993 "$ref": "Beacon" | |
994 }, | |
995 "type": "array" | |
996 }, | |
997 "nextPageToken": { | |
998 "description": "An opaque pagination token that the client m
ay provide in their next\nrequest to retrieve the next page of results.", | |
999 "type": "string" | |
1000 } | |
1001 }, | |
1002 "type": "object" | |
1003 }, | |
1004 "Empty": { | |
1005 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", | |
1006 "id": "Empty", | |
1007 "properties": {}, | |
1008 "type": "object" | |
1009 }, | |
1010 "GetInfoForObservedBeaconsRequest": { | |
1011 "description": "Request for beacon and attachment information about
beacons that\na mobile client has encountered \"in the wild\".", | |
1012 "id": "GetInfoForObservedBeaconsRequest", | |
1013 "properties": { | |
1014 "observations": { | |
1015 "description": "The beacons that the client has encountered.
\nAt least one must be given.", | |
1016 "items": { | |
1017 "$ref": "Observation" | |
1018 }, | |
1019 "type": "array" | |
1020 }, | |
1021 "namespacedTypes": { | |
1022 "description": "Specifies what kind of attachments to includ
e in the response.\nWhen given, the response will include only attachments of th
e given types.\nWhen empty, no attachments will be returned. Must be in the form
at\n<var>namespace/type</var>. Accepts `*` to specify all types in\nall namespac
es owned by the client.\nOptional.", | |
1023 "items": { | |
1024 "type": "string" | |
1025 }, | |
1026 "type": "array" | |
1027 } | |
1028 }, | |
1029 "type": "object" | |
1030 }, | |
1031 "BeaconAttachment": { | |
1032 "description": "Project-specific data associated with a beacon.", | |
1033 "id": "BeaconAttachment", | |
1034 "properties": { | |
1035 "attachmentName": { | |
1036 "description": "Resource name of this attachment. Attachment
names have the format:\n<code>beacons/<var>beacon_id</var>/attachments/<var>att
achment_id</var></code>.\nLeave this empty on creation.", | |
1037 "type": "string" | |
1038 }, | |
1039 "namespacedType": { | |
1040 "description": "Specifies what kind of attachment this is. T
ells a client how to\ninterpret the `data` field. Format is <var>namespace/type<
/var>. Namespace\nprovides type separation between clients. Type describes the t
ype of\n`data`, for use by the client when parsing the `data` field.\nRequired."
, | |
1041 "type": "string" | |
1042 }, | |
1043 "data": { | |
1044 "description": "An opaque data container for client-provided
data. Must be\n[base64](http://tools.ietf.org/html/rfc4648#section-4) encoded i
n HTTP\nrequests, and will be so encoded (with padding) in responses.\nRequired.
", | |
1045 "format": "byte", | |
1046 "type": "string" | |
1047 }, | |
1048 "creationTimeMs": { | |
1049 "description": "The UTC time when this attachment was create
d, in milliseconds since the\nUNIX epoch.", | |
1050 "format": "google-datetime", | |
1051 "type": "string" | |
1052 } | |
1053 }, | |
1054 "type": "object" | |
1055 }, | |
1056 "EphemeralIdRegistration": { | |
1057 "description": "Write-only registration parameters for beacons using
Eddystone-EID format.\nTwo ways of securely registering an Eddystone-EID beacon
with the service\nare supported:\n\n1. Perform an ECDH key exchange via this AP
I, including a previous call\n to `GET /v1beta1/eidparams`. In this case the f
ields\n `beacon_ecdh_public_key` and `service_ecdh_public_key` should be\n p
opulated and `beacon_identity_key` should not be populated. This\n method ensu
res that only the two parties in the ECDH key exchange can\n compute the ident
ity key, which becomes a secret between them.\n2. Derive or obtain the beacon's
identity key via other secure means\n (perhaps an ECDH key exchange between th
e beacon and a mobile device\n or any other secure method), and then submit th
e resulting identity key\n to the service. In this case `beacon_identity_key`
field should be\n populated, and neither of `beacon_ecdh_public_key` nor\n `
service_ecdh_public_key` fields should be. The security of this method\n depen
ds on how securely the parties involved (in particular the\n bluetooth client)
handle the identity key, and obviously on how\n securely the identity key was
generated.\n\nSee [the Eddystone specification](https://github.com/google/eddys
tone/tree/master/eddystone-eid) at GitHub.", | |
1058 "id": "EphemeralIdRegistration", | |
1059 "properties": { | |
1060 "initialClockValue": { | |
1061 "description": "The initial clock value of the beacon. The b
eacon's clock must have\nbegun counting at this value immediately prior to trans
mitting this\nvalue to the resolving service. Significant delay in transmitting
this\nvalue to the service risks registration or resolution failures. If a\nvalu
e is not provided, the default is zero.", | |
1062 "format": "uint64", | |
1063 "type": "string" | |
1064 }, | |
1065 "beaconEcdhPublicKey": { | |
1066 "description": "The beacon's public key used for the Ellipti
c curve Diffie-Hellman\nkey exchange. When this field is populated, `service_ecd
h_public_key`\nmust also be populated, and `beacon_identity_key` must not be.", | |
1067 "format": "byte", | |
1068 "type": "string" | |
1069 }, | |
1070 "rotationPeriodExponent": { | |
1071 "description": "Indicates the nominal period between each ro
tation of the beacon's\nephemeral ID. \"Nominal\" because the beacon should rand
omize the\nactual interval. See [the spec at github](https://github.com/google/e
ddystone/tree/master/eddystone-eid)\nfor details. This value corresponds to a po
wer-of-two scaler on the\nbeacon's clock: when the scaler value is K, the beacon
will begin\nbroadcasting a new ephemeral ID on average every 2^K seconds.", | |
1072 "format": "uint32", | |
1073 "type": "integer" | |
1074 }, | |
1075 "serviceEcdhPublicKey": { | |
1076 "description": "The service's public key used for the Ellipt
ic curve Diffie-Hellman\nkey exchange. When this field is populated, `beacon_ecd
h_public_key`\nmust also be populated, and `beacon_identity_key` must not be.", | |
1077 "format": "byte", | |
1078 "type": "string" | |
1079 }, | |
1080 "beaconIdentityKey": { | |
1081 "description": "The private key of the beacon. If this field
is populated,\n`beacon_ecdh_public_key` and `service_ecdh_public_key` must not
be\npopulated.", | |
1082 "format": "byte", | |
1083 "type": "string" | |
1084 }, | |
1085 "initialEid": { | |
1086 "description": "An initial ephemeral ID calculated using the
clock value submitted as\n`initial_clock_value`, and the secret key generated b
y the\nDiffie-Hellman key exchange using `service_ecdh_public_key` and\n`service
_ecdh_public_key`. This initial EID value will be used by the\nservice to confir
m that the key exchange process was successful.", | |
1087 "format": "byte", | |
1088 "type": "string" | |
1089 } | |
1090 }, | |
1091 "type": "object" | |
1092 }, | |
1093 "LatLng": { | |
1094 "description": "An object representing a latitude/longitude pair. Th
is is expressed as a pair\nof doubles representing degrees latitude and degrees
longitude. Unless\nspecified otherwise, this must conform to the\n<a href=\"http
://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf\">WGS84\nstandard</a>. Values
must be within normalized ranges.\n\nExample of normalization code in Python:\n
\n def NormalizeLongitude(longitude):\n \"\"\"Wraps decimal degrees long
itude to [-180.0, 180.0].\"\"\"\n q, r = divmod(longitude, 360.0)\n if
r > 180.0 or (r == 180.0 and q <= -1.0):\n return r - 360.0\n retur
n r\n\n def NormalizeLatLng(latitude, longitude):\n \"\"\"Wraps decimal
degrees latitude and longitude to\n [-90.0, 90.0] and [-180.0, 180.0], resp
ectively.\"\"\"\n r = latitude % 360.0\n if r <= 90.0:\n return
r, NormalizeLongitude(longitude)\n elif r >= 270.0:\n return r - 36
0, NormalizeLongitude(longitude)\n else:\n return 180 - r, Normalize
Longitude(longitude + 180.0)\n\n assert 180.0 == NormalizeLongitude(180.0)\n
assert -180.0 == NormalizeLongitude(-180.0)\n assert -179.0 == NormalizeLo
ngitude(181.0)\n assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)\n assert
(0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)\n assert (85.0, 180.0) == Normali
zeLatLng(95.0, 0.0)\n assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)\
n assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)\n assert (-90.0, -10.
0) == NormalizeLatLng(-90.0, -10.0)\n assert (0.0, -170.0) == NormalizeLatLng
(-180.0, 10.0)\n assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)\n as
sert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)\n assert (90.0, 10.0) == N
ormalizeLatLng(-270.0, 10.0)", | |
1095 "id": "LatLng", | |
1096 "properties": { | |
1097 "latitude": { | |
1098 "description": "The latitude in degrees. It must be in the r
ange [-90.0, +90.0].", | |
1099 "format": "double", | |
1100 "type": "number" | |
1101 }, | |
1102 "longitude": { | |
1103 "description": "The longitude in degrees. It must be in the
range [-180.0, +180.0].", | |
1104 "format": "double", | |
1105 "type": "number" | |
1106 } | |
1107 }, | |
1108 "type": "object" | |
1109 }, | |
1110 "ListBeaconAttachmentsResponse": { | |
1111 "description": "Response to `ListBeaconAttachments` that contains th
e requested attachments.", | |
1112 "id": "ListBeaconAttachmentsResponse", | |
1113 "properties": { | |
1114 "attachments": { | |
1115 "description": "The attachments that corresponded to the req
uest params.", | |
1116 "items": { | |
1117 "$ref": "BeaconAttachment" | |
1118 }, | |
1119 "type": "array" | |
1120 } | |
1121 }, | |
1122 "type": "object" | |
1123 } | 1123 } |
1124 }, | 1124 }, |
1125 "servicePath": "", | 1125 "servicePath": "", |
1126 "title": "Google Proximity Beacon API", | 1126 "title": "Google Proximity Beacon API", |
1127 "version": "v1beta1" | 1127 "version": "v1beta1" |
1128 } | 1128 } |
OLD | NEW |