# Google Photos

Google Photos is a cloud-based photo storage and organization service offering automatic backups, AI-assisted search, and shared albums for personal and collaborative media management

- **Category:** images & design
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 14
- **Triggers:** 0
- **Slug:** `GOOGLEPHOTOS`
- **Version:** 20260429_00

## Tools

### Add Enrichment

**Slug:** `GOOGLEPHOTOS_ADD_ENRICHMENT`

Adds an enrichment at a specified position in a defined album.

### Batch Add Media Items

**Slug:** `GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS`

Adds one or more media items to an album in Google Photos.

### Batch Create Media Items

**Slug:** `GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS`

Batch upload and create media items in Google Photos. Supports three input methods: 1. 'urls': Simple list of public URLs (file names extracted automatically) 2. 'media_files': List of objects with url/file, file_name, and description 3. 'files': List of FileUploadable objects for pre-uploaded files Media items can optionally be added to an album at a specific position. Maximum 50 items per request.

### Batch Get Media Items

**Slug:** `GOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMS`

Returns the list of media items for the specified media item identifiers.

### Create Album

**Slug:** `GOOGLEPHOTOS_CREATE_ALBUM`

Creates a new album in Google Photos.

### Get Album

**Slug:** `GOOGLEPHOTOS_GET_ALBUM`

Returns the album based on the specified albumId.

### Download Photos Media Item

**Slug:** `GOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOAD`

Downloads a media item from Google Photos and returns it as a file.

### List Albums

**Slug:** `GOOGLEPHOTOS_LIST_ALBUMS`

Lists all albums shown to a user in the Albums tab of Google Photos.

### List Media Items (App-Created Only)

**Slug:** `GOOGLEPHOTOS_LIST_MEDIA_ITEMS`

Lists media items created by this application from Google Photos. DEPRECATION NOTICE: As of March 31, 2025, the Google Photos Library API ONLY returns media items that were uploaded/created by your application. This action CANNOT access the user's full photo library. Use cases this action SUPPORTS: - Listing photos/videos your app previously uploaded to the user's library - Managing app-created content in Google Photos Use cases this action DOES NOT SUPPORT: - Accessing photos taken by the user's camera - Viewing photos from other apps or web uploads - Listing the user's entire photo library For accessing a user's full library, use the Google Photos Picker API instead: https://developers.google.com/photos/picker

### List Shared Albums (Deprecated)

**Slug:** `GOOGLEPHOTOS_LIST_SHARED_ALBUMS`

[DEPRECATED - sunset March 31, 2025] Lists all shared albums available in the Sharing tab of the user's Google Photos app. Use when you need to retrieve shared albums that are visible to the user in their Sharing tab.

### Search Media Items

**Slug:** `GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS`

Searches for media items in a user's Google Photos library.

### Update Album

**Slug:** `GOOGLEPHOTOS_UPDATE_ALBUM`

Updates an album's title or cover photo in Google Photos.

### Update Media Item

**Slug:** `GOOGLEPHOTOS_UPDATE_MEDIA_ITEM`

Updates a media item's description in Google Photos.

### Upload Media

**Slug:** `GOOGLEPHOTOS_UPLOAD_MEDIA`

Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB).
