Picker API 使用入门

借助 Picker API，您的用户可以安全地从 Google 相册媒体库中选择照片和视频，并与您的应用分享。

前期准备

• 查看概览： 比较 Picker API 和 Library API，确保 Picker API 适合您的使用场景。
• 配置应用：启用 API 并设置身份验证。如需了解详细步骤，请参阅配置应用。

选择器 API 流程

下面简要介绍了选择器 API 的运作方式：

1. 检查 OAuth 令牌：在开始 Picker API 流程之前，请检查用户是否拥有有效的 OAuth 2.0 访问令牌。如果没有令牌，请启动 OAuth 2.0 授权流程以获取令牌。

2. 创建会话：通过调用 Picker API 来创建新会话，从而启动该流程。此调用将返回唯一的 pickerUri。

3. 引导用户前往 Google 相册应用：向用户提供 pickerUri（以可点击的链接或二维码的形式）。此网址将安全地打开用户的 Google 相册应用。对于基于 Web 的应用，您可以在此 URI 中附加 /autoclose，以便在用户完成选择后自动关闭 Google 相册窗口。

4. 用户选择媒体内容：在 Google 相册应用中，用户可以浏览自己的媒体库，然后选择要与您的应用分享的照片和视频。请参阅用户选择体验的概览。

5. 轮询会话：应用应定期轮询会话以检查状态。您需要查找 mediaItemsSet 属性，该属性会返回 true，表示用户已完成选择。

   注意： 每次轮询会话时，响应都会包含用于配置轮询的建议间隔和超时时间。

6. 列出所选媒体项：一旦 mediaItemsSet 返回 true，您就可以使用列表方法来获取所选媒体项的详细信息。

7. 检索和使用媒体项：您现在可以访问所选的媒体项。您可以使用 baseUrl 提取其内容，并在应用中使用这些内容。

后续步骤

• 查看参考文档：详细了解 Picker API 参考文档，以了解所有可用的方法和参数。
• 试用示例：查看我们的示例，了解 Picker API 的实际运用，并为您的集成获取灵感。