Method: devices.get

  • This page details how to retrieve information about a specific device using a GET request to the provided URL.

  • The request URL requires a deviceId path 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 AmbientDevice instance.

  • Authorization for this request requires the https://www.googleapis.com/auth/photosambient.mediaitems OAuth 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

string

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