Google Photos API 更新

发布时间：2024 年 9 月。

本页详细介绍了对 Google 相册 API 所做的具体更改。请查看本页中的详细信息，了解您使用的各项方法和范围可能受到哪些影响。如需详细了解这些变更的公告，请参阅相关博文。

注意： 所有更改将于 2025 年 3 月生效。

Library API：对常见用例的影响

以下部分详细介绍了即将发生的变更对常见用例有何影响。

上传媒体内容和创建影集

具体变化：没有变化。您可以继续使用 photoslibrary.appendonly 范围上传媒体内容和创建影集。

可执行的操作：

如果您的应用要上传媒体内容或创建影集，请务必使用 photoslibrary.appendonly 范围，而不是 photoslibrary 范围。photoslibrary 作用域将被移除。

列出、搜索和检索媒体内容和影集

变更内容：您现在只能列出、搜索和检索应用创建的影集和媒体内容。

可执行的操作：

• 如果您的应用需要用户从整个媒体库中选择照片或相册，请使用新的 Google 相册选择器 API。这样，用户就可以以安全且人性化的方式授予对特定内容的访问权限。
• 如果您的应用依赖于访问用户的整个媒体库，您可能需要重新评估应用或考虑其他方法。

分享和共享影集

变更内容：2025 年 3 月 31 日之后，共享影集和关联的 API 函数（共享、取消共享、获取、加入、退出和列出）将返回 403 PERMISSION_DENIED。

可执行的操作：

将用户定向至 Google 相册应用，以便他们自行管理分享设置。您可以在应用中提供明确的说明或深层链接，以便引导用户。

管理应用创建的影集：丰富内容和影集内容

变更内容：为了保持概念一致性，我们将 photoslibrary.edit.appcreateddata 添加到了以下三个方法中：

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

可执行的操作：

• 如果您的应用已在使用这些方法，请考虑采用 photoslibrary.edit.appcreateddata 作用域来简化授权流程。

Library API：受影响的镜重范围和方法

在对 Google 相册 API 进行更改的过程中，我们进行了以下更新。

如更新后的“授权”页面所示，2025 年 3 月 31 日之后，Library API 将移除以下镜重范围：

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

以下镜重将保留：

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

下表详细介绍了受影响的特定 Library API 方法和作用域。

更新	方法	范围
这些方法现在只能用于应用创建的影集和媒体内容。	albums.create mediaItems.batchCreate	剩余的镜重： photoslibrary.appendonly 已移除的范围： photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	剩余镜重： photoslibrary.readonly.appcreateddata 已移除的范围： photoslibrary photoslibrary.readonly
这些方法将不再可用。	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	剩余镜重： 无 已移除的范围： photoslibrary.sharing 注意：由于您的应用创建的共享影集将不再可供列出，因此我们将移除 sharedAlbums.list。
这些方法将添加 photoslibrary.edit.appcreateddata。 这些方法现在只能用于应用创建的影集和媒体内容。	albums.addEnrichment albums.batchAddMediaItems	剩余镜重： photoslibrary.appendonly photoslibrary.edit.appcreateddata 已移除的范围： photoslibrary
	albums.batchRemoveMediaItems	剩余镜重： photoslibrary.edit.appcreateddata 已移除的范围： photoslibrary
这些方法将保持不变。	albums.patch mediaItems.patch	剩余镜重： photoslibrary.edit.appcreateddata 已移除的范围： 无

Photos API 政策更新

现行的使用限制政策将于 2025 年 3 月 31 日之后替换为新的 Photos API User Data and Developer Policy。新政策现已推出预览版。

更新了 Google 相册 API 文档

我们对 Photos API 文档进行了重大更改，以反映即将推出的更新并为您的开发体验提供支持：

• 统一的 Google 相册 API 网站：我们已将所有 Google 相册 API 资源整合到一个位置（本网站），为开发者提供简化版体验。您可以在此处找到：
  • 集中式资源：Picker API 和 Library API 的设置说明和常规使用指南以及支持和政策信息。
  • 专用 API 网站：提供 Picker API 和 Library API 的详细指南、参考文档和代码示例的各个网站
• 更新了 Library API 内容：Library API 文档已修订，以反映 Library API 在弃用期结束后提供的功能。
• 保留了旧版文档：我们保留了原始的 Library API 文档，以便需要迁移现有集成的开发者参考。如果您要开始一个新项目，请使用更新后的文档。如果您要更新现有项目，请在迁移过程中根据需要同时参考旧版和更新后的文档。

常见问题解答

Google 相册 API 有何变化？

我们将推出新的 Google Photos Picker API 以实现安全的照片选择，并更新现有的 Library API，以便专注于管理您的应用创建的照片和视频。

这些变更何时生效？

这些变更将于 2025 年 3 月 31 日生效。我们建议所有现有集成都使用 Library API 进行照片选择，并尽快迁移到 Picker API。

Library API 会受到怎样的影响？

photoslibrary.readonly、photoslibrary.sharing 和 photoslibrary 镜重将被移除。2025 年 3 月 31 日之后，仅依赖于这些镜的 API 调用将返回 403 PERMISSION_DENIED。其他一些调用将仅限于处理您的应用创建的照片和视频。

您可以在本页面上的受影响的范围和方法表格中查看完整的更改内容。

如果我的应用目前使用受影响的范围或方法，该怎么办？

如果您的应用使用了任何受影响的范围或方法，我们建议您采取以下措施：

• 对于照片选择：请迁移到 Google 相册 Picker API。
• 对于其他功能：请查看更新后的库 API 文档，了解相关变更并确定应用中可能不再可用的功能。对于某些用例，您可能需要调整应用的功能或探索替代解决方案。

什么是 Google Photos Picker API？

Picker API 是一种安全的新方式，可让开发者让用户从 Google 相册库中选择照片和视频，并将其无缝发送回您的应用。

在哪里可以详细了解这些变更？

您当前查看的此页面简要介绍了所有变更。

我们网站上的其余文档已更新，以反映更新后的 API。

这篇博文宣布了相关变更。

如果我还有其他问题或需要应用迁移方面的帮助，该怎么办？

如果您对开发者文档有疑问，请访问我们的支持页面，详细了解如何获取帮助。