Informacje o wersjach

Zasubskrybuj te informacje o wersji.

Ta strona jest aktualizowana wraz z każdą nową wersją interfejsów Google Photos API. Lista zmian zawiera wersje według daty i obejmuje nowe funkcje, poprawki błędów i inne zmiany.

Dokumentacja i przewodniki wskazują najnowszą wersję.

1 kwietnia 2025 r.

Uwagi

Ta wersja wdraża wcześniej ogłoszone zmiany interfejsów API Zdjęć.

• Usunięcie niektórych zakresów z interfejsu Library API.
• Ograniczenie działania niektórych metod tylko do treści utworzonych w aplikacji.
• Nowe zasady dotyczące danych użytkownika i deweloperów w interfejsie Photos API zastępują stare Zasady dopuszczalnego użytkowania.

Szczegółowe informacje znajdziesz w artykule Zmiany w interfejsach Google Photos API.

16 września 2024 r.

Funkcje

• Wprowadziliśmy nowy interfejs Picker API, który umożliwia bezpieczny i przyjazny dla użytkownika wybór zdjęć.

Uwagi

W tej wersji ogłosiliśmy kluczowe zmiany w interfejsie Library API (obowiązujące od 31 marca 2025 r.).

• Interfejs API Library będzie zarządzać tylko zdjęciami i filmami utworzonymi przez Twoją aplikację.
• Usunięcie zakresów photoslibrary.readonly, photoslibrary.sharing i photoslibrary.
• Ograniczenie kilku metod tylko do treści utworzonych w aplikacji.

Pełne informacje znajdziesz na stronie Zmiany w interfejsach Google Photos API.

27 października 2022 r.

Uwagi

• Codelab „Utwórz aplikację do udostępniania zdjęć za pomocą Zdjęć Google i Fluttera” nie jest już dostępny. Zapoznaj się z pozostałymi przykładami i przykładowym kodem w naszych przewodnikach.

1 czerwca 2022 r.

Uwagi

• Dodaliśmy sprawdzone metody przesyłania, aby ułatwić Ci zrozumienie procesu przesyłania, wskazać typowe błędy i wskazówki, jak ich unikać, oraz podać wskazówki dotyczące zwiększania wydajności przesyłania.

27 października 2021 r.

Funkcje

• Program partnerski Zdjęć Google: uruchomiliśmy poziom premium. Pakiet Premier to zestaw rozszerzonych funkcji interfejsu API, który wykorzystuje zaawansowaną sztuczną inteligencję Zdjęć Google.

29 września 2021 r.

Funkcje

• Nowa opcja sortowania wyszukiwań na podstawie filtra daty. Wyniki można sortować od najnowszych do najstarszych lub odwrotnie. Dzięki temu wyszukiwanie jest łatwiejsze, a wyniki wyszukiwania są lepiej dopasowane.

21 lipca 2021 r.

Funkcje

• Nowy -no parametr adresów URL filmów podstawowych umożliwiający wczytywanie miniatur bez nakładki przycisku odtwarzania. Domyślnie miniatury filmów wczytują się z nakładką przycisku odtwarzania. Ten nowy parametr umożliwia ukrywanie przycisku odtwarzania na miniaturach filmów.

Rozwiązane problemy

• Problem 181282432: miniatury filmów zawsze wyświetlane są z nakładką przycisku odtwarzania.

25 maja 2021 r.

Rozwiązane problemy

• W usłudze exposureTime nie wypełniono metadanych photo w elementach multimedialnych.

19 maja 2021 r.

Uwagi

• Dokumentacja dotycząca adresu URL zdjęć w ruchu została zaktualizowana, aby wyjaśnić działanie parametru =dv w przypadku zdjęć w ruchu na Androida i zdjęć Live Photo na iOS.

11 lutego 2021 r.

Uwagi

• Zaktualizowaliśmy Zasady dopuszczalnego użytkowania, dodając treści dotyczące reklam i minimalizowania wykorzystania danych.

7 lipca 2020 r.

Funkcje

• Interfejs API został zaktualizowany, aby obsługiwać nowe opcje udostępniania w Google Photos. W przypadku albumów udostępnionych w ramach właściwości shareInfo zwracane jest teraz nowe pole isJoinable. Interfejs API może dołączać użytkowników do udostępnionego albumu, gdy isJoinable jest true. Jeśli właściciel wyłączył udostępnianie linku do albumu w Zdjęciach Google, isJoinable będzie false, a interfejs API nie będzie mógł dodać użytkowników do tego albumu.
• Problemy 111405623, 116379853, 117685011: możesz teraz zmieniać tytuły albumów i zdjęcia okładek oraz zmieniać opisy multimediów utworzonych przez Twoją aplikację. Poproś o nowe photoslibrary.edit.appcreateddata zakres uprawnień, aby uzyskać dostęp do aktualizacji.

17 lutego 2020 r.

Funkcje

