Примечания к выпускам

Подпишитесь на эти примечания к выпуску.

Эта страница обновляется с каждой новой версией API Google Фото. В журнале изменений перечислены выпуски по датам, а также все новые функции, исправления ошибок и другие изменения.

В документации и руководствах указана последняя версия, которую можно использовать.

1 апреля 2025 г.

Примечания

В этом выпуске реализованы ранее объявленные изменения в API фотографий.

• Удаление некоторых областей из API библиотеки.
• Ограничение некоторых методов для работы только с контентом, созданным приложением.
• Новая Политика использования данных пользователя и разработчиков API фотографий вступает в силу вместо старой Политики допустимого использования.

Более подробную информацию можно найти в разделе «Обновления API Google Фото» .

16 сентября 2024 г.

Функции

• Представлен новый API Picker для безопасного и удобного выбора фотографий.

Примечания

В этом выпуске мы объявили о ключевых изменениях в Library API (вступают в силу 31 марта 2025 г.).

• API библиотеки будет управлять только фотографиями и видео, созданными вашим приложением.
• Удаление областей photoslibrary.readonly , photoslibrary.sharing и photoslibrary .
• Ограничение некоторых методов только контентом, созданным приложением.

Полная информация представлена ​​на странице «Обновления API Google Фото» .

27 октября 2022 г.

Примечания

• Кодовая лаборатория «Создание приложения для обмена фотографиями с помощью Google Photos и Flutter» больше не доступна. Просмотрите другие наши примеры и обратитесь к образцу кода в наших руководствах.

1 июня 2022 г.

Примечания

• Добавлены рекомендации по загрузке, которые помогут прояснить процесс загрузки, выявить распространенные ошибки и способы их предотвращения, а также дать советы по повышению эффективности загрузки.

27 октября 2021 г.

Функции

• Партнерская программа Google Photos: запуск высшего уровня . Главный уровень — это набор расширенных функций API, которые используют мощный машинный интеллект фотографий Google.

29 сентября 2021 г.

Функции

• Новая опция для сортировки результатов поиска по дате . Результаты можно сортировать сначала самые новые или сначала самые старые. Это упрощает поиск и повышает эффективность за счет предоставления более целевых результатов поиска.

21 июля 2021 г.

Функции

• Новый параметр -no для базовых URL-адресов видео для загрузки миниатюр без наложения кнопки воспроизведения. По умолчанию миниатюры видео загружаются с наложением кнопки воспроизведения. Этот новый параметр дает вам возможность скрыть кнопку воспроизведения на миниатюрах видео.

Решенные проблемы

• Проблема 181282432 : Миниатюры видео всегда отображаются с наложением кнопки воспроизведения.

25 мая 2021 г.

Решенные проблемы

• Свойство exposureTime не было заполнено для метаданных photo в элементах мультимедиа.

19 мая 2021 г.

Примечания

• Документация по базовому URL-адресу для движущихся фотографий была обновлена, чтобы прояснить поведение параметра =dv для движущихся фотографий Android и iOS Live Photos.

11 февраля 2021 г.

Примечания

• Политика допустимого использования была обновлена, в нее добавлен контент, посвященный рекламе, и сведено к минимуму использование данных.

7 июля 2020 г.

Функции

• API был обновлен для поддержки новых элементов управления общим доступом в Google Фото . Новое поле isJoinable теперь возвращается как часть свойства shareInfo для общих альбомов. API может присоединять пользователей к общему альбому, если isJoinable имеет true . Если владелец отключил общий доступ по ссылке для альбома в Google Фото, isJoinable будет false , и API не сможет присоединять пользователей к этому альбому.
• Проблемы 111405623 , 116379853 , 117685011 : теперь вы можете изменять названия альбомов и фотографии обложек , а также изменять описания для мультимедийных элементов, созданных вашим приложением. Запросите новую область авторизации photoslibrary.edit.appcreateddata для доступа к обновлениям.

17 февраля 2020 г.

Функции

• Максимальный размер загружаемого файла фотографии увеличен с 75 МБ до 200 МБ.
• При загрузке файлов тип MIME теперь необходимо указывать на этапе загрузки байтов .
• Теперь вы указываете имена файлов при создании медиа-элемента , а не при загрузке медиа-байтов. Новое свойство fileName в simpleMediaItem поддерживает строки UTF-8. Вы по-прежнему можете указать имя файла медиа-элемента при загрузке медиа-байтов, однако мы настоятельно рекомендуем обновить вашу реализацию.

