Built by Metorial, the integration platform for agentic AI.
List albums created by your app in the user's Google Photos library. Returns album details including title, item count, and cover photo URL. Supports pagination for large collections.
Create media items in the user's Google Photos library from previously obtained upload tokens. Each item requires an upload token (from the bytes upload step), a filename, and optionally a description. Items can be added to an album at creation time.
Update the description of a media item created by your app.
Update the title or cover photo of an album created by your app. Provide the album ID and the fields you want to change.
Add or remove media items from an album. Use this to organize media items into albums created by your app.
Retrieve media items that the user selected during a Picker session. Returns access URLs, metadata, and file information for each picked item. The session must have **mediaItemsSet** set to true.
Create a new Google Photos Picker session that generates a URI where the user can select photos and videos from their library. After the user makes selections, use **Get Picker Session** to check the status and **List Picked Media** to retrieve the selected items.
Delete a Google Photos Picker session. This revokes access to the session and any media items selected during the session.
Create a new album in the user's Google Photos library. The album will be owned by your app and can be managed through the API.
Retrieve detailed information about one or more media items by their IDs. Returns metadata including filename, MIME type, dimensions, camera info, and access URLs. Supports batch retrieval of up to 50 items.
Search and list media items created by your app. Filter by album, date range, content category, media type, or favorites. Can also list all app-created media items without filters.
Retrieve the current status of a Google Photos Picker session. Use this to check whether the user has selected media items. When **mediaItemsSet** is true, use **List Picked Media** to get the selected items.
Retrieve detailed information about a specific album by its ID, including title, media item count, cover photo, and writeability status.
Add a text, location, or map enrichment to an album. Enrichments provide context between media items in an album. Specify exactly one enrichment type per call.