Page Summary
-
This page details how to retrieve information about a specific device using a
GETrequest to the provided URL. -
The request URL requires a
deviceIdpath parameter, which is a unique identifier for the target device. -
The request body must be empty when retrieving device information.
-
A successful request will return device information in the response body, formatted as an
AmbientDeviceinstance. -
Authorization for this request requires the
https://www.googleapis.com/auth/photosambient.mediaitemsOAuth scope.
Retrieves information about the specified device.
A NOT_FOUND error is returned if the device does not exist or is not owned by the user.
HTTP request
GET https://photosambient.googleapis.com/v1/devices/{deviceId}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
deviceId |
Required. The unique identifier for this device. |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of AmbientDevice.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/photosambient.mediaitems