Mit der Picker API können Nutzer auf sichere Weise Fotos und Videos aus ihrer Google Fotos-Galerie auswählen und mit Ihrer Anwendung teilen.
Vorbereitung
- Übersicht:Vergleichen Sie die Picker API und die Library API, um festzustellen, ob die Picker 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.
Ablauf der Picker API
Hier ist eine Übersicht über die Funktionsweise der Picker API:
OAuth-Token prüfen:Bevor du den Ablauf der Picker API startest, solltest du prüfen, ob ein gültiges OAuth 2.0-Zugriffstoken für den Nutzer vorhanden ist. Wenn kein Token vorhanden ist, initiiere den OAuth 2.0-Autorisierungsvorgang, um eins zu erhalten.
Sitzung erstellen:Rufe die Picker API auf, um eine neue Sitzung zu erstellen. Dieser Aufruf gibt eine eindeutige
pickerUri
zurück.Nutzer zur Google Fotos App weiterleiten:Geben Sie den
pickerUri
an Ihre Nutzer weiter (entweder als anklickbarer Link oder als QR-Code). Über diese URL wird die Google Fotos App sicher geöffnet.Der Nutzer wählt Medienelemente aus:In der Google Fotos App können Nutzer in ihrer Fotogalerie Fotos und Videos auswählen, die sie mit der App teilen möchten. Hier finden Sie eine Übersicht über die Auswahlmöglichkeiten durch den Nutzer.
Sitzung abfragen:Ihre App sollte die Sitzung regelmäßig abfragen, um den Status zu prüfen. Sie möchten, dass die Property
mediaItemsSet
den Wert „wahr“ zurückgibt, um anzuzeigen, dass der Nutzer seine Auswahl abgeschlossen hat.Ausgewählte Medienelemente auflisten:Wenn
mediaItemsSet
„wahr“ zurückgibt, kannst du mit der Listemethode Details zu den ausgewählten Medienelementen abrufen.Medienelemente abrufen und verwenden:Sie haben jetzt Zugriff auf die ausgewählten Medienelemente. Du kannst den Inhalt der Schaltflächen mithilfe von
baseUrl
abrufen und in deiner Anwendung verwenden.
Nächste Schritte
- Referenzdokumentation: In der detaillierten Referenzdokumentation zur Picker API finden Sie Informationen zu allen verfügbaren Methoden und Parametern.
- Beispiele ausprobieren: In unserem Beispiel sehen Sie die Picker API in Aktion und können sich Anregungen für Ihre Integration holen.