Примечания

• Политика допустимого использования была обновлена, и в нее добавлены некоторые дополнительные детали, касающиеся минимизации использования и хранения данных.
• Документация по базовому URL была обновлена ​​и теперь включает в себя движущиеся фотографии.

16 августа 2019 г.

Функции

• Проблема 131874809 : Новое свойство isOwned в shareInfo , позволяющее определить, является ли пользователь владельцем общего альбома. Более подробную информацию можно найти в руководстве разработчика совместного использования мультимедиа .

Решенные проблемы

• Проблема 131711405 : в ответе albums.list отсутствовало shareableUrl .
• Проблема 113870729 : mediaItems.list иногда возвращал повторяющиеся элементы мультимедиа на границах страниц.
• Проблема 93428763 : поле status метаданных видео теперь правильно возвращает VideoProcessingStatus доступного видео самого высокого качества.

12 июня 2019 г.

Функции

• Проблема 110188560 : Новый фильтр поиска для выбора элементов мультимедиа, помеченных как избранные: FeatureFilter .
• Новые категории контента для ContentFilter для фильтрации медиа-элементов, соответствующих определенным категориям: ARTS , CRAFTS , FASHION , HOUSES , GARDENS , FLOWERS , HOLIDAYS .

Примечания

• Обновлены рекомендации по пользовательскому интерфейсу , содержащие дополнительные рекомендации по присвоению имен проектам и альбомам .

7 мая 2019 г.

Кодлабы

• Новая Codelab: создайте приложение для обмена фотографиями с помощью Google Photos и Flutter . Узнайте, как создать приложение для обмена фотографиями с помощью API библиотеки Google Фото во Flutter. Подробности смотрите в руководстве по образцам .

29 апреля 2019 г.

Функции

• Проблема 109505022 : Новые вызовы для добавления и удаления существующих мультимедийных элементов в альбом:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Эти вызовы поддерживают элементы мультимедиа и альбомы, созданные вашим приложением. Более подробную информацию можно найти в руководстве разработчика по управлению альбомами .

• Вызов REST для создания элементов мультимедиа mediaItems.batchCreate теперь возвращает статус HTTP 207 MULTI-STATUS для частичного успеха, если некоторые элементы мультимедиа не удалось создать. Более подробную информацию можно найти в руководстве разработчика по загрузке мультимедиа .

Примечания

• Последние версии клиентских библиотек содержат критические изменения. Классы, связанные с MediaItem , Album и DateRange перенесены в новый специальный пакет. Их функционал не изменился, только расположение в клиентской библиотеке. См. примечания к выпуску клиентской библиотеки Java (1.2.0) и клиентской библиотеки PHP (1.2.0) .

14 февраля 2019 г.

Примечания

• Применяется новый предел квоты для доступа к медиабайтам из базовых URL-адресов . Вы можете отслеживать эту квоту в консоли Google API .

Решенные проблемы

• Проблема 124355983 : 500 ошибок при вызове mediaItems.get для некоторых общих медиа-элементов.

21 января 2019 г.

Решенные проблемы

• Проблема 121998358 : свойство isWriteable отсутствовало в ответе albums.create .

7 января 2019 г.

Решенные проблемы

• Проблема 118464845 : mediaItems.list вернул слишком много пустых страниц.
• Проблема 111714379 : mediaItems.search вернул половину pageSize .

30 ноября 2018 г.

Функции

• Новый вызов mediaItems.batchGet для получения нескольких элементов мультимедиа по их идентификаторам.
• Проблема 111279349 : новый вызов sharedAlbums.leave , чтобы покинуть альбом, к которому вы присоединились.
• Проблема 111279347 : новый вызов albums.unshare , чтобы пометить общий альбом как личный.

Решенные проблемы

• Проблема 113978705 : описания, заданные в mediaItems.batchCreate , были преобразованы в объекты HTML.
• Проблема 114462217 : не удалось задать имя файла для видеофайлов в mediaItems.batchCreate .
• Проблема 118475587 : для элементов мультимедиа были возвращены неверные URL-адреса продуктов.
• Проблема 111862704 : ошибка 403 при доступе к базовым URL-адресам.
• Проблема 115932469 : Сбой при загрузке из-за ошибки квоты.

