About the Google Photos Ambient API

  • The Google Photos Ambient API allows developers to integrate Google Photos into slideshow experiences on smart TVs and photo frames.

  • Developers can use the Ambient API to curate and display personalized photos and videos from users' Google Photos libraries on ambient devices.

  • The API utilizes OAuth 2.0 for TV and Limited-Input Device Applications with a state parameter for user authentication.

  • To use the Ambient API, users must be signed in to a valid Google Account as service accounts are not supported.

  • Guides and reference documents are available for configuring applications, managing devices, and listing/retrieving media items.

The Google Photos Ambient API empowers you to create slideshow experiences that integrate with Google Photos on ambient devices like smart TVs and photo frames.

With the Ambient API, you can:

  • Curate visual content: Display personalized photos and videos from users' Google Photos libraries on ambient devices.
  • Enhance ambient experiences: Build innovative applications that use Google Photos content to enrich the user experience in homes and other environments.

Authorization

The Ambient API uses OAuth 2.0 for TV and Limited-Input Device Applications, and with an added state parameter for a more streamlined user authentication flow.

Review our guide on configuring your app for the Ambient API to get set up and get ready to use the API.

Learn more

Get started with the Ambient API: Learn about the standard workflow for the Ambient API and review important considerations.

Configure your app: set up your project and set up authentication and review the streamlined authentication flow.

Review our developer guides: the how-to guides and concepts around using the Ambient API.

Reference documentation: the Ambient API reference documentation.

Samples: Download and run a sample to see the Ambient API in Application.