Google Photos Ambient API

  • This API allows viewing photos from a user's Google Photos library on connected ambient devices.

  • It provides REST resources for managing ambient devices, including creation, deletion, retrieval, and updating of device information.

  • The API enables the retrieval of a list of media items to be displayed on configured ambient devices.

  • The base URL for the API service is https://photosambient.googleapis.com.

View photos from your Google Photos library on connected ambient devices.

Service: photosambient.googleapis.com

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://photosambient.googleapis.com

REST Resource: v1.devices

Methods
create POST /v1/devices
Creates an ambient device in the user's Google Photos account.
delete DELETE /v1/devices/{deviceId}
Removes the specified device from to the user's Google Photos account.
get GET /v1/devices/{deviceId}
Retrieves information about the specified device.
patch PATCH /v1/devices/{deviceId}
Updates information about the specified device.

REST Resource: v1.mediaItems

Methods
list GET /v1/mediaItems
Returns a list of ambient media items from user-configured media sources for the specified device.