В этом документе представлено описание инструмента Google Picker и API Google Picker. Он также поможет вам решить, какой подход лучше всего подходит для вашего приложения.
Инструмент Google Picker предоставляет удобное диалоговое окно «Открыть файл» для информации, хранящейся в Google Drive. Это позволяет пользователям выбирать или загружать фотографии, видео и документы из своей учетной записи Drive, не покидая ваше приложение.
API Google Picker — это технический интерфейс, используемый для реализации Google Picker в вашем приложении. Используя API Google Picker, вы создаете привычный интерфейс, который обрабатывает сложные процессы аутентификации и просмотра файлов, возвращая вашему приложению определенные метаданные файла (такие как идентификаторы и URL-адреса) после того, как пользователь сделает выбор.
Ключевые варианты использования
Инструмент Google Picker универсален и может быть адаптирован к различным рабочим процессам приложений:
- Альтернативный способ загрузки файлов : пользователи могут загрузить файл в Google Диск напрямую через Google Picker.
- Инструменты для совместной работы : позволяют пользователям связывать определенные документы Google Docs или Google Sheets с задачами управления проектами или событиями общего календаря.
- Прикрепление документов : Используйте инструмент Google Picker, чтобы пользователи могли прикреплять подтверждающие документы из Google Диска к отчету о расходах или заявке в службу поддержки.
Сравнение веб-приложений с приложениями для настольных компьютеров и мобильных устройств.
Хотя основная функциональность остается неизменной, реализация API Google Picker различается в зависимости от того, где работает ваше приложение. В следующей сравнительной таблице перечислены технические и функциональные различия при реализации для веб-приложений, а также для настольных и мобильных приложений.
| Особенность | Веб-приложения | Приложения для настольных компьютеров и мобильных устройств |
|---|---|---|
| Первичная технология | Клиентская JavaScript-библиотека. | Параметры URL-адресов OAuth 2.0 и HTTP-перенаправления. |
| Визуализация | Интегрируется в существующий пользовательский интерфейс приложения. | Открывается в новой вкладке системного браузера пользователя. Больше не может отображаться во встроенном веб-представлении. |
| Поток аутентификации | Для работы требуется специальный токен доступа, передаваемый через setOAuthToken . | Запускается добавлением trigger_onepick=true к запросу OAuth. |
| метод ответа | Прямые вызовы JavaScript. | URI перенаправления или пользовательские схемы URL. |
| Области применения | Гибкий функционал; можно использовать drive.file , drive.readonly и т.д. | Строгое правило: разрешены только drive.file , которые нельзя комбинировать с другими областями видимости. |
| Конфигурация | Использует гибкий интерфейс PickerBuilder в JavaScript. | Использует параметры строки запроса в URL-адресе авторизации. |
Обратите внимание, что для использования области действия drive.file пользователь должен быть авторизован при доступе к Google Picker.
Ключевые стратегические различия заключаются в следующем:
- Веб-приложения разработаны для высокой интерактивности и глубокой настройки (например, отображение информации в зависимости от типа файла или ограничение доступа к определенным папкам Google Диска).
- Настольные и мобильные приложения разработаны с учетом безопасности и простоты использования, применяя системный браузер для обработки аутентификации и выбора файлов в едином, унифицированном процессе.
Связанные темы
- Интегрируйте Google Picker в веб-приложения.
- Интегрируйте Google Picker в настольные и мобильные приложения.
- Выберите области действия API Google Drive.