• Maksymalny rozmiar przesyłanego pliku ze zdjęciem został zwiększony z 75 MB do 200 MB.
• Podczas przesyłania plików musisz teraz określić typ MIME na etapie przesyłania bajtów.
• Nazwy plików musisz teraz podawać podczas tworzenia elementu multimedialnego, a nie podczas przesyłania bajtów multimedialnych. Nowa właściwość fileName w simpleMediaItem obsługuje ciągi znaków UTF-8. Podczas przesyłania bajtów multimediów nadal możesz określić nazwę pliku elementu multimedialnego, ale zdecydowanie zalecamy zaktualizowanie implementacji.

Uwagi

• Zasady dopuszczalnego użytkowania zostały zaktualizowane i rozszerzone o dodatkowe informacje dotyczące minimalizowania wykorzystania i przechowywania danych.
• Dokumentacja dotycząca adresu URL podstawowego została zaktualizowana, aby uwzględniała zdjęcia ruchome.

16 sierpnia 2019 r.

Funkcje

• Problem 131874809: nowa właściwość isOwned w shareInfo, która pozwala określić, czy użytkownik jest właścicielem albumu udostępnionego. Więcej informacji znajdziesz w przewodniku dla deweloperów dotyczącym udostępniania treści multimedialnych.

Rozwiązane problemy

• Problem 131711405: w odpowiedzi albums.list brakuje właściwości shareableUrl.
• Problem 113870729: mediaItems.listczasami zwracane były zduplikowane elementy multimedialne na granicach stron.
• Problem 93428763: pole status dla metadanych wideo teraz prawidłowo zwraca VideoProcessingStatuswideo o najwyższej dostępnej jakości.

12 czerwca 2019 r.

Funkcje

• Problem 110188560: nowy filtr wyszukiwania do wybierania elementów multimedialnych oznaczonych jako ulubione:FeatureFilter.
• Nowe kategorie treści w ContentFilter, aby filtrować elementy multimediów, które pasują do określonych kategorii: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS.

Uwagi

• Zaktualizowaliśmy wytyczne dotyczące UX, które zawierają dodatkowe wskazówki dotyczące nazewnictwa projektów i albumów.

7 maja 2019 r.

Codelabs

• Nowe Codelab: utwórz aplikację do udostępniania zdjęć za pomocą Zdjęć Google i Fluttera. Dowiedz się, jak tworzyć aplikacje do udostępniania zdjęć za pomocą interfejsu API Zdjęć Google w Flutterze. Szczegółowe informacje znajdziesz w przewodniku po próbkach.

29 kwietnia 2019 r.

Funkcje

• Problem 109505022: nowe wywołania dodawania i usuwania istniejących multimediów do albumu:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Te wywołania obsługują elementy multimedialne i albumy utworzone przez Twoją aplikację. Więcej informacji znajdziesz w przewodniku dla deweloperów dotyczącym zarządzania albumami.

• Wywołanie REST służące do tworzenia elementów multimedialnych mediaItems.batchCreate zwraca teraz kod stanu HTTP 207 MULTI-STATUS w przypadku częściowego powodzenia, jeśli nie udało się utworzyć niektórych elementów multimedialnych. Więcej informacji znajdziesz w przewodniku dla deweloperów dotyczącym przesyłania multimediów.

Uwagi

• Najnowsze wersje bibliotek klienta zawierają zmianę powodującą niezgodność. Klasy związane z poziomami MediaItem, Album i DateRange zostały przeniesione do nowego dedykowanego pakietu. Ich funkcje nie uległy zmianie, zmieniła się tylko ich lokalizacja w bibliotece klienta. Zapoznaj się z informacjami o wersji biblioteki klienta Java (1.2.0) i biblioteki klienta PHP (1.2.0).

14 lutego 2019 r.

Uwagi

• Obowiązuje nowy limit kwoty dostępu do bajtów multimediów z podstawowych adresów URL. Ten limit możesz monitorować w Konsoli interfejsów API Google.

Rozwiązane problemy

• Problem 124355983: podczas wywoływania interfejsu mediaItems.get w przypadku niektórych udostępnionych elementów multimedialnych występują błędy 500.

21 stycznia 2019 r.

Rozwiązane problemy

• Problem 121998358: w odpowiedzi albums.create brakuje właściwości isWriteable.

7 stycznia 2019 r.

Rozwiązane problemy

• Problem 118464845: mediaItems.list zwróciło zbyt wiele pustych stron.
• Problem 111714379: mediaItems.search zwraca połowę wartości pageSize.

30 listopada 2018 r.

Funkcje

• Nowe wywołanie mediaItems.batchGet do pobierania wielu elementów multimedialnych według ich identyfikatorów.
• Problem 111279349: nowe wywołanie sharedAlbums.leavedo opuszczenia połączonego albumu.
• Problem 111279347: nowa metoda wywołania albums.unshare służąca do oznaczania udostępnionego albumu jako prywatnego.

Rozwiązane problemy

