Ta strona została przetłumaczona przez Cloud Translation API.

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 zmiany mogą wpłynąć na używane przez Ciebie metody i zakresy. Więcej informacji o ogłoszeniu tych zmian 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: brak 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żytkownika 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ć błąd 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, aby ułatwić użytkownikom korzystanie z usługi.

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 Google Photos API wprowadziliśmy te aktualizacje.

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

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` Uwaga: element `sharedAlbums.list` jest usuwany, ponieważ nie będzie już można wyświetlać albumów współdzielonych utworzonych przez Twoją aplikację.
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

Zmiany w zasadach dotyczących interfejsu Photos API

Po 31 marca 2025 r. obecne Zasady dozwolonego użycia zostaną zastąpione nowymi zasadami dotyczącymi danych użytkownika w interfejsie Photos API i zasadami dla deweloperów. 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 ujednoliconymi interfejsami API usługi Zdjęcia: wszystkie zasoby interfejsów 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.
Zaktualizowana treść Library API: dokumentacja Library API została zaktualizowana, aby odzwierciedlić możliwości interfejsu Library API po zakończeniu okresu wycofywania.

Najczęstsze pytania

Co się zmienia w interfejsach Google Photos 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 wejdą w życie 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:

W przypadku wyboru 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 ogłosiliśmy te zmiany.

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.