6 сентября 2018 г.

Функции

• Клиентские библиотеки Java и PHP теперь доступны.

Примечания

• API библиотеки Google Фото стал общедоступным. Благодарим за ваши отзывы и запросы на добавление функций в период предварительной версии Library API для разработчиков.
• Ознакомьтесь с новыми руководствами по началу работы с клиентскими библиотеками Java и PHP .
• В руководства добавлены примеры фрагментов кода Java и PHP, демонстрирующие использование клиентских библиотек.

5 сентября 2018 г.

Функции

• Новый sharedAlbums.get , чтобы получить альбом с помощью shareToken .
• Новое свойство isJoined в shareInfo , чтобы определить, присоединился ли пользователь к общему альбому.

Решенные проблемы

• Проблема 79321120 : свойство mimeType отсутствовало в ответе mediaItems.batchCreate для элементов мультимедиа видео.
• Проблема 79319272 : такие свойства, как mediaMetadata , contributorInfo отсутствовали в ответе mediaItems.batchCreate .
• Проблема 110237685 : исправлена ​​проблема с загрузкой файлов, связанная с CORS.
• Проблема 79318118 : не соблюдался последовательный порядок при загрузке нескольких элементов в альбом при вызове mediaItems.batchCreate .

Примечания

• Если вы сохранили идентификаторы (например, идентификаторы альбомов, медиа-элементов или дополнительных элементов) до 5 сентября 2018 г., они больше не будут работать, поскольку формат изменился. Вам потребуется получить новые идентификаторы для использования в вашем приложении.
• Свойство totalMediaItems ресурса альбома было переименовано в mediaItemsCount .
• Максимальное значение параметра pageSize в вызовах mediaItems.list и mediaItems.search было изменено на 100. Число медиа-элементов по умолчанию, возвращаемое, если параметр pageSize не указан, изменено на 25.
• Руководства по списку содержимого библиотеки , совместному использованию мультимедиа и доступу к элементам мультимедиа , обновленные с помощью функции фильтра excludeNonAppCreatedData ](/photos/library/guides/apply-filters#nonapp-created), выпущенной 31 июля 2018 г.

31 июля 2018 г.

Функции

• Новый вызов mediaItems.list для получения списка элементов мультимедиа.
• Новый фильтр excludeNonAppCreatedData для поиска элементов или списка альбомов, созданных вашим приложением.
• Новые параметры для доступа к изображениям :
  • Проблема 79871479 : параметр c обрезки, чтобы обрезать изображение до точных размеров.
  • Проблема 110343547 , Проблема 111228390 : d параметр загрузки, чтобы загрузить исходное изображение.
• Вызов sharedAlbums.join теперь возвращает альбом .
• Проблема 109655786 : album теперь содержит идентификатор медиа-элемента обложки, coverPhotoMediaItemId .
• Проблема 79656863 : mediaItem теперь содержит имя файла медиа-элемента filename .

Решенные проблемы

• Проблема 79757390 : имя файла не было задано во время запросов на загрузку. См. поля X-Goog-Upload-File-Namefile и X-Goog-Upload-Protocol в руководстве по загрузке мультимедиа .
• Проблема 80182372 : при возобновлении загрузки возникла ошибка. См. новое руководство по возобновлению загрузки для обновленного протокола.
• Проблема 79497397 : свойство isWriteable отсутствует в ответе albums.list .
• Проблема 111143493 : Фильтр категории контента PEOPLE возвращал неточные результаты.
• Проблема 111056278 : Фильтр категории контента BIRTHDAYS возвращал ошибку.

Предварительный выпуск – 8 мая 2018 г.

Первоначальный выпуск API библиотеки.

Известные проблемы

• GET mediaItem выдает ошибку, если полученный id медиа-элемента относится к медиа-элементу из общего альбома и не принадлежит пользователю.
• Ответ на вызов batchCreate не вернет mediaMetadata или contributorInfo .
• Если медиа-элементом является видео, вызов batchCreate не вернет mimeType .
• batchCreate не поддерживает последовательный порядок при загрузке нескольких элементов.
• batchCreate не поддерживает упорядочивание (добавление position ) при создании элементов мультимедиа в общем альбоме в качестве владельца общего альбома. По умолчанию это конец альбома.