Aktualizacje interfejsów API Zdjęć Google

Opublikowano we wrześniu 2024 r.

Ta strona zawiera szczegółowe informacje o zmianach wprowadzonych w interfejsach API Zdjęć Google. Zapoznaj się ze szczegółami na tej stronie, aby dowiedzieć się, jak może to wpłynąć na używane przez Ciebie metody i zakresy. Więcej informacji o tych zmianach znajdziesz w powiązanym poście na blogu.

Interfejs Library API: wpływ na typowe przypadki użycia

W sekcjach poniżej opisujemy, jak nadchodzące zmiany wpłyną na typowe przypadki użycia.

Przesyłanie elementów multimedialnych i tworzenie albumów

Co się zmienia: bez zmian. Nadal możesz przesyłać elementy multimedialne i tworzyć albumy za pomocą zakresu photoslibrary.appendonly.

Co możesz zrobić:

Jeśli Twoja aplikacja przesyła elementy multimedialne lub tworzy albumy, upewnij się, że używasz zakresu photoslibrary.appendonly, a nie photoslibrary. Zakres photoslibrary zostanie usunięty.

wyświetlanie, wyszukiwanie i pobieranie multimediów i albumów;

Co się zmienia: możesz teraz tylko wyświetlać, wyszukiwać i pobierać albumy oraz elementy multimedialne utworzone przez Twoją aplikację.

Co możesz zrobić:

• Jeśli Twoja aplikacja wymaga, aby użytkownicy mogli wybierać zdjęcia lub albumy z całej biblioteki, użyj nowego interfejsu Picker Google Photos API. Jest to bezpieczny i przyjazny dla użytkowników sposób przyznawania dostępu do określonych treści.
• Jeśli Twoja aplikacja wymaga dostępu do całej biblioteki użytkownika, być może trzeba będzie ją ponownie ocenić lub rozważyć alternatywne podejście.

Udostępnianie i albumy udostępnione

Co się zmienia: udostępnione albumy i powiązane z nimi funkcje interfejsu API (udostępnianie, odbieranie uprawnień do udostępniania, pobieranie, dołączanie, opuszczanie i wyświetlanie listy) będą zwracać wartość 403 PERMISSION_DENIED po 31 marca 2025 r.

Co możesz zrobić:

Poinformuj użytkowników, że mogą sami zarządzać udostępnianiem w aplikacji Zdjęcia Google. Możesz udostępnić w aplikacji przejrzyste instrukcje lub precyzyjne linki.

Zarządzanie albumami utworzonymi przez aplikację: wzbogacanie i zawartość albumu

Co się zmienia: w celu zapewnienia spójności koncepcyjnej do tych 3 metod dodaliśmy photoslibrary.edit.appcreateddata:

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

Co możesz zrobić:

• Jeśli Twoja aplikacja już korzysta z tych metod, rozważ zastosowanie zakresu photoslibrary.edit.appcreateddata, aby uprościć proces autoryzacji.

Interfejs Library API: zakresy i metody, których to dotyczy

W ramach zmian w interfejsach API Zdjęć Google wprowadziliśmy te aktualizacje.

Jak widać na zaktualizowanej stronie Autoryzacja, po 31 marca 2025 r. z interfejsu Library API zostaną usunięte te uprawnienia:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Pozostaną te zakresy:

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

W tabeli znajdziesz szczegółowe informacje o dotkniętych metodach i zakresach interfejsu Library API.

Aktualizacje	Metody	Zakresy
Te metody można teraz stosować tylko w przypadku albumów i multimediów utworzonych przez Twoją aplikację.	albums.create mediaItems.batchCreate	Pozostałe zakresy: photoslibrary.appendonly Usunięto zakresy: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Pozostałe zakresy: photoslibrary.readonly.appcreateddata Usunięto zakresy: photoslibrary photoslibrary.readonly
Te metody nie będą już dostępne.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Pozostałe zakresy: Brak Usunięto zakresy: photoslibrary.sharing
Te metody zostaną uzupełnione o photoslibrary.edit.appcreateddata. Te metody można teraz stosować tylko w przypadku albumów i multimediów utworzonych przez Twoją aplikację.	albums.addEnrichment albums.batchAddMediaItems	Pozostałe zakresy: photoslibrary.appendonly photoslibrary.edit.appcreateddata Usunięto zakresy: photoslibrary
	albums.batchRemoveMediaItems	Pozostałe zakresy: photoslibrary.edit.appcreateddata Usunięto zakresy: photoslibrary
Te metody pozostaną bez zmian.	albums.patch mediaItems.patch	Pozostałe zakresy: photoslibrary.edit.appcreateddata Usunięto zakresy: Brak

