Use gog for Google Photos operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema photos --json
gog --readonly --account user@example.com photos --help
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
albums |
List or create app-created albums |
download |
Download an app-created media item |
get |
Get an app-created media item |
list |
List app-created media items |
picker |
Access user-selected media with the Photos Picker API |
search |
Search app-created media items |
upload |
Upload photos or videos, optionally into an app-created album |
Run gog photos <command> --help for flags and gog schema photos <command> --json
for the machine-readable contract. Do not guess command syntax.