Google Photos 自動化（Rube MCP 経由）
Rube MCP（Composio）を使用して、Google Photos での写真アップロード、アルバム管理、メディア検索、一括整理を自動化します。
ツールキットドキュメント: composio.dev/toolkits/googlephotos
前提条件
- Rube MCP が接続されていること（
RUBE_SEARCH_TOOLSが利用可能であること） RUBE_MANAGE_CONNECTIONSを使用してgooglephotosツールキットとのアクティブな接続が確立されていること- 常に最初に
RUBE_SEARCH_TOOLSを呼び出し、最新のツールスキーマを取得すること
セットアップ
Rube MCP を入手する: クライアント設定に https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要で、エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認し、Rube MCP が利用可能であることを確認します。RUBE_MANAGE_CONNECTIONSを呼び出し、ツールキットにgooglephotosを指定します。- 接続状態が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します。
- ワークフローを実行する前に、接続状態が ACTIVE であることを確認します。
コアワークフロー
1. アルバム一覧の取得
GOOGLEPHOTOS_LIST_ALBUMS を使用して、ユーザーの「アルバム」タブに表示されているすべてのアルバムを取得します。
ツール: GOOGLEPHOTOS_LIST_ALBUMS
パラメーター:
- pageSize: 1ページあたりのアルバム数
- pageToken: ページネーショントークン
- excludeNonAppCreatedData: このアプリで作成されたアルバムのみを表示するかどうか
2. 新しいアルバムの作成
GOOGLEPHOTOS_CREATE_ALBUM を使用して、Google Photos に新しいアルバムを作成します。
ツール: GOOGLEPHOTOS_CREATE_ALBUM
パラメーター:
- title (必須): アルバムのタイトル
3. メディアのアップロード
GOOGLEPHOTOS_UPLOAD_MEDIA を使用して、画像または動画ファイルを Google Photos にアップロードします。
ツール: GOOGLEPHOTOS_UPLOAD_MEDIA
パラメーター:
- file_to_upload: アップロードするローカルファイルのパス
- url: アップロードするファイルのURL（file_to_upload の代替）
- file_name: アップロードされるファイルの名前
- description: メディアアイテムの説明/キャプション
4. 一括アップロードとメディアアイテムの作成
GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS を使用して、複数のファイルをアップロードし、一度にメディアアイテムを作成します。
ツール: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
パラメーター:
- files: アップロードするローカルファイルのパス
- urls: アップロードするファイルのURL
- media_files: ファイルとURLの混合入力
- albumId: アイテムを追加するアルバム
- albumPosition: アルバム内での位置
5. メディアアイテムの検索
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS を使用して、フィルターを適用しながらユーザーの写真ライブラリを検索します。
ツール: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
パラメーター:
- albumId: アルバムで絞り込む
- filters: 検索フィルター（日付範囲、コンテンツカテゴリ、メディアタイプ）
- orderBy: 並び順
- pageSize: 1ページあたりの結果数
- pageToken: ページネーショントークン
6. アルバムへのアイテム追加
GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS を使用して、既存のメディアアイテムをアルバムに追加します。
ツール: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
パラメーター:
- albumId (必須): 対象のアルバムID
- mediaItemIds (必須): 追加するメディアアイテムIDの配列
一般的なパターン
- アルバム作成後にアップロード:
GOOGLEPHOTOS_CREATE_ALBUMでアルバムを作成し、続けてGOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSにアルバムIDを指定して、写真をアップロードして整理します。 - 一覧取得後に整理:
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMSまたはGOOGLEPHOTOS_LIST_MEDIA_ITEMSでメディアアイテムIDを取得し、GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMSでアルバムに追加します。 - アルバムメタデータの更新:
GOOGLEPHOTOS_UPDATE_ALBUMを使用して、アルバムのタイトルやカバー写真を変更します。 - アルバム詳細の取得:
GOOGLEPHOTOS_GET_ALBUMにアルバムIDを指定して、完全なアルバム情報を取得します。 - エンリッチメントの追加:
GOOGLEPHOTOS_ADD_ENRICHMENTを使用して、テキストオーバーレイ、位置情報、マップエンリッチメントをアルバム位置に追加します。 - URLからのアップロード:
GOOGLEPHOTOS_UPLOAD_MEDIAのurlパラメーター、またはGOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSのurlsパラメーターを使用して、画像をWeb URLから直接アップロードします。
既知の落とし穴
GOOGLEPHOTOS_LIST_MEDIA_ITEMSは 非推奨 です。メディアの一覧表示やフィルタリングにはGOOGLEPHOTOS_SEARCH_MEDIA_ITEMSを使用してください。GOOGLEPHOTOS_UPLOAD_MEDIAは画像で 200MB、動画はそれ以上のサイズ制限があります。これらを超えると失敗します。- アルバムIDは
GOOGLEPHOTOS_LIST_ALBUMSまたはGOOGLEPHOTOS_CREATE_ALBUMの応答から取得する必要があります。これらは不透明な文字列です。 GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMSは、アプリによって作成された アルバムまたはユーザーが所有するアルバムにのみアイテムを追加できます。GOOGLEPHOTOS_SEARCH_MEDIA_ITEMSのfiltersパラメーターは、特定の Google Photos API フィルター構造を使用します。日付範囲やコンテンツカテゴリの形式についてはスキーマを参照してください。- API 経由で作成されたメディアアイテムは、処理遅延のため Google Photos の Web UI にすぐに表示されない場合があります。
クイックリファレンス
| アクション | ツール | 主要パラメーター |
|---|---|---|
| アルバム一覧 | GOOGLEPHOTOS_LIST_ALBUMS | pageSize, pageToken |
| アルバム作成 | GOOGLEPHOTOS_CREATE_ALBUM | title |
| アルバム取得 | GOOGLEPHOTOS_GET_ALBUM | albumId |
| アルバム更新 | GOOGLEPHOTOS_UPDATE_ALBUM | albumId, title, coverPhotoMediaItemId |
| メディアアップロード | GOOGLEPHOTOS_UPLOAD_MEDIA | file_to_upload または url, description |
| 一括アップロード | GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS | files または urls, albumId |
| メディア検索 | GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS | albumId, filters, pageSize |
| メディア一覧 | GOOGLEPHOTOS_LIST_MEDIA_ITEMS | pageSize, pageToken |
| アルバムにアイテム追加 | GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS | albumId, mediaItemIds |
| エンリッチメント追加 | GOOGLEPHOTOS_ADD_ENRICHMENT | albumId, newEnrichmentItem, albumPosition |
Powered by Composio