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

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

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

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

Поток API Picker

Ниже представлен обзор работы API Picker:

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

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

  3. Направьте пользователей в приложение Google Фото: предоставьте пользователям pickerUri (в виде кликабельной ссылки или QR-кода). Этот URL-адрес безопасно откроет приложение Google Фото. Для веб-приложений можно добавить /autoclose к этому URI, чтобы автоматически закрыть окно Google Фото после того, как пользователь завершит выбор.

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

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

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

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

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

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