Library API 使用入门

利用 Library API，您可以与用户的 Google 相册媒体库中的照片、视频和影集互动，但有一个重要的焦点：您只能访问和管理由您的应用创建的内容。

前期准备

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

Library API 的关键用例

Library API 非常适合以下应用场景：

• 上传和存储媒体内容：将照片和视频（由您的应用生成）安全地导入用户的 Google 相册媒体库。
• 整理内容：创建和管理影集，以帮助用户整理与应用相关的媒体内容。
• 美化照片和影集：通过标题、说明或地理位置信息等丰富内容，为媒体内容和影集添加背景信息。
• 访问应用创建的数据：检索并与应用之前创建的照片、视频和影集互动。

典型的 Library API 工作流

虽然 Library 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 和影集 ID 列出特定应用创建的影集内的媒体内容。

后续步骤

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