• Problem 113978705: opisy ustawione w elementach mediaItems.batchCreate zostały przekonwertowane na elementy HTML.
• Problem 114462217: nie udało się ustawić nazwy pliku dla plików wideo w mediaItems.batchCreate.
• Problem 118475587: nieprawidłowe adresy URL produktów zwrócone dla elementów multimedialnych.
• Problem 111862704: błędy 403 podczas uzyskiwania dostępu do adresów URL bazy danych.
• Problem 115932469: przesyłanie nie działa z powodu błędu dotyczącego limitu.

6 września 2018 r.

Funkcje

• Biblioteki klienta w językach Java i PHP są już dostępne.

Uwagi

• Interfejs Google Photos Library API jest już ogólnie dostępny. Dziękujemy za opinie i prośby o dodanie funkcji przesłane w trakcie okresu przedpremierowego udostępnienia interfejsu Library API dla deweloperów.
• Zapoznaj się z nowymi przewodnikami dotyczącymi korzystania z bibliotek klienta Java i PHP.
• Aby pokazać, jak używać bibliotek klienta, dodaliśmy do przewodników przykładowe fragmenty kodu w językach Java i PHP.

5 września 2018 r.

Funkcje

• Nowe połączenie sharedAlbums.get, aby pobrać album za pomocą shareToken.
• Nowa właściwość isJoined w shareInfo, aby określić, czy użytkownik dołączył do albumu udostępnionego.

Rozwiązane problemy

• Problem 79321120: w odpowiedzi mediaItems.batchCreate brakuje właściwości mimeType w przypadku elementów multimediów wideo.
• Problem 79319272: w odpowiedzi mediaItems.batchCreate brakowało właściwości takich jak mediaMetadata i contributorInfo.
• Problem 110237685: rozwiązano problem z przesyłaniem plików związany z CORS.
• Problem 79318118: podczas przesyłania wielu elementów do albumu w wywołaniu mediaItems.batchCreate nie był zachowany spójny porządek.

Uwagi

• Jeśli identyfikatory (np. identyfikatory albumów, elementów multimedialnych lub elementów wzbogacenia) zostały zapisane przed 5 września 2018 r., nie będą już działać, ponieważ zmienił się ich format. Musisz uzyskać nowe identyfikatory do użycia w aplikacji.
• Nazwa właściwości totalMediaItems zasobu album została zmieniona na mediaItemsCount.
• Maksymalna wartość parametru pageSize w wywołaniach mediaItems.list i mediaItems.search została zmieniona na 100. Domyślna liczba elementów multimedialnych zwracanych, gdy parametr pageSize nie jest określony, została zmieniona na 25.
• Zaktualizowane zostały przewodniki dotyczące listy zawartości biblioteki, udostępniania multimediów i dostępu do multimediów z uwzględnieniem funkcji filtrowania wprowadzonej 31 lipca 2018 r..excludeNonAppCreatedData

31 lipca 2018 r.

Funkcje

• Nowe wywołanie mediaItems.list do listy elementów multimedialnych.
• Nowy filtr excludeNonAppCreatedData do wyszukiwania elementów lub wyświetlania albumów utworzonych przez Twoją aplikację.
• Nowe parametry dostępu do obrazów:
  • Problem 79871479: parametr przycinania c, aby przyciąć obraz do dokładnych wymiarów.
  • Problem 110343547, problem 111228390: parametr d download, służący do pobrania oryginalnego obrazu.
• Wywołanie sharedAlbums.joinzwraca teraz album.
• Problem 109655786: album zawiera teraz identyfikator elementu multimedialnego zdjęcia okładki, coverPhotoMediaItemId.
• Problem 79656863: mediaItem zawiera teraz nazwę pliku elementu multimedialnego, filename.

Rozwiązane problemy

• Problem 79757390: podczas przesyłania plików nie ustawiano nazwy pliku. Zapoznaj się z polami X-Goog-Upload-File-Namefile i X-Goog-Upload-Protocol w przewodniku Przesyłanie multimediów.
• Problem 80182372: przesyłanie z możliwością wznowienia zwróciło błąd. Zapoznaj się z nowym przewodnikiem dotyczącym przerwanych przesyłek w przypadku zaktualizowanego protokołu.
• Problem 79497397: w odpowiedzi albums.list brakuje właściwości isWriteable.
• Problem 111143493: filtr kategorii treści PEOPLE zwracał nieprawidłowe wyniki.
• Problem 111056278: filtr kategorii treści BIRTHDAYS zwracał błąd.

Wersja testowa – 8 maja 2018 r.

Pierwsza wersja interfejsu Library API.

Znane problemy

• GET mediaItem zwraca błąd, jeśli otrzymany element multimedialny id pochodzi z udostępnionego albumu i nie należy do użytkownika.
• Odpowiedź z poziomu wywołania batchCreate nie będzie zawierać wartości mediaMetadata ani contributorInfo.
• Jeśli element multimedialny to film, wywołanie batchCreate nie zwróci wartości mimeType.
• batchCreate nie zachowuje spójnego porządku podczas przesyłania wielu elementów.
• batchCreate nie obsługuje sortowania (dodawania w position) podczas tworzenia elementów multimedialnych w albumie udostępnionym jako właściciel tego albumu. Domyślnie jest to koniec albumu.