本文档介绍了 Google Picker 和 Google Picker API,还可帮助您确定哪种方法最适合您的应用。
Google 选择器提供了一个精美的“打开文件”对话框,用于选择 Google 云端硬盘中存储的信息。借助它,用户无需离开您的应用,即可从其云端硬盘账号中选择或上传照片、视频和文档。
Google Picker API 是一种技术接口,用于在您的应用中实现 Google Picker。通过使用 Google Picker API,您可以创建一个熟悉的界面,该界面可处理身份验证和文件浏览的复杂性,并在用户做出选择后将特定的文件元数据(例如 ID 和网址)返回给您的应用。
关键使用场景
Google 选择器用途广泛,可根据各种应用工作流进行定制:
- 文件上传替代方案:用户可以直接通过 Google 选择器将文件上传到云端硬盘。
- 协作工具:允许用户将特定的 Google 文档或 Google 表格与项目管理任务或共享日历活动相关联。
- 附加素材资源:使用 Google 选择器让用户将云端硬盘中的支持文档附加到费用报告或支持服务工单。
Web 应用与桌面应用和移动应用的比较
虽然核心功能保持不变,但 Google Picker API 的实现因应用运行的位置而异。下表列出了在为 Web 应用与桌面应用和移动应用实现时,技术和功能方面的差异。
| 功能 | Web 应用 | 桌面应用和移动应用 |
|---|---|---|
| 主要技术 | 客户端 JavaScript 库。 | OAuth 2.0 网址参数和 HTTP 重定向。 |
| 渲染 | 集成到应用的现有界面布局中。 | 在用户默认系统浏览器的新标签页中打开。无法再在嵌入式 WebView 中显示。 |
| 身份验证流程 | 需要通过 setOAuthToken 传递特定的访问令牌。 |
通过向 OAuth 请求添加 trigger_onepick=true 来触发。 |
| 响应方法 | 直接 JavaScript 回调。 | 重定向 URI 或自定义网址架构。 |
| 范围 | 灵活;可以使用 drive.file、drive.readonly 等。 |
严格;仅允许使用 drive.file,且不能与其他范围结合使用。 |
| 配置 | 使用 JavaScript 中的 PickerBuilder 流畅接口。 |
在授权网址中使用查询字符串参数。 |
请注意,如需使用 drive.file 范围,用户必须在访问 Google 选择器时处于登录状态。
关键的战略差异如下:
- Web 应用专为高互动性和深度自定义而设计(例如,按文件类型显示特定视图,以及将视图限制为特定云端硬盘文件夹)。
- 桌面应用和移动应用在设计上注重安全性和简洁性,利用系统浏览器以单一的统一流程处理身份验证和文件选择。