Aktualizacje interfejsów API Zdjęć Google

Opublikowano we wrześniu 2024 r.

Ta strona zawiera szczegółowe informacje o konkretnych zmianach wprowadzanych w Zdjęciach Google API. Zapoznaj się ze szczegółowymi informacjami na tej stronie, aby dowiedzieć się, jak metody i zakresy może mieć wpływ na używaną aplikację. Więcej informacji o ogłoszeniu tych zmian znajdziesz zmiany w odpowiednim poście na blogu.

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

W poniższych sekcjach szczegółowo opisujemy wpływ nadchodzących zmian na typowe zastosowania przypadków.

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

Co się zmienia: bez zmian. Nadal możesz przesyłać elementy multimedialne oraz 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 zakres photoslibrary.appendonly, a nie zakres photoslibrary. Usuwam photoslibrary zakres.

Wyświetlanie listy, wyszukiwanie i pobieranie elementów multimedialnych oraz 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 wybierali zdjęcia lub albumy ze wszystkich użyj nowego selektora Zdjęć Google API. Zapewnia to bezpieczne, łatwy w użyciu sposób przyznawania użytkownikom dostępu do określonych treści.
• Jeśli aplikacja wymaga dostępu do całej biblioteki użytkownika, może być konieczne ponownie ocenić aplikację lub rozważyć alternatywne rozwiązania.

Udostępnianie i albumy udostępnione

Co się zmienia: albumy udostępnione i powiązane z nimi funkcje interfejsów API (udostępnianie, cofnij udostępnianie, pobierz, dołącz, opuszczaj i wyświetl) zwraca błąd 403 PERMISSION_DENIED po 31 marca 2025 r.

Co możesz zrobić:

Kieruj użytkowników do aplikacji Zdjęcia Google, aby mogli sami zarządzać udostępnianiem. Dostępne opcje podawaj w aplikacji jasne instrukcje lub precyzyjne linki, które będą nimi pokierować.

Zarządzanie albumami utworzonymi w aplikacji: informacjami i zawartością albumów

Co się zmienia: usługa photoslibrary.edit.appcreatedata jest dodawana do: następujące 3 metody zapewniania spójności koncepcyjnej:

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

Co możesz zrobić:

• Jeśli Twoja aplikacja używa już tych metod, rozważ wdrożenie photoslibrary.edit.appcreatedata zakres, aby uprościć autoryzację proces tworzenia konta.

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

W ramach zmian w interfejsach API Zdjęć Google wprowadziliśmy następujące zmiany: aktualizacje.

Zgodnie z informacjami w zaktualizowanej autoryzacji stronie, te zakresy zostaną usunięte z interfejsu Library API po 31 marca 2025 roku:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Te zakresy pozostaną bez zmian:

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

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

Aktualizacje	Metody	Zakresy
Metody te można teraz używać tylko w przypadku albumów i multimediów utworzonych przez Twoją aplikację. Dotyczy to multimediów wybranych za pomocą interfejsu Picker API i dodanych do biblioteki użytkownika za pomocą interfejsu Library API.	albums.create mediaItems.batchCreate	Pozostałe zakresy: photoslibrary.appendonly Usunięte zakresy: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Pozostałe zakresy: photoslibrary.readonly.appcreatedata Usunięte 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ęte zakresy: photoslibrary.sharing
Do tych metod zostaną dodane następujące metody: photoslibrary.edit.appcreatedata. Tych metod można teraz używać tylko w przypadku albumów i elementów multimedialnych utworzonych przez Twoją aplikację. Obejmuje to elementy multimedialne wybrane przy użyciu interfejsu Picker API i dodane do biblioteki użytkownika za pomocą interfejsu Library API.	albums.addEnrichment albums.batchAddMediaItems	Pozostałe zakresy: photoslibrary.appendonly photoslibrary.edit.appcreatedata Usunięte zakresy: photoslibrary
	albums.batchRemoveMediaItems	Pozostałe zakresy: photoslibrary.edit.appcreatedata Usunięte zakresy: photoslibrary
Te metody pozostaną bez zmian.	albums.patch mediaItems.patch	Pozostałe zakresy: photoslibrary.edit.appcreatedata Usunięte zakresy: Brak