Aktualizacje zasad interfejsu Photos API

Po 31 marca 2025 r. obecne Zasady akceptowalnego użytkowania zostaną zastąpione nowymi zasadami dotyczącymi danych użytkownika i programistów w interfejsie Photos API. Nowe zasady są już dostępne w wersji zapoznawczej.

Aktualizacje dokumentacji interfejsu Photos API

Wprowadziliśmy istotne zmiany w dokumentacji interfejsu API Zdjęć Google, aby odzwierciedlić nadchodzące aktualizacje i ułatwić Ci pracę:

• Witryna z jednolitymi interfejsami API usługi Zdjęcia: wszystkie zasoby interfejsu API usługi Zdjęcia zostały scalone w jednym miejscu (na tej stronie), co zapewnia deweloperom większą wygodę. Znajdziesz tam:
  • Zasoby centralne: połączone instrukcje konfiguracji i ogólne wskazówki dotyczące korzystania oraz połączone informacje o pomocy i zasadach dotyczące interfejsu Picker API i interfejsu Library API.
  • Specjalne strony interfejsów API: poszczególne strony z szczegółowymi przewodnikami, dokumentacją referencyjną i przykładami kodu dotyczącymi interfejsu API selektora i interfejsu API biblioteki.
• Zaktualizowany interfejs Library API: dokumentacja Library API została zaktualizowana, aby odzwierciedlić możliwości interfejsu Library API po zakończeniu okresu wycofywania.
• Zachowaliśmy starszą dokumentację: dla deweloperów, którzy muszą przenieść istniejące integracje, dostępna jest pierwotna dokumentacja interfejsu Library API. Jeśli zaczynasz nowy projekt, skorzystaj z zaktualizowanej dokumentacji. Jeśli aktualizujesz istniejący projekt, w razie potrzeby korzystaj z aktualnej i starszej dokumentacji.

Najczęstsze pytania

Co się zmienia w interfejsach Zdjęć Google API?

Wprowadzamy nowy interfejs Google Photos Picker API do bezpiecznego wybierania zdjęć oraz aktualizujemy istniejący interfejs Library API, aby skupić się na zarządzaniu zdjęciami i filmami utworzonymi przez Twoją aplikację.

Kiedy te zmiany zaczną obowiązywać?

Zmiany zaczną obowiązywać 31 marca 2025 r. Zachęcamy wszystkich, którzy korzystają z integracji używających interfejsu Library API do wybierania zdjęć, do jak najszybszego przejścia na interfejs Picker API.

Jak ta zmiana wpłynie na interfejs Library API?

Zakresy photoslibrary.readonly, photoslibrary.sharing i photoslibrary zostaną usunięte. Po 31 marca 2025 r. wywołania interfejsu API korzystające tylko z tych zakresów zwrócą odpowiedź 403 PERMISSION_DENIED. Niektóre inne wywołania będą ograniczone do działania tylko z zdjęciami i filmami utworzonymi przez Twoją aplikację.

Pełny zestaw zmian znajdziesz w tabeli zakresów i metod, których dotyczy aktualizacja na tej stronie.

Co zrobić, jeśli moja aplikacja obecnie używa dotkniętych metod lub zakresów?

Jeśli Twoja aplikacja korzysta z jakiejś z dotkniętych zmian metod lub zakresów, wykonaj te czynności:

• Wybór zdjęć: przejdź na interfejs Google Photos Picker API.
• W przypadku innych funkcji: zapoznaj się z aktualną dokumentacją interfejsu Library API, aby poznać zmiany i zidentyfikować funkcje w aplikacji, które mogą być niedostępne. W niektórych przypadkach może być konieczne dostosowanie funkcji aplikacji lub znalezienie alternatywnych rozwiązań.

Co to jest interfejs Google Photos Picker API?

Interfejs Picker API to nowy, bezpieczny sposób, dzięki któremu deweloperzy mogą umożliwić użytkownikom wybieranie zdjęć i filmów z biblioteki Zdjęć Google i bezproblemowe przesyłanie ich do aplikacji.

Gdzie znajdę więcej informacji o tych zmianach?

Ta strona, którą obecnie wyświetlasz, zawiera przegląd i podsumowanie wszystkich zmian.

Pozostała część dokumentacji na naszej stronie została zaktualizowana, aby odzwierciedlić zaktualizowane interfejsy API.

W tym poście na blogu znajdziesz więcej informacji o wprowadzanych zmianach.

Co zrobić, jeśli mam więcej pytań lub potrzebuję pomocy przy migracji aplikacji?

Jeśli masz pytania dotyczące dokumentacji dla deweloperów, odwiedź stronę pomocy, aby dowiedzieć się więcej o tym, jak uzyskać pomoc.