ComposioHQ/googlephotos-automation

Google Photos Automatisierung über Rube MCP

Laden Sie Fotos hoch, verwalten Sie Alben, durchsuchen Sie Medieninhalte und organisieren Sie Inhalte in Google Photos mithilfe von Rube MCP (Composio) stapelweise.

Toolkit-Dokumentation: composio.dev/toolkits/googlephotos

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit dem Toolkit googlephotos
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemata zu erhalten

Einrichtung

Rube MCP beziehen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – fügen Sie einfach den Endpunkt hinzu, und es funktioniert.

1. Stellen Sie sicher, dass Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit dem Toolkit googlephotos auf
3. Falls die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätigen Sie, dass der Verbindungsstatus AKTIV anzeigt, bevor Sie Workflows ausführen

Kern-Workflows

1. Alben auflisten

Verwenden Sie GOOGLEPHOTOS_LIST_ALBUMS, um alle im Tab "Alben" des Benutzers sichtbaren Alben abzurufen.

Tool: GOOGLEPHOTOS_LIST_ALBUMS
Parameter:
  - pageSize: Anzahl der Alben pro Seite
  - pageToken: Paginierungstoken
  - excludeNonAppCreatedData: Nur von dieser App erstellte Alben anzeigen

2. Ein neues Album erstellen

Verwenden Sie GOOGLEPHOTOS_CREATE_ALBUM, um ein neues Album in Google Photos zu erstellen.

Tool: GOOGLEPHOTOS_CREATE_ALBUM
Parameter:
  - title (erforderlich): Albumtitel

3. Medien hochladen

Verwenden Sie GOOGLEPHOTOS_UPLOAD_MEDIA, um eine Bild- oder Videodatei in Google Photos hochzuladen.

Tool: GOOGLEPHOTOS_UPLOAD_MEDIA
Parameter:
  - file_to_upload: Lokaler Dateipfad zum Hochladen
  - url: URL der hochzuladenden Datei (Alternative zu file_to_upload)
  - file_name: Name für die hochgeladene Datei
  - description: Beschreibung/Bildunterschrift für das Medienelement

4. Stapel-Upload und Medieninhalte erstellen

Verwenden Sie GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS, um mehrere Dateien hochzuladen und in einem Vorgang Medieninhalte zu erstellen.

Tool: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
Parameter:
  - files: Lokale Dateipfade zum Hochladen
  - urls: URLs der hochzuladenden Dateien
  - media_files: Gemischte Eingabe (Dateien und URLs)
  - albumId: Album, dem Elemente hinzugefügt werden sollen
  - albumPosition: Position innerhalb des Albums

5. Medieninhalte durchsuchen

Verwenden Sie GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS, um die Fotobibliothek des Benutzers mit Filtern zu durchsuchen.

Tool: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
Parameter:
  - albumId: Nach Album filtern
  - filters: Suchfilter (Datumsbereiche, Inhaltskategorien, Medientypen)
  - orderBy: Sortierreihenfolge
  - pageSize: Ergebnisse pro Seite
  - pageToken: Paginierungstoken

6. Elemente zu einem Album hinzufügen

Verwenden Sie GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS, um vorhandene Medieninhalte zu einem Album hinzuzufügen.

Tool: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
Parameter:
  - albumId (erforderlich): Ziel-Album-ID
  - mediaItemIds (erforderlich): Array der hinzuzufügenden Medieninhalts-IDs

Häufige Muster

• Album erstellen, dann hochladen: Verwenden Sie GOOGLEPHOTOS_CREATE_ALBUM, um ein Album zu erstellen, dann GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS mit der Album-ID, um Fotos in einem Schritt hochzuladen und zu organisieren.
• Auflisten, dann organisieren: Verwenden Sie GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS oder GOOGLEPHOTOS_LIST_MEDIA_ITEMS, um Medieninhalts-IDs zu finden, dann GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS, um sie zu Alben hinzuzufügen.
• Album-Metadaten aktualisieren: Verwenden Sie GOOGLEPHOTOS_UPDATE_ALBUM, um den Titel oder das Titelbild eines Albums zu ändern.
• Albumdetails abrufen: Verwenden Sie GOOGLEPHOTOS_GET_ALBUM mit einer Album-ID, um vollständige Album-Informationen abzurufen.
• Anreicherungen hinzufügen: Verwenden Sie GOOGLEPHOTOS_ADD_ENRICHMENT, um Textüberlagerungen, Standorte oder Kartenanreicherungen zu Albumpositionen hinzuzufügen.
• Von URLs hochladen: Verwenden Sie den Parameter url in GOOGLEPHOTOS_UPLOAD_MEDIA oder urls in GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS, um Bilder direkt von Web-URLs hochzuladen.

Bekannte Fallstricke

• GOOGLEPHOTOS_LIST_MEDIA_ITEMS ist veraltet – bevorzugen Sie GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS zum Auflisten und Filtern von Medien.
• GOOGLEPHOTOS_UPLOAD_MEDIA unterstützt Bilder bis zu 200 MB und Videos bis zu einer größeren Grenze. Überschreitungen führen zu Fehlern.
• Album-IDs müssen aus den Antworten von GOOGLEPHOTOS_LIST_ALBUMS oder GOOGLEPHOTOS_CREATE_ALBUM bezogen werden – es sind undurchsichtige Zeichenketten.
• GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS kann nur Elemente zu Alben hinzufügen, die von der App erstellt wurden oder die der Benutzer besitzt.
• Der Parameter filters in GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS verwendet eine spezifische Google Photos API-Filterstruktur – konsultieren Sie das Schema für Datumsbereichs- und Inhaltskategorieformate.
• Über die API erstellte Medieninhalte erscheinen aufgrund von Verarbeitungsverzögerungen möglicherweise nicht sofort in der Google Photos Weboberfläche.

Kurzreferenz

Aktion	Tool	Wichtige Parameter
Alben auflisten	GOOGLEPHOTOS_LIST_ALBUMS	pageSize, pageToken
Album erstellen	GOOGLEPHOTOS_CREATE_ALBUM	title
Album abrufen	GOOGLEPHOTOS_GET_ALBUM	albumId
Album aktualisieren	GOOGLEPHOTOS_UPDATE_ALBUM	albumId, title, coverPhotoMediaItemId
Medien hochladen	GOOGLEPHOTOS_UPLOAD_MEDIA	file_to_upload oder url, description
Stapel-Upload	GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS	files oder urls, albumId
Medien durchsuchen	GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS	albumId, filters, pageSize
Medieninhalte auflisten	GOOGLEPHOTOS_LIST_MEDIA_ITEMS	pageSize, pageToken
Elemente zu Album hinzufügen	GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS	albumId, mediaItemIds
Anreicherung hinzufügen	GOOGLEPHOTOS_ADD_ENRICHMENT	albumId, newEnrichmentItem, albumPosition

---

Powered by Composio