Updates für die Google Fotos APIs

Veröffentlicht im September 2024

Diese Seite enthält Details zu bestimmten Änderungen, die an Google Fotos vorgenommen werden APIs In den Details auf dieser Seite erfahren Sie, wie sich die Änderungen auf die von Ihnen verwendeten Methoden und Bereiche auswirken können. Weitere Informationen zur Bekanntgabe dieser Weitere Informationen zu den Änderungen finden Sie im zugehörigen Blogpost.

Library API: Auswirkungen auf häufige Anwendungsfälle

In den folgenden Abschnitten werden die Auswirkungen der bevorstehenden Änderungen auf gängige Anwendungsfälle beschrieben.

Medien hochladen und Alben erstellen

Was ändert sich? Keine Änderung. Sie können weiterhin Media-Elemente hochladen und Alben mit dem Bereich photoslibrary.appendonly erstellen.

Das können Sie tun:

Wenn Ihre App Mediendateien hochlädt oder Alben erstellt, müssen Sie den Bereich photoslibrary.appendonly und nicht den Bereich photoslibrary. Die photoslibrary Bereich wird entfernt.

Medien und Alben auflisten, suchen und abrufen

Änderungen: Sie können jetzt nur noch Alben und Medienelemente auflisten, suchen und abrufen, die von Ihrer App erstellt wurden.

Das können Sie tun:

• Wenn Nutzer in Ihrer App Fotos oder Alben aus ihrem gesamten Google Fotos-Auswahl verwenden, API hinzu. Dies sorgt für eine sichere und eine nutzerfreundliche Möglichkeit, Zugriff auf bestimmte Inhalte zu gewähren.
• Wenn Ihre App auf die gesamte Bibliothek des Nutzers zugreift, müssen Sie möglicherweise Ihre App neu bewerten oder alternative Ansätze in Betracht ziehen.

Teilen und geteilte Alben

Änderungen: Ab dem 31. März 2025 wird für freigegebene Alben und die zugehörigen API-Funktionen (freigeben, Freigabe aufheben, abrufen, beitreten, verlassen und auflisten) die Antwort 403 PERMISSION_DENIED zurückgegeben.

Das können Sie tun:

Nutzer zur Google Fotos App weiterleiten, damit sie das Teilen selbst verwalten können Sie können in Ihrer App eine klare Anleitung oder Deeplinks zur Verfügung stellen, um Nutzer zu unterstützen.

Von Apps erstellte Alben verwalten: Bereiche und Albuminhalte

Was ändert sich? Der photoslibrary.edit.appcreatedata wird hinzugefügt zu die folgenden drei Methoden für konzeptionelle Konsistenz:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

Mögliche Maßnahmen:

• Wenn Ihre App diese Methoden bereits verwendet, können Sie die photoslibrary.edit.appcreatedata-Bereich, um Ihre Autorisierung zu vereinfachen .

Library API: Betroffene Bereiche und Methoden

Im Rahmen der Änderungen an den Google Fotos APIs haben wir Folgendes vorgenommen: Aktualisierungen.

Wie auf der aktualisierten Autorisierung Seite enthalten, werden folgende Bereiche werden nach dem 31. März 2025 aus der Library API entfernt:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Die folgenden Bereiche bleiben erhalten:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

In dieser Tabelle sind die betroffenen Library API-Methoden und -Bereiche aufgeführt.

Updates	Methoden	Ebenen
Diese Methoden können jetzt nur noch mit Alben und Medien verwendet werden, die von deiner App erstellt wurden. Dazu gehören auch Medienelemente, die mit der Picker API ausgewählt und mit der Library API der Bibliothek des Nutzers hinzugefügt wurden.	albums.create mediaItems.batchCreate	Verbleibende Bereiche: photoslibrary.appendonly Entfernte Bereiche: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Verbleibende Bereiche: photoslibrary.readonly.appcreatedata Entfernte Bereiche: photoslibrary photoslibrary.readonly
Diese Methoden sind dann nicht mehr verfügbar.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Verbleibende Bereiche: Keine Scopes entfernt: photoslibrary.sharing
Diesen Methoden wird photoslibrary.edit.appcreatedata hinzugefügt. Diese Methoden können jetzt nur noch für Alben und Medienelemente verwendet werden, die von Ihrer App erstellt wurden. Dazu gehören auch Medienelemente, die mit der Picker API ausgewählt und der Fotogalerie des Nutzers mit der Library API hinzugefügt wurden.	albums.addEnrichment albums.batchAddMediaItems	Verbleibende Bereiche: photoslibrary.appendonly photoslibrary.edit.appcreatedata Entfernte Bereiche: photoslibrary
	albums.batchRemoveMediaItems	Verbleibende Bereiche: photoslibrary.edit.appcreatedata Entfernte Bereiche: photoslibrary
Diese Methoden bleiben unverändert.	albums.patch mediaItems.patch	Verbleibende Bereiche: photoslibrary.edit.appcreatedata Entfernte Bereiche: Keine

