技能介绍

要解决什么问题

在自动化脚本或 Agent 里操作 Google Photos 时，OAuth 凭据、相册与媒体 API、以及「从用户库里选人」的 Picker 流程往往要分开对接。本技能把能力收敛到 OOMOL 已连接的 Google Photos 账号，通过 oo CLI 调用 googlephotos 连接器；凭据在服务端注入，你不需要在本地保存或拼装原始 token。

技能如何工作

技能暴露 18 个 action，覆盖读库、写库与 Picker 三类场景：

相册与媒体：create_album、list_albums、batch_add_media_items、upload_media、search_media_items 等，用于创建相册、批量拉取/创建媒体、上传与更新描述。
Picker 会话：create_picker_session、list_picked_media_items、get_picked_media_item_download 等，让用户从既有 Google 相册库中选图，而不是只靠本应用创建的 Library API 条目。
契约优先：执行前用 oo connector schema 查看权威入参/出参；用 --data 传入与 schema 一致的 JSON。响应形如 { "data": ..., "meta": { "executionId": "..." } }。

默认假设用户已安装 oo CLI、已登录 OOMOL 且已连接 Google Photos；不要主动跑 oo auth login 或打开连接页，仅在命令因鉴权/连接失败时再走一次性设置（安装 CLI、登录、OAuth2 连接相册、余额不足时充值）。

适用边界与注意点

只读（get / list / search）可直接执行；创建、更新、上传会改变相册状态，执行前应与用户确认 payload 与效果。
删除类操作具有破坏性，需明确目标并取得确认（技能正文对 delete/remove 类强调这一点）。
list_media_items / search_media_items 针对本应用通过 Library API 创建的媒体；若要从用户完整库中选资源，应走 Picker 相关 action，而不是误用 list 当作「全库浏览」。
大文件下载可走 connector 的 file transit（如 get_media_item_download、get_picked_media_item_download），需区分应用创建项与 Picker 临时可信 URL 两种路径。

截图预览

使用场景

Agent 需为用户新建相册并将一批 URL 或 base64 媒体写入 Google Photos 时，按 schema 调用 `create_album` 与 `batch_create_media_items`。
用户要从自己完整 Google 相册库中选图参与后续流程时，创建 Picker 会话，用 `list_picked_media_items` 取选中项并经 file transit 下载。
脚本要核对本应用此前通过 Library API 创建的媒体时，用 `list_media_items` 或 `search_media_items` 拉取并按 ID 批量 `batch_get_media_items`。
在与用户确认相册标题、封面或媒体描述无误后，执行 `update_album` 或为条目 `update_media_item` 更新元数据。