Aktualizacja zasad interfejsu Photos API

Obecne zasady dopuszczalnego użytkowania zastąpione po 31 marca 2025 roku nowymi danymi użytkownika i programistami interfejsu Photos API. Zasady. Nowe zasady są już dostępne w wersji zapoznawczej.

Zmiany w dokumentacji interfejsu Photos API

Wprowadziliśmy istotne zmiany w dokumentacji interfejsu Photos API, aby uwzględnić nadchodzące aktualizacje i ułatwianie programowania:

• Witryna z jednolitymi interfejsami API usługi Zdjęcia: wszystkie zasoby interfejsu API usługi Zdjęcia zostały zebrane w jednym, wygodnym miejscu (na tej stronie), co zapewnia deweloperom większą wygodę. Tutaj znajdziesz:
  • 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.
  • Witryny z dedykowanymi interfejsami API: pojedyncze witryny ze szczegółowymi przewodnikami, dokumentacja i przykłady kodu selektora API i Biblioteka Interfejs API
• Zaktualizowana zawartość interfejsu Library API: dokumentacja interfejsu Library API. została poprawiona, aby odzwierciedlić jej możliwości po okresie wycofania. W zaktualizowanej dokumentacji znajdziesz etykiety wskazujące treści, które zostały zmienione lub usunięte, oraz linki do odpowiednich starszych treści, które mogą posłużyć jako punkt odniesienia podczas migracji.
• Zachowana starsza wersja dokumentacji: zachowaliśmy oryginalną wersję interfejsu Library API dokumentacji dla deweloperów, przenieść istniejące integracje. Jeśli zaczynasz nowy projekt, skorzystaj z zaktualizowanej dokumentacji. Jeśli aktualizujesz istniejący projekt, zapoznaj się zarówno ze starszymi, jak i zaktualizowanymi dokumentację, której potrzebujesz.

Najczęstsze pytania

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

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 zaczną obowiązywać te zmiany?

Zmiany zaczną obowiązywać 31 marca 2025 r. Zachęcamy wszystkich istniejących integracji, które korzystają z interfejsu Library API na potrzeby wybierania zdjęć, do zacznij korzystać z interfejsu Picker API.

Jak ta zmiana wpłynie na interfejs Library API?

photoslibrary.readonly, photoslibrary.sharing i photoslibrary zakresy zostaną usunięte. Wywołania interfejsu API korzystające tylko z tych zakresów zwracają błąd 403 PERMISSION_DENIED Kilka innych połączeń będzie ograniczonych do działania ze zdjęciami i filmami utworzonymi przez Twoją aplikację.

Pełny zestaw zmian znajdziesz w tabeli u góry tej strony.

Co zrobić, jeśli moja aplikacja używa obecnie zakresów lub metod, których dotyczy problem?

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

• Aby wybrać zdjęcia, przejdź do interfejsu Google Photos Picker API.
• W przypadku innych funkcji zapoznaj się ze zaktualizowaną dokumentacją interfejsu Library API, aby zrozumieć zmiany oraz zidentyfikować funkcje, które mogą już przestać działać nie powinny być dostępne. Może być konieczne dostosowanie funkcji aplikacji lub jej sprawdzenie i aplikacjach.

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 albumów z biblioteki Zdjęć Google i bezproblemowe przesyłanie ich do aplikacji. Interfejs Picker API zapewnia zaawansowane funkcje wyboru zdjęć, Może to być np. wybór poszczególnych elementów i wszystkich elementów w albumie, w bibliotece Zdjęć Google.

Gdzie znajdę więcej informacji na temat tych zmian?

Obecnie przeglądana strona zawiera: z podsumowaniem wszystkich zmian.

Pozostała dokumentacja w naszej witrynie została zaktualizowana, aby uwzględniała: do zaktualizowanych interfejsów API.

W tym poście na blogu ogłosiliśmy te zmiany.

Co zrobić, jeśli nadal mam pytania lub potrzebujesz pomocy przy migracji aplikacji?

Jeśli masz pytania dotyczące dokumentacji dla deweloperów, zapoznaj się z naszym zespołem pomocy , gdzie znajdziesz dodatkowe informacje o tym, jak uzyskać pomoc.