关于 Google Photos API

Google Photos API 让您能为 Google 相册应用打造丰富的照片和视频体验， 让您可以与数以亿计的 选择 Google 相册的用户。我们提供了两个强大的 API 来帮助您实现目标：

• Google Photos Picker API：为用户选择照片提供安全的方式 无缝集成 。
• Google Photos Library API：上传和管理应用的照片和影集 创建的所有操作Google 相册媒体库。

要开始使用，请启用一个或多个 API，并配置您的 app。

主要概念

媒体库：表示存储在用户 Google 相册账号中的媒体内容集合。

• Picker API 可让用户从自己的 库，与您的应用分享。
• 利用 Library API，您可以管理用户 这个库。

影集：这些是用户媒体库中的媒体内容集合， 可与其他用户共享。

• 利用 Library API，您可以创建和管理 影集。

媒体内容：包括照片、视频及其关联的元数据。

• Picker API：
  • Picker API 会返回 PickedMediaItem 对象 代表用户选择的媒体项。
  • 详细了解如何列出和检索媒体 项目。
• Library API：
  • Library API 适用于 MediaItem 对象 代表由您的应用上传或创建的媒体项。
  • 详细了解如何使用 Library API 处理媒体内容。

授权

与其他 Google REST API 一样，Google Photos API 也使用 OAuth 2.0 来处理授权。

注意 ：Google 相册 API 不支持服务账号。要使用这些 API 用户必须登录有效的 Google 账号。

使用 Google Photos API

在开始开发应用之前，请查看以下文档：

• Photos API 用户数据和开发者政策

  注意 ：新版 Photos API 用户数据和开发者政策将于以下日期生效： 2025 年 3 月 31 日取代现有的使用限制 政策。

• 用于设计应用的用户体验指南

• Google Photos API 的限制和配额

探索 API

您可以通过多种方式试用这些 API。

使用 API Explorer 中提供的 API Explorer 来试用 API， 请参阅参考文档。

• 尝试使用 Picker API 创建会话
• 尝试使用 Library API 创建影集

探索我们的代码示例，了解主要功能和使用场景。

• Picker API 示例
• Library API 示例

合作伙伴计划

您无需加入 合作伙伴计划但是，如果您的应用有可能超出常规 可用性配额限制，申请 在 Google 相册 合作伙伴计划。

了解详情

配置应用：设置项目 并试用示例。

指南：有关使用 Google Photos API 的方法指南和概念。

• Picker API 指南
• 库 API 指南

参考文档：API 参考文档

• Picker API 参考文档
• Library API 参考文档

支持：请求支持选项 提供帮助或提供反馈。