Erste Schritte mit der Library API

Mit der Library API können Sie in der Google Fotos-Galerie Ihrer Nutzer mit Fotos, Videos und Alben interagieren. Dabei steht Ihnen ein wichtiger Punkt im Vordergrund: Sie können nur auf Inhalte zugreifen und diese verwalten, die von Ihrer Anwendung erstellt wurden.

Vorbereitung

• Sehen Sie sich die Übersicht an: Vergleichen Sie die Picker API und die Library API, um sicherzugehen, dass die Library API für Ihren Anwendungsfall geeignet ist.
• App konfigurieren: Aktivieren Sie die API und richten Sie die Authentifizierung ein. Eine detaillierte Anleitung finden Sie unter App konfigurieren.

Wichtige Anwendungsfälle der Library API

Die Library API eignet sich ideal für Szenarien, in denen Ihre App Folgendes tun muss:

• Medien hochladen und speichern: Sie können Fotos und Videos, die von Ihrer App generiert wurden, sicher in die Google Fotos-Galerien Ihrer Nutzer importieren.
• Inhalte organisieren: Sie können Alben erstellen und verwalten, um Nutzern bei der Organisation ihrer app-bezogenen Medien zu helfen.
• Fotos und Alben optimieren:Füge Medienelementen und Alben durch Anreicherungen wie Titel, Beschreibungen oder Standortinformationen Kontext hinzu.
• Auf von der App erstellte Daten zugreifen:Fotos, Videos und Alben, die von Ihrer App erstellt wurden, abrufen und damit interagieren.

Typischer Workflow für die Library API

Die Library API bietet verschiedene Funktionen. Ein gängiger Workflow kann die folgenden Schritte umfassen:

1. Medien hochladen: Über den Endpunkt für Uploads können Sie Foto- oder Video-Bytes sicher in Google Fotos hochladen. In diesem Schritt wird eine uploadToken generiert.

2. Medienelemente erstellen: Verwende die mediaItems.batchCreate-Methode und gib uploadToken an, um Medienelemente in der Mediathek des Nutzers zu erstellen.

3. Alben erstellen (optional): Mit der albums.create-Methode lassen sich Alben in der Mediathek des Nutzers erstellen, um die Medienelemente zu organisieren.

4. Alben verwalten

   • Mit albums.batchAddMediaItems kannst du von deiner App erstellte Medieninhalte zu Alben hinzufügen.
   • Mit albums.batchRemoveMediaItems können Sie Medienelemente aus Alben entfernen.
   • Mit albums.addEnrichment können Sie Alben zusätzliche Informationen wie Titel oder Orte hinzufügen.
   • Mit albums.get kannst du Informationen zu bestimmten Alben abrufen.
   • Listen Sie die von Ihrer App erstellten Alben mithilfe von albums.list auf.

5. Auf von Apps erstellte Medien zugreifen:

   • Mit mediaItems.get oder mediaItems.batchGet können Sie Details zu bestimmten Medienelementen abrufen.
   • Mit mediaItems.search können Sie nach Medienelementen suchen, die von Ihrer App erstellt wurden.
   • Mit mediaItems.search und der Album-ID können Sie Medienelemente in einem bestimmten von der App erstellten Album auflisten.

Nächste Schritte

• Referenzdokumente lesen: In der detaillierten Referenzdokumentation zur Library API finden Sie Informationen zu allen verfügbaren Methoden und Parametern.
• Beispiele ausprobieren: In unserem Beispiel sehen Sie die Library API in Aktion und können sich Anregungen für Ihre Integration holen.