Photos Library

Photos Library has 6 operations in gum's generated catalog. Start with search when you know the task, use describe to inspect request fields and scopes, then dispatch through the command that matches the operation risk class.

Count	Value
Family	Search and media
Operations	6
Risk classes	5 read, 1 write
Auth strategies	6 byo_oauth

Start here

bash

gum search "photos library"
gum describe photoslibrary.albums.get
gum read photoslibrary.albums.get --args '{"albumId":"<albumId>"}' --output json

For write-class operations, gum requires the write command and an explicit write gate:

bash

gum describe photoslibrary.albums.create
gum write photoslibrary.albums.create --allow-write --args '{"fields":"id"}'

Operations

Operation	Risk	Auth	Summary
`photoslibrary.albums.create`	`write`	`byo_oauth`	Create a new album (args.body.album.title).
`photoslibrary.albums.get`	`read`	`byo_oauth`	Fetch an album by id.
`photoslibrary.albums.list`	`read`	`byo_oauth`	List the albums in the user's Photos library (pageSize, pageToken).
`photoslibrary.mediaItems.get`	`read`	`byo_oauth`	Fetch a single media item by id.
`photoslibrary.mediaItems.list`	`read`	`byo_oauth`	List the media items in the user's Photos library (pageSize, pageToken).
`photoslibrary.mediaItems.search`	`read`	`byo_oauth`	Search media items by album, date, or content category (args.body: albumId or filters).

Use API workflows for search, describe, invoke, and error handling.
Use Auth guides for service-specific Google setup.
Use Command index for CLI flags and generated help.

Photos Library

Start here

Operations

Next