Google 选择器概览

本文介绍了 Google Picker 和 Google Picker API，并帮助您确定哪种方法最适合您的应用。

Google Picker 提供了一个精美的“打开文件”对话框，用于显示存储在 Google 云端硬盘中的信息。用户无需离开您的应用，即可通过该对话框从其云端硬盘账号中选择或上传照片、视频和文档。

Google Picker API 是用于在您的应用中实现 Google Picker 的技术接口。通过使用 Google Picker API，您可以创建一个熟悉的界面，该界面可处理身份验证和文件浏览的复杂性，并在用户做出选择后将特定文件元数据（例如 ID 和网址）返回给您的应用。

关键使用场景

Google Picker 用途广泛，可以根据各种应用工作流进行定制：

  • 文件上传替代方案：用户可以直接通过 Google Picker 将文件上传到云端硬盘。
  • 协作工具：让用户能够将特定的 Google 文档或 Google 表格链接到项目管理任务或共享日历活动。
  • 素材资源附件：用户可以使用 Google Picker 将云端硬盘中的支持文档附加到费用报告或支持工单。

Web 应用与桌面应用和移动应用对比

虽然核心功能保持一致，但 Google Picker API 的实现方式因应用的运行位置而异。下表列出了为 Web 应用与桌面应用和移动应用实现时，在技术和功能方面的差异。

功能 Web 应用 桌面应用和移动应用
主要技术 客户端 JavaScript 库。 OAuth 2.0 网址参数和 HTTP 重定向。
渲染 集成到应用的现有界面布局中。 在用户默认系统浏览器的新标签页中打开。无法再在嵌入式 WebView 中显示。
身份验证流程 需要通过 setOAuthToken 传递特定的访问令牌。 通过将 trigger_onepick=true 添加到 OAuth 请求来触发。
响应方法 直接 JavaScript 回调。 重定向 URI 或自定义网址架构。
范围 灵活；可以使用 drive.file、drive.readonly 等。 严格；仅允许使用 drive.file，且不能与其他范围组合使用。
配置 在 JavaScript 中使用 PickerBuilder 流畅接口。 在授权网址中使用查询字符串参数。

请注意，如需使用 drive.file 范围，用户必须在访问 Google Picker 时登录。

主要战略差异如下：

  • Web 应用专为高互动性和深度自定义而设计（例如，按文件类型显示特定视图，并将视图限制为特定云端硬盘文件夹）。
  • 桌面应用和移动应用专为安全性和简洁性而设计，利用系统浏览器在单个统一流程中处理身份验证和文件选择。