Начало работы с API библиотеки

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

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

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

Ключевые варианты использования Library API

API библиотеки идеально подходит для сценариев, когда вашему приложению необходимо:

• Загружайте и храните медиафайлы. Безопасно импортируйте фотографии и видео (созданные вашим приложением) в библиотеки Google Фото ваших пользователей.
• Упорядочивайте контент: создавайте альбомы и управляйте ими, чтобы помочь пользователям систематизировать медиафайлы, связанные с приложениями.
• Улучшайте фотографии и альбомы: добавляйте контекст к медиа-элементам и альбомам с помощью таких дополнений, как заголовки, описания или информация о местоположении.
• Доступ к данным, созданным приложением. Получайте фотографии, видео и альбомы, созданные ранее вашим приложением, и взаимодействуйте с ними.

Типичный рабочий процесс API библиотеки

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

1. Загрузка мультимедиа. Используйте конечную точку загрузки для безопасной загрузки фотографий или видео в Google Фото. На этом этапе генерируется uploadToken .

2. Создание элементов мультимедиа. Используйте метод mediaItems.batchCreate , предоставляющий uploadToken , для создания элементов мультимедиа в библиотеке пользователя.

3. Создание альбомов (необязательно): используйте метод albums.create для создания альбомов в библиотеке пользователя для организации элементов мультимедиа.

4. Управление альбомами:

   • Добавьте элементы мультимедиа (созданные вашим приложением) в альбомы с помощью albums.batchAddMediaItems .
   • Удалите медиа-элементы из альбомов с помощью albums.batchRemoveMediaItems .
   • Добавьте дополнения к альбомам (например, названия или местоположения) с помощью albums.addEnrichment .
   • Получите информацию о конкретных альбомах с помощью albums.get .
   • Перечислите альбомы, созданные вашим приложением, с помощью albums.list .

5. Доступ к медиафайлам, созданным в приложении:

   • Получите сведения о конкретных элементах мультимедиа с помощью mediaItems.get или mediaItems.batchGet .
   • Найдите элементы мультимедиа, созданные вашим приложением, с помощью mediaItems.search .
   • Перечислите элементы мультимедиа в определенном альбоме, созданном приложением, используя mediaItems.search с идентификатором альбома.

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

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