Generate Google API credentials

Back to Help

Google imposes the following limits on its Photos API:

  • 10,000 metadata requests per day
  • 75,000 media downloads per day

This is far too low to be sufficient for all users of this app put together, so it is currently a requirement that you generate your own set of credentials for use with the Google API.

Note
The steps outlined on this page can be tricky to get right if you aren't familiar with Google Cloud. Feel free to contact us if you need help!

Follow the steps in this screencast to generate a set of Google API credentials, or follow the written instructions below:

1. Create a project

  • Navigate to the Google Cloud console
  • Create a new project by invoking the project selector at the top of the screen
  • Give your new project a name, wait until it is created, and select it as the active project

2. Enable Photos API

  • Head to the APIs and Services section
  • Click on Enable APIs and Services, search for photos, and enable the Photos Library API
  • Click on OAuth consent screen
  • Set User Type to External
  • Provide a name (pick any identifier here), a support email (this is usually the email you sign in to Google with), and a contact email (feel free to choose any email address here)
  • Next up: scopes. These control your instance of gScreen's access to your Google account. gScreen needs to read your email address and your photo library, so make sure to add both these scopes:
    • https://www.googleapis.com/auth/userinfo.email
    • https://www.googleapis.com/auth/photoslibrary.readonly
  • On the next page, add Test users. These are the only users who will be able to use the credentials we're generating here, so make sure to add your own email address as well as any others you'd like to use with gScreen.

4. Generate credentials

  • Click on Credentials in the sidebar, and create an OAuth client ID
  • Create the client ID using these values:
    • Application type: Web application
    • Name: <anything goes here>
    • Authorized redirect URIs: https://photoslideshow.app/oauth/callback
  • Click on Create, and you should be presented with a Client ID and a Client secret