Google Photos
Google Photos stores a Google account's photos and videos.
Authentication
- OAuth 2.0
Actions
Generic API request. Call any Google Photos Library API or Picker API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the host choice, path, query, headers and body are yours to fill.
- Add album enrichmentInsert a text caption, a location pin or a journey map between the photos of an app-created album, the way Google Photos shows trip stories.
- Add media items to albumAdd existing app-created media items to an app-created album, appended at the end in the order given.
- Create albumCreate an empty album in the connected account's Google Photos library, owned by this OAuth client so later calls can add media items and enrichments to it.
- Create media itemsTurn upload tokens from googlephotos:uploadmedia into photos and videos in the connected account's library, optionally filing them straight into an app-created album.
- Create picker sessionStart a Google Photos Picker session — the only way to reach photos and videos the person already has, since the Library API sees only app-created items.
- Delete picker sessionDestructiveDelete a Picker session once its items have been read, so the pick no longer grants access to those items.
- Download media bytesDownload the bytes of a photo or video from its Google Photos baseUrl — a picked item's body.mediaItems[].mediaFile.baseUrl from googlephotos:listpickedmediaitems, or an app-created item's body.baseUrl from googlephotos:getmediaitem.
- Get albumRead one app-created album by id — its title, item count, cover photo and Google Photos link.
- Get media itemRead one app-created photo or video by id, including a fresh body.baseUrl — base URLs expire after about 60 minutes, so fetch the item again right before downloading its bytes rather than reusing a stored URL.
- Get picker sessionCheck whether the person has finished picking in a Picker session.
- List albumsList the albums this OAuth client created in the connected account — since March 2025 the Library API no longer returns albums the person made themselves or that other apps made; to reach those, have the person pick items through the Picker actions instead.
- List media itemsList the photos and videos this OAuth client uploaded to the connected account, newest first.
- List picked media itemsRead the photos and videos the person picked in a Picker session, each with a body.mediaItems[].mediaFile.baseUrl for downloading its bytes.
- Remove media items from albumDestructiveTake app-created media items out of an app-created album.
- Search media itemsFind app-created photos and videos either inside one album or by filters — never both: setting Album together with any filter is rejected by Google.
- Update albumDestructiveRename an app-created album or change its cover photo.
- Update media itemDestructiveChange the description shown in an app-created photo's or video's info panel in Google Photos.
- Upload media bytesUpload a photo or video file's raw bytes to Google Photos and get back an upload token — step one of adding media.
Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.