Updates für die Google Fotos APIs

Veröffentlicht im September 2024.

Auf dieser Seite finden Sie Details zu den Änderungen an den Google Fotos 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 zu den angekündigten Änderungen finden Sie in diesem Blogpost.

Library API: Auswirkungen auf gängige Anwendungsfälle

In den folgenden Abschnitten wird beschrieben, wie sich die bevorstehenden Änderungen auf gängige Anwendungsfälle auswirken.

Medienelemente hochladen und Alben erstellen

Was ändert sich? Keine Änderung. Sie können weiterhin Medienelemente hochladen und Alben mit dem Umfang photoslibrary.appendonly erstellen.

Mögliche Maßnahmen:

Wenn Ihre App Medienelemente hochlädt oder Alben erstellt, müssen Sie den Umfang photoslibrary.appendonly und nicht photoslibrary verwenden. Der Bereich photoslibrary wird entfernt.

Medienelemente 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.

Mögliche Maßnahmen:

• Wenn Nutzer in Ihrer App Fotos oder Alben aus ihrer gesamten Fotogalerie auswählen sollen, verwenden Sie die neue Google Fotos-Auswahl API. So können Nutzer auf sichere und nutzerfreundliche Weise Zugriff auf bestimmte Inhalte gewähren.
• Wenn Ihre App auf den Zugriff auf die gesamte Bibliothek des Nutzers angewiesen ist, müssen Sie Ihre App möglicherweise noch einmal überarbeiten oder alternative Ansätze in Betracht ziehen.

Freigabe und geteilte Alben

Änderungen:Für geteilte Alben und die zugehörigen API-Funktionen (teilen, Teilen aufheben, abrufen, beitreten, verlassen und auflisten) wird nach dem 31. März 2025 die Antwort 403 PERMISSION_DENIED zurückgegeben.

Mögliche Maßnahmen:

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

Von Apps erstellte Alben verwalten: Ergänzungen und Albuminhalte

Änderungen:Die photoslibrary.edit.appcreateddata wird aus Gründen der konzeptionellen Einheitlichkeit den folgenden drei Methoden hinzugefügt:

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

Mögliche Maßnahmen:

• Wenn Ihre App diese Methoden bereits verwendet, sollten Sie den Umfang photoslibrary.edit.appcreateddata verwenden, um den Autorisierungsprozess zu vereinfachen.

Library API: Betroffene Bereiche und Methoden

Im Rahmen unserer Änderungen an den Google Fotos APIs haben wir die folgenden Aktualisierungen vorgenommen.

Wie auf der aktualisierten Seite zur Autorisierung zu sehen, werden die folgenden Bereiche 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 für Alben und Medienelemente verwendet werden, die von Ihrer App erstellt wurden.	albums.create mediaItems.batchCreate	Verbleibende Bereiche: photoslibrary.appendonly Scopes entfernt: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Verbleibende Bereiche: photoslibrary.readonly.appcreateddata Scopes entfernt: 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
Diese Methoden werden mit photoslibrary.edit.appcreateddata gekennzeichnet. Diese Methoden können jetzt nur noch für Alben und Medienelemente verwendet werden, die von Ihrer App erstellt wurden.	albums.addEnrichment albums.batchAddMediaItems	Verbleibende Bereiche: photoslibrary.appendonly photoslibrary.edit.appcreateddata Scopes entfernt: photoslibrary
	albums.batchRemoveMediaItems	Verbleibende Bereiche: photoslibrary.edit.appcreateddata Scopes entfernt: photoslibrary
Diese Methoden bleiben unverändert.	albums.patch mediaItems.patch	Verbleibende Bereiche: photoslibrary.edit.appcreateddata Scopes entfernt: Keine

Aktualisierungen der Photos API-Richtlinie

Die aktuelle Richtlinie zur Fairen Nutzung wird nach dem 31. März 2025 durch die neue Photos API User Data and Developer Policy ersetzt. Die neue Richtlinie ist jetzt als Vorabversion verfügbar.

