Опубликовано в сентябре 2024 г.
На этой странице представлена подробная информация о конкретных изменениях, внесенных в API Google Фото. Ознакомьтесь с подробностями на этой странице, чтобы понять, как это может повлиять на используемые вами методы и области действия. Подробнее об объявлении об этих изменениях можно прочитать в соответствующем сообщении в блоге .
Библиотечный 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 библиотеки, на которые они влияют.
| Обновления | Методы | Области применения |
|---|---|---|
| Эти методы теперь можно использовать только с альбомами и медиа-элементами, созданными вашим приложением. | Оставшиеся объемы:
| |
Оставшиеся объемы:
| ||
| Эти методы больше не будут доступны. | Оставшиеся объемы:
| |
К этим методам будут добавлены данные photoslibrary.edit.appcreatedata .Эти методы теперь можно использовать только с альбомами и медиа-элементами, созданными вашим приложением. | Оставшиеся объемы:
| |
Оставшиеся объемы:
| ||
| Эти методы останутся неизменными. | Оставшиеся объемы:
|
Обновления политики API фотографий
Текущая политика допустимого использования будет заменена после 31 марта 2025 года новой Политикой пользовательских данных API фотографий и Политикой разработчиков . Новая политика уже доступна для предварительного просмотра.
Обновления документации API фотографий.
Мы внесли существенные изменения в документацию API фотографий, чтобы отразить предстоящие обновления и поддержать ваш опыт разработки:
- Сайт унифицированных API фотографий. Мы объединили все ресурсы API фотографий в одном месте (на этом сайте), упрощая работу разработчиков. Здесь вы найдете:
- Централизованные ресурсы: объединенные инструкции по настройке и общие рекомендации по использованию , а также объединенная информация о поддержке и политике для API Picker и API библиотеки.
- Выделенные сайты API: отдельные сайты с подробными руководствами, справочной документацией и примерами кода для API Picker и API библиотеки.
- Обновленное содержимое Library API: документация Library API была пересмотрена, чтобы отразить возможности Library API после периода прекращения действия.
- Сохраненная устаревшая документация. Мы сохранили исходную документацию по API библиотеки для разработчиков, которым необходимо перенести существующие интеграции. Если вы начинаете новый проект, используйте обновленную документацию . Если вы обновляете существующий проект, при необходимости обращайтесь к устаревшей и обновленной документации во время миграции.
Часто задаваемые вопросы
Что изменится в API Google Фото?
Мы представляем новый API выбора Google Фото для безопасного выбора фотографий и обновляем существующий API библиотеки, чтобы сосредоточиться на управлении фотографиями и видео, созданными вашим приложением.
Когда эти изменения вступят в силу?
Эти изменения вступят в силу 31 марта 2025 г. Мы рекомендуем всем, у кого есть существующие интеграции, использующие API библиотеки для выбора фотографий, как можно скорее перейти на API Picker.
Как это повлияет на API библиотеки?
Области photoslibrary.readonly , photoslibrary.sharing и photoslibrary будут удалены. Вызовы API, основанные только на этих областях, будут возвращать код 403 PERMISSION_DENIED после 31 марта 2025 г. Некоторые другие вызовы будут ограничены работой только с фотографиями и видео, созданными вашим приложением.
Полный набор изменений можно просмотреть в таблице затронутых областей и методов на этой странице .
Что делать, если мое приложение в настоящее время использует затронутые области или методы?
Если ваше приложение использует какую-либо из затронутых областей или методов, мы рекомендуем вам предпринять следующие шаги:
- Для выбора фотографий: перейдите на API выбора Google Фото.
- Что касается других функций: просмотрите обновленную документацию по API библиотеки, чтобы понять изменения и определить функции вашего приложения, которые могут быть больше недоступны. Возможно, вам придется настроить функциональность вашего приложения или изучить альтернативные решения для некоторых случаев использования.
Что такое API выбора Google Фото?
API Picker – это новый безопасный способ, с помощью которого разработчики могут позволить пользователям выбирать фотографии и видео из библиотеки Google Фото и беспрепятственно отправлять их обратно в ваше приложение.
Где я могу найти дополнительную информацию об этих изменениях?
На этой странице, которую вы сейчас просматриваете, представлен обзор и краткое изложение всех изменений.
Остальная документация на нашем сайте была обновлена с учетом обновленных API.
Эта запись в блоге объявляет об изменениях.
Что делать, если у меня возникнут дополнительные вопросы или мне понадобится помощь в переносе моего приложения?
Если у вас есть вопросы по документации для разработчиков, посетите нашу страницу поддержки , чтобы получить дополнительную информацию о получении помощи.