Google Photos

Google Photos integration (Storage, Design). Imported from open-connector.

OAuth17 toolshttps://photoslibrary.googleapis.com/v1

POST

googlephotos_list_albums

List Google Photos albums visible to the current application connection. If you need the user to choose from their existing Google Photos library, use the Pick…

/albums

2 parameters

Param	Type	Required	Description
pageSize	integer	optional	The maximum number of albums to return per page (1-50).
pageToken	string	optional	A page token to retrieve the next page of results.

POST

googlephotos_get_album

Fetch one Google Photos album by ID.

/albums/{albumId}

1 parameter

Param	Type	Required	Description
albumId	string	required	The ID of the album to fetch.

POST

googlephotos_create_album

Create a Google Photos album.

/albums

1 parameter

Param	Type	Required	Description
title	string	required	The title for the new album (maximum 500 characters).

PATCH

googlephotos_update_album

Update a Google Photos album title or cover photo.

/albums/{albumId}

3 parameters

Param	Type	Required	Description
albumId	string	required	The ID of the album to update.
title	string	optional	The new title for the album (maximum 500 characters).
coverPhotoMediaItemId	string	optional	The media item ID to set as the new album cover photo.

POST

googlephotos_add_enrichment

Add an enrichment item to a Google Photos album.

/albums/{albumId}

3 parameters

Param	Type	Required	Description
albumId	string	required	The ID of the album to add the enrichment to.
albumPosition	object	required	The position type within the album.
newEnrichmentItem	object	required	One Google Photos enrichment variant.

POST

googlephotos_list_media_items

List Google Photos Library API media items created by this application.

/mediaItems

2 parameters

Param	Type	Required	Description
pageSize	integer	optional	The maximum number of media items to return per page (1-100).
pageToken	string	optional	A page token to retrieve the next page of results.

POST

googlephotos_search_media_items

Search Google Photos Library API media items created by this application.

/mediaItems

5 parameters

Param	Type	Required	Description
albumId	string	optional	The ID of the album to search within.
pageSize	integer	optional	The maximum number of media items to return per page (1-100).
pageToken	string	optional	A page token to retrieve the next page of results.
orderBy	string	optional	The sort order for the results.
filters	object	optional	A JSON-like object with arbitrary string keys.

POST

googlephotos_batch_get_media_items

Fetch multiple Google Photos media items by ID.

/mediaItems

1 parameter

Param	Type	Required	Description
mediaItemIds	array	required	The list of media item IDs to fetch (1-50).

GET

googlephotos_get_media_item_download

Download a Google Photos Library API media item created by this application through local file transit.

/mediaItems/{mediaItemId}

1 parameter

Param	Type	Required	Description
mediaItemId	string	required	The ID of the media item to download.

GET

googlephotos_upload_media

Upload one media item into Google Photos from a URL or base64 payload.

/mediaItems

5 parameters

Param	Type	Required	Description
url	string	optional	The URL of the media file to upload.
contentBase64	string	optional	The base64-encoded content of the media file to upload.
fileName	string	optional	The filename for the uploaded media item.
mimeType	string	optional	The MIME type of the media file.
description	string	optional	A description for the uploaded media item.

GET

googlephotos_batch_create_media_items

Batch create Google Photos media items from URLs or base64 payloads.

/mediaItems

4 parameters

Param	Type	Required	Description
urls	array	optional	A list of URLs of media files to upload (maximum 50).
mediaFiles	array	optional	A list of media file inputs to upload (maximum 50).
albumId	string	optional	The ID of the album to add the media items to.
albumPosition	object	optional	The position type within the album.

POST

googlephotos_batch_add_media_items

Add existing Google Photos media items to an album.

/albums/{albumId}

2 parameters

Param	Type	Required	Description
albumId	string	required	The ID of the album to add the media items to.
mediaItemIds	array	required	The list of media item IDs to add to the album (1-50).

PATCH

googlephotos_update_media_item

Update a Google Photos media item description.

/mediaItems/{mediaItemId}

2 parameters

Param	Type	Required	Description
mediaItemId	string	required	The ID of the media item to update.
description	string	required	The new description for the media item (maximum 1000 characters).

POST

googlephotos_create_picker_session

Create a Google Photos Picker session for selecting items from the user's library.

/sessions

1 parameter

Param	Type	Required	Description
maxItemCount	integer	optional	The maximum number of media items the user can pick.

POST

googlephotos_get_picker_session

Get the current state of a Google Photos Picker session.

/sessions/{sessionId}

1 parameter

Param	Type	Required	Description
sessionId	string	required	The ID of the picker session.

DELETE

googlephotos_delete_picker_session

Delete a Google Photos Picker session.

/sessions/{sessionId}

1 parameter

Param	Type	Required	Description
sessionId	string	required	The ID of the picker session to delete.

GET

googlephotos_list_picked_media_items

List media items selected from the user's Google Photos library in a picker session.

/mediaItems

3 parameters

Param	Type	Required	Description
sessionId	string	required	The ID of the picker session.
pageSize	integer	optional	The maximum number of picked media items to return per page.
pageToken	string	optional	A page token to retrieve the next page of picked media items.