update_media_item
Update Media Item
Update the description of a media item created by your app.
update_media_item
Update the description of a media item created by your app.
upload_media
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_album
Update the title or cover photo of an album created by your app. Provide the album ID and the fields you want to change.
create_album
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.
list_albums
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.
search_media_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.
delete_picker_session
Delete a Google Photos Picker session. This revokes access to the session and any media items selected during the session.
get_media_item
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.
manage_album_media
Add or remove media items from an album. Use this to organize media items into albums created by your app.
create_picker_session
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.
get_album
Retrieve detailed information about a specific album by its ID, including title, media item count, cover photo, and writeability status.
get_picker_session
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.
add_album_enrichment
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.
list_picked_media
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.
Upload, manage, and organize photos and videos in users' Google Photos libraries. Create and manage albums, add enrichments (text, location, map markers), and change album titles and cover photos. Upload media items, edit descriptions, and search app-created content with filters including date ranges, content categories, and favorites. Create picker sessions that let users securely select photos and videos from their library to share with your application. Access media metadata including camera information, creation time, dimensions, and exposure details.
Common questions about connecting Google Photos to AI agents with Metorial.