Начало работы с API Picker

API Picker предоставляет вашим пользователям безопасный способ выбирать фотографии и видео из библиотеки Google Фото и делиться ими с вашим приложением.

Прежде чем начать

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

Процесс API Picker

Вот обзор того, как работает API Picker:

1. Проверьте наличие токена OAuth. Прежде чем запускать поток API Picker, проверьте наличие действующего токена доступа OAuth 2.0 для пользователя. Если токена нет, инициируйте поток авторизации OAuth 2.0, чтобы получить его.

2. Создайте сеанс. Запустите процесс, выполнив вызов API Picker для создания нового сеанса . Этот вызов вернет уникальный pickerUri .

3. Направляйте пользователей в приложение Google Фото. Предоставьте пользователям pickerUri (в виде интерактивной ссылки или QR-кода). Этот URL позволит безопасно открыть приложение Google Photos.

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

5. Опрос сеанса. Ваше приложение должно периодически опрашивать сеанс, чтобы проверить статус. Вам нужно, чтобы свойство mediaItemsSet возвращало значение true, указывая на то, что пользователь завершил свой выбор.

   Примечание. Каждый раз, когда вы опрашиваете сеанс, в ответе указаны рекомендуемые интервалы и тайм-ауты для настройки опроса.

6. Список выбранных элементов мультимедиа: как только mediaItemsSet вернет true, вы можете использовать метод list , чтобы получить подробную информацию о выбранных элементах мультимедиа.

7. Извлечение и использование элементов мультимедиа. Теперь у вас есть доступ к выбранным элементам мультимедиа. Вы можете получить их контент , используя baseUrl , и использовать его в своем приложении.

Следующие шаги

• Просмотрите справочную документацию: изучите подробную справочную документацию по API Picker, чтобы узнать обо всех доступных методах и параметрах.
• Опробуйте образцы. Ознакомьтесь с нашим примером , чтобы увидеть API Picker в действии и получить вдохновение для интеграции.