Google Photos
Prev  File and Document Management  Next

Google Photos

The Google Photos modules enable you to create, list, retrieve, share and unshare albums and monitor, retrieve, download or upload media in your Google Photos.

Getting Started with Google Photos

Prerequisites

  • A Google account

In order to use Google Photos with {{Make}}, it is necessary to have a Google account. If you do not have one, you can create a Google account at photos.google.com.

Obtain client credentials for your custom app

To obtain the client credentials, you must have access to Google Cloud Console and be able to create or edit the project.

  1. Sign in to Google Cloud console using your Google credentials.

  2. Click Select a project > NEW PROJECT. Enter the desired project name, and click the CREATE button.

    61f26f540fc73.gif

  3. Select the project you have created.

    61f26f58533ba.gif

  4. Go to APIs & Services > Library.

    61f26f5b27f1a.gif

  5. Search and enable the following required APIs:

    • Cloud Resource Manager API

    The desired service option should display as you type. Select the API/service you want to connect to {{Make}}.

    61f26f5e01d32.gif

  6. Click the ENABLE button to enable the selected API.

  7. Navigate to APIs & Services > OAuth consent screen.

    61f26f606a4df.gif

  8. Choose the External option, and click the CREATE button.

    [Note] Note

    You will not be charged when selecting this option! For more details, please refer to Google's Exceptions to verification requirements.

  9. Fill in the required fields as follows, and then click Save and Continue:

    App name

    Enter the name of the app asking for consent. For example,  {{Make}}.

    Authorized domains

    • make.com

    • integromat.com

    • celonis.cloud

  10. You don't have to set anything in the Scopes and Optional info sections. Click Save and Continue.

  11. In the Test Users section, click ADD USERS and enter the testing user email address to access the app.

    google-cloud-storage-1.png

  12. Navigate to Credentials. Click the +CREATE CREDENTIALS and select the OAuth Client ID option.

    61f26f63118aa.gif

  13. Fill in the required fields as follows, and then click the CREATE button to create the application:

    61f26f65799c3.gif

    Application type

    web application

    Name

    Name of the application. For example, {{Make}}.

    Authorized redirect URIs

    https://www.integromat.com/oauth/cb/google-restricted https://www.celonis.cloud/oauth/cb/google-restricted

  14. A dialog containing the app's Client ID and Client Secret is displayed. Save them in a safe place for later use.

    61f26f68840d8.png

You have successfully created the client credentials.

[Note] Note

If you are using custom apps with publishing state, Testing, then you must set up the access token NOT TO be forced to re-authenticate every week after expiration.

For more information, see on setting up OAuth consent screen.

To set up app token and authentication, see using OAuth 2.0 for Web Server applications.
Connect Google Photos to {{Make}}

To connect Google Photos app:

  1. Log in to your {{Make}} account, insert a Google Cloud Print module in your scenario, and click the Add button next to the Connection field.

    Google_Photos_1.png

  2. Optional: In the Connection name field, enter a name for the connection.

  3. Optional: Click Show advanced settings and enter the client credentials of your custom app.

    Google_Photos_2.png

  4. Click Save.

  5. Confirm the permissions dialog by clicking the Allow button.

    Google_Photos_3.png

You have successfully established the connection. You can now edit your scenario and add more Google Photos modules. If your connection needs reauthorization at any point, follow the connection renewal steps here.

Album
List Albums

Retrieves album from your Google Photos.

Connection

Establish a connection to your Google account.

Retrieve only albums created using API

If this option is enabled, only albums that were created by (any) API will be returned.

Limit

Set the maximum number of albums {{Make}} will return during one execution cycle.
Get an Album

Retrieves album details.

Connection

Establish a connection to your Google account.

Album ID

Enter (map) or select the album you want to retrieve details about.
Create an Album

Creates a new empty album.

Connection

Establish a connection to your Google account.

Title

Enter the name for the new album.
Share an Album

Marks an album as shared and accessible to other users.

[Note] Note

This action can only be performed on albums that were created via the API (using {{Make}}).

Connection

Establish a connection to your Google account.

Album ID

Select or map the album you want to share. Only albums created using API are available.

Collaborative

Enable this option to allow users who have joined the album to add media items to it.

Commentable

Enable this option to allow the owner and the users who have joined the album to add comments to the album.
Unshare an Album

Marks a via API shared album as private.

Connection

Establish a connection to your Google account.

Album ID

Select or map the album you want to unshare. Only albums created and shared using API are available.
Media
Watch Media Items

Retrieves media details when new media are added to an album.

Connection

Establish a connection to your Google account.

Album

Select the album you want to watch for new media. If no album is selected, all albums will be monitored.

Limit

Set the maximum number of media {{Make}} will return during one execution cycle.
List Media Items

Retrieves media from the specified album.

Connection

Establish a connection to your Google account.

Album ID

Select or map the album you want to retrieve media from. If no album is selected, all media in your account will be retrieved.

Limit

Set the maximum number of media {{Make}} will return during one execution cycle.
Get a Media Item

Retrieves details of a specified media.

Connection

Establish a connection to your Google account.

Media Item ID

Select or map the ID of the media you want to retrieve details about.
Download a Media File

Downloads a file from the Base URL provided by the Watch Media Items, List Media Items, or Get a Media Item modules.

Base URL

Map the Base URL from the previous module.
google_photos1.png
Upload a Media Item

Uploads a file to an album.

[Note] Note

Files can be uploaded only to the albums that were created using {{Make}} (or via another API).

The maximum file sizes and other useful information can be found in the Google Photos Documentation for Uploading Media.

Connection

Establish a connection to your Google account.

Source File

Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file).

Description

Enter the description for the media.

Album

Select the album you want to upload the media to. The album must be created by {{Make}} (or via another API).
Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your Google account.

URL

Enter a path relative to https://photoslibrary.googleapis.com.E.g./v1/albums

[Note] Note

For the list of available endpoints, refer to the Photos Library API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.
Example of Use - List Albums

The following API call returns the all albums in your Google Photos:

URL:

/v1/albums

Method:

GET

61f26fa6eea70.png

The results can be found in the module's Output under Bundle > Body > albums.

In our example, 10 tickets were returned:

61f26fa7d9629.png
Prev  Up  Next
Google Keep  Home  Google Slides