Aktualisierungen der Photos API-Dokumentation

Wir haben die Fotos API-Dokumentation erheblich überarbeitet, um anstehende Updates widerzuspiegeln und die Entwicklung zu unterstützen:

• Website mit einheitlichen Google Fotos APIs:Wir haben alle Google Fotos API-Ressourcen an einem Ort (diese Website) zusammengeführt, um Entwicklern die Arbeit zu erleichtern. Hier finden Sie:
  • Zentralisierte Ressourcen:Kombinierte Anleitungen zur Einrichtung und allgemeine Nutzungsrichtlinien sowie kombinierte Support- und Richtlinieninformationen sowohl für die Picker API als auch für die Library API.
  • API-Websites:Einzelne Websites mit detaillierten Anleitungen, Referenzdokumenten und Codebeispielen für die Picker API und die Library API
• Aktualisierte Library API-Inhalte:Die Dokumentation zur Library API wurde überarbeitet, um die Funktionen der Library API nach der Einstellungsphase widerzuspiegeln.
• Alte Dokumentation erhalten:Die ursprüngliche Dokumentation zur Library API ist für Entwickler verfügbar, die vorhandene Integrationen migrieren müssen. Wenn Sie ein neues Projekt starten, verwenden Sie die aktualisierte Dokumentation. Wenn Sie ein vorhandenes Projekt aktualisieren, lesen Sie bei Bedarf sowohl die alte als auch die aktualisierte Dokumentation.

Häufig gestellte Fragen

Was ändert sich bei den Google Fotos APIs?

Wir führen die neue Google Photos Picker API für die sichere Fotoauswahl ein und aktualisieren die vorhandene Library API, um den Schwerpunkt auf die Verwaltung von Fotos und Videos zu legen, die mit Ihrer App erstellt wurden.

Wann treten diese Änderungen in Kraft?

Sie treten am 31. März 2025 in Kraft. Wir empfehlen allen Nutzern bestehender Integrationen, die die Library API für die Fotoauswahl verwenden, so bald wie möglich zur Picker API zu migrieren.

Welche Auswirkungen hat die Umstellung auf die Library API?

Die Bereiche photoslibrary.readonly, photoslibrary.sharing und photoslibrary werden entfernt. API-Aufrufe, die nur auf diese Bereiche beschränkt sind, geben nach dem 31. März 2025 den Statuscode 403 PERMISSION_DENIED zurück. Einige andere Aufrufe sind nur noch für Fotos und Videos verfügbar, die mit Ihrer App erstellt wurden.

Eine vollständige Übersicht über die Änderungen finden Sie in der Tabelle auf dieser Seite.

Was muss 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, die folgenden Schritte auszuführen:

• Für die Bildauswahl: Migrieren Sie zur Google Photos Picker API.
• Andere Funktionen: Lesen Sie die aktualisierte Library API-Dokumentation, um die Änderungen zu verstehen und Funktionen in Ihrer App zu identifizieren, die möglicherweise nicht mehr verfügbar sind. 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-Auswahl-API?

Die Picker API ist eine neue, sichere Möglichkeit für Entwickler, Nutzern zu ermöglichen, Fotos und Videos aus ihrer Google Fotos-Mediathek auszuwählen und nahtlos an Ihre App zurückzusenden.

Wo erhalte ich weitere Informationen zu diesen Änderungen?

Auf dieser Seite finden Sie einen Überblick und eine Zusammenfassung aller Änderungen.

Der Rest der Dokumentation auf unserer Website wurde entsprechend aktualisiert.

In diesem Blogpost werden die Änderungen angekündigt.

Was ist, wenn ich weitere Fragen habe oder Hilfe bei der Migration meiner Anwendung benötige?

Wenn Sie Fragen zur Entwicklerdokumentation haben, besuchen Sie unsere Supportseite. Dort finden Sie weitere Informationen dazu, wie Sie Hilfe erhalten.