Aktualisierungen der Photos API-Richtlinie

Die aktuellen Richtlinien zur Fairen Nutzung nach dem 31. März 2025 durch die neuen Nutzerdaten und Entwickler für die Photos API ersetzt Richtlinien: Die neue Richtlinie ist jetzt als Vorabversion verfügbar.

Aktualisierungen der Photos API-Dokumentation

Wir haben wesentliche Änderungen an der Photos API-Dokumentation vorgenommen, um bevorstehende Updates und unterstützen Sie bei der Entwicklung:

• Website der Unified Photos API:Alle Photos API-Ressourcen wurden konsolidiert an einem zentralen, praktischen Ort (diese Website) an. So können Sie für Entwickelnde. Hier finden Sie folgende Informationen:
  • Zentralisierte Ressourcen: Kombinierte Einrichtungsanleitung und allgemeine Nutzungsempfehlungen und kombinierte Support- und Richtlinieninformationen für die Picker API und die Library API verwenden.
  • Dedizierte API-Websites:einzelne Websites mit detaillierten Anleitungen, Referenzdokumentation und Codebeispiele für den Picker API und Bibliothek API
• Aktualisierter Inhalt der Library API:Dokumentation zur Library API wurde überarbeitet, um die Funktionen nach dem Einstellungszeitraum widerzuspiegeln. In der aktualisierten Dokumentation finden Sie Labels, geänderte oder entfernte Inhalte mit Links zu den entsprechenden älteren Inhalten zu Referenzzwecken während der Migration.
• Beibehaltene alte Dokumentation:Die ursprüngliche Library API wurde beibehalten. Dokumentation für Entwickler, die vorhandene Integrationen zu migrieren. Wenn Sie ein neues Projekt starten, in der aktualisierten Dokumentation. Wenn Wenn Sie ein vorhandenes Projekt aktualisieren, verweisen Sie sowohl auf das Legacy-Projekt die Dokumentation nach Bedarf.

Häufig gestellte Fragen

Was ändert sich bei den Google Fotos APIs?

Wir führen die neue Google Fotos-Auswahl-API für die sichere Fotoauswahl ein und die vorhandene Library API aktualisieren, um sich auf die Verwaltung von Fotos und Videos zu konzentrieren die von Ihrer App erstellt wurden.

Wann treten diese Änderungen in Kraft?

Sie treten am 31. März 2025 in Kraft. Wir ermutigen alle Menschen mit Vorhandene Integrationen, die die Library API für die Fotoauswahl verwenden, um zu migrieren die Picker API so schnell wie möglich hinzufügen.

Wie wirkt sich dies auf die Library API aus?

Die Bereiche photoslibrary.readonly, photoslibrary.sharing und photoslibrary werden entfernt. Bei API-Aufrufen, die nur auf diesen Bereichen basieren, wird ein 403 PERMISSION_DENIED Mehrere andere Aufrufe sind nur noch mit Fotos und Videos möglich, die mit Ihrer App erstellt wurden.

Die vollständigen Änderungen finden Sie in der Tabelle oben auf dieser Seite.

Was kann ich tun, wenn meine App derzeit die betroffenen Bereiche oder Methoden verwendet?

Wenn Ihre App einen der betroffenen Bereiche oder Methoden verwendet, empfehlen wir Ihnen, führen Sie die folgenden Schritte aus:

• Zur Fotoauswahl: Migrieren Sie zur Google Fotos Picker API.
• Informationen zu anderen Funktionen finden Sie in der aktualisierten Dokumentation zur Library API, die Änderungen verstehen und Funktionen Ihrer App identifizieren, die möglicherweise verfügbar sein. Möglicherweise müssen Sie die Funktionen Ihrer App anpassen oder alternative Lösungen für einige Anwendungsfälle finden.

Was ist die Google Fotos Picker API?

Die Picker API ist eine neue, sichere Möglichkeit für Entwickler, Nutzern die Auswahl von Fotos zu ermöglichen und Alben aus ihrer Google Fotos-Galerie ansehen und sie ganz einfach an Ihre Ihre Anwendung. Die Picker API bietet robuste Funktionen zur Fotoauswahl, darunter das Auswählen einzelner Elemente, das Auswählen aller Elemente in einem Album und in der Google Fotos-Galerie suchen.

Wo finde ich weitere Informationen zu diesen Änderungen?

Diese Seite, die Sie gerade ansehen, bietet eine Übersicht und eine Zusammenfassung aller Änderungen.

Die restliche Dokumentation auf unserer Website wurde aktualisiert, die aktualisierten APIs.

Dieser Blogpost und kündigt die Änderungen an.

Ich habe weitere Fragen oder benötige Hilfe bei der Migration meiner Anwendung. Was kann ich tun?

Wenn Sie Fragen zur Entwicklerdokumentation haben, wenden Sie sich an unseren Support .