Обновления API Google Фото

Опубликовано в сентябре 2024 г.

На этой странице представлена ​​подробная информация о конкретных изменениях, внесенных в API Google Фото. Ознакомьтесь с подробностями на этой странице, чтобы понять, как это может повлиять на используемые вами методы и области действия.

Примечание. Все изменения вступят в силу в марте 2025 г.

Библиотечный API: влияние на распространенные случаи использования

В следующих разделах подробно описано влияние предстоящих изменений на распространенные случаи использования.

Загрузка медиафайлов и создание альбомов

Что меняется: Без изменений. Вы можете продолжать загружать элементы мультимедиа и создавать альбомы, используя область photoslibrary.appendonly .

Что вы можете сделать:

Если ваше приложение загружает мультимедийные элементы или создает альбомы, убедитесь, что вы используете область photoslibrary.appendonly , а не область photoslibrary . Область photoslibrary удаляется.

Перечисление, поиск и извлечение мультимедийных элементов и альбомов

Что меняется: теперь вы можете просматривать, искать и извлекать только те альбомы и мультимедийные элементы, которые были созданы вашим приложением.

Что вы можете сделать:

• Если вашему приложению нужно, чтобы пользователи могли выбирать фотографии или альбомы из всей своей библиотеки, используйте новый API выбора Google Photos . Это обеспечивает безопасный и удобный способ предоставления пользователям доступа к определенному контенту.
• Если ваше приложение использует доступ ко всей библиотеке пользователя, возможно, вам придется пересмотреть свое приложение или рассмотреть альтернативные подходы.

Совместное использование и общие альбомы

Что изменится: общие альбомы и связанные с ними функции API (поделиться, отменить общий доступ, получить, присоединиться, покинуть и составить список) будут возвращать код 403 PERMISSION_DENIED после 31 марта 2025 г.

Что вы можете сделать:

Направляйте пользователей в приложение Google Photos, чтобы они сами могли управлять совместным доступом. Вы можете предоставить четкие инструкции или глубокие ссылки в своем приложении, которые помогут им.

Управление альбомами, созданными в приложении: дополнения и содержимое альбомов

Что меняется: для обеспечения концептуальной согласованности к следующим трем методам добавляется файл photoslibrary.edit.appcreatedata :

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

Что вы можете сделать:

• Если ваше приложение уже использует эти методы, рассмотрите возможность использования области photoslibrary.edit.appcreatedata , чтобы упростить процесс авторизации.

API библиотеки: затронутые области и методы

В рамках наших изменений в API Google Фото мы внесли следующие обновления.

Как показано на обновленной странице авторизации , следующие области будут удалены из Library API после 31 марта 2025 г.:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Следующие области действия останутся:

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

В этих таблицах подробно описаны конкретные методы и области API библиотеки, на которые они влияют.

Обновления	Методы	Области применения
Эти методы теперь можно использовать только с альбомами и медиа-элементами, созданными вашим приложением. Сюда входят элементы мультимедиа, выбранные с помощью API Picker и добавленные в библиотеку пользователя с помощью API библиотеки.	albums.create mediaItems.batchCreate	Оставшиеся объемы: photoslibrary.appendonly Области удалены: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Оставшиеся объемы: photoslibrary.readonly.appcreatedata Области удалены: photoslibrary photoslibrary.readonly
Эти методы больше не будут доступны.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Оставшиеся объемы: Никто Области удалены: photoslibrary.sharing Примечание. sharedAlbums.list удаляется, поскольку общие альбомы, созданные вашим приложением, больше не будут доступны для просмотра.
К этим методам будут добавлены photoslibrary.edit.appcreatedata . Эти методы теперь можно использовать только с альбомами и медиа-элементами, созданными вашим приложением. Сюда входят элементы мультимедиа, выбранные с помощью API Picker и добавленные в библиотеку пользователя с помощью API библиотеки.	albums.addEnrichment albums.batchAddMediaItems	Оставшиеся объемы: photoslibrary.appendonly photoslibrary.edit.appcreatedata Области удалены: photoslibrary
	albums.batchRemoveMediaItems	Оставшиеся объемы: photoslibrary.edit.appcreatedata Области удалены: photoslibrary
Эти методы останутся неизменными.	albums.patch mediaItems.patch	Оставшиеся объемы: photoslibrary.edit.appcreatedata Области удалены: Никто

Обновления политики API фотографий

Текущая политика допустимого использования будет заменена после 31 марта 2025 года новой Политикой пользовательских данных API фотографий и Политикой разработчиков . Новая политика уже доступна для предварительного просмотра.

Обновления документации API фотографий.

Мы внесли существенные изменения в документацию API фотографий, чтобы отразить предстоящие обновления и поддержать ваш опыт разработки:

• Сайт унифицированных API фотографий. Мы объединили все ресурсы API фотографий в одном удобном месте (на этом сайте), что упрощает работу разработчиков. Здесь вы найдете:
  • Централизованные ресурсы: объединенные инструкции по настройке и общие рекомендации по использованию , а также объединенная информация о поддержке и политике для API Picker и API библиотеки.
  • Выделенные сайты API: отдельные сайты с подробными руководствами, справочной документацией и примерами кода для API Picker и API библиотеки.
• Обновленное содержимое API библиотеки. Документация API библиотеки была пересмотрена, чтобы отразить ее возможности после периода прекращения поддержки. В обновленной документации вы найдете метки, выделяющие любой измененный или удаленный контент, а также ссылки на соответствующий устаревший контент для справки во время миграции.
• Сохраненная устаревшая документация: мы сохранили исходную документацию по API библиотеки для разработчиков, которым необходимо перенести существующие интеграции. Если вы начинаете новый проект, используйте обновленную документацию . Если вы обновляете существующий проект, при необходимости обращайтесь к устаревшей и обновленной документации во время миграции.

Часто задаваемые вопросы

Что изменится в API Google Фото?

Мы представляем новый API выбора фотографий Google для безопасного выбора фотографий и обновляем существующий API библиотеки, чтобы сосредоточиться на управлении фотографиями и видео, созданными вашим приложением.

Когда эти изменения вступят в силу?

Эти изменения вступят в силу 31 марта 2025 г. Мы рекомендуем всем, у кого есть существующие интеграции, использующие API библиотеки для выбора фотографий, как можно скорее перейти на API Picker.

Как это повлияет на API библиотеки?

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

Полный набор изменений вы можете просмотреть в таблице вверху этой страницы.

Что делать, если мое приложение в настоящее время использует затронутые области или методы?

Если ваше приложение использует какие-либо из затронутых областей или методов, мы рекомендуем вам предпринять следующие шаги:

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

Что такое API выбора Google Фото?

API Picker – это новый безопасный способ, с помощью которого разработчики могут позволить пользователям выбирать фотографии и альбомы из библиотеки Google Фото и легко отправлять их обратно в ваше приложение. API Picker предлагает надежные возможности выбора фотографий, включая выбор отдельных элементов, выбор всех элементов в альбоме и поиск в библиотеке Google Фото.

Где я могу найти дополнительную информацию об этих изменениях?

На этой странице, которую вы сейчас просматриваете, представлен обзор и сводка всех изменений.

Остальная документация на нашем сайте была обновлена ​​с учетом обновленных API.

Что делать, если у меня возникнут дополнительные вопросы или мне понадобится помощь в переносе моего приложения?

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