Google Photos API 更新

发布时间：2024 年 9 月。

本页详细介绍了 Google 相册的哪些具体更改 API。查看此页面上的详细信息，了解这些方法和作用域 可能会受到影响您可以在发布商学院中 相关博文中的更改。

注意： 所有变更均于 2025 年 3 月生效。

Library API：对常见用例的影响

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

上传媒体内容和创建影集

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

可以采取的措施：

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

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

将发生的变化：现在您只能列出、搜索和检索相册以及 媒体内容。

可执行的操作：

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

分享和共享影集

具体变化：共享影集和相关的 API 函数（如分享、 取消共享、获取、加入、退出和列出），则会在返回 403 PERMISSION_DENIED 2025 年 3 月 31 日

可以采取的措施：

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

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

变更内容：photoslibrary.edit.appcreatedata正在添加到 以下三种方法可确保概念一致性：

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

可以采取的措施：

• 如果您的应用已在使用这些方法，请考虑采用 photoslibrary.edit.appcreatedata 范围，以简化授权 过程。

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

在对 Google Photos API 所做的更改中，我们做出了以下调整： 更新。

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

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

以下镜重将保留：

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

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

更新	方法	范围
这些方法现在只能用于应用创建的影集和媒体内容。这包括使用 Picker API 选择并通过 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.appcreatedata 已移除的范围： photoslibrary photoslibrary.readonly
这些方法将不再可用。	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	剩余范围： 无 移除的范围： photoslibrary.sharing 注意：系统即将移除 sharedAlbums.list，因为应用创建的共享影集将无法再用于列出。
这些方法将添加 photoslibrary.edit.appcreatedata。 这些方法现在只能用于应用创建的影集和媒体内容。这包括使用 Picker API 选择并通过 Library API 添加到用户的媒体库的媒体内容。	albums.addEnrichment albums.batchAddMediaItems	剩余范围： photoslibrary.appendonly photoslibrary.edit.appcreatedata 移除的范围： photoslibrary
	albums.batchRemoveMediaItems	剩余范围： photoslibrary.edit.appcreatedata 移除的范围： photoslibrary
这些方法保持不变。	albums.patch mediaItems.patch	剩余范围： photoslibrary.edit.appcreatedata 移除的范围： 无

Google 相册 API 政策更新

现行的使用限制政策将 改用新的 Photos API 用户数据和开发者 政策。新政策现已推出预览版。

Google 相册 API 文档更新

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

• 统一的相册 API 网站：我们整合了所有相册 API 资源 整合到一个方便的位置（本网站），从而简化了 打造卓越的体验您可以在此处找到：
  • 集中式资源：Picker API 和 Library API 的设置说明和常规使用指南以及支持和政策信息。
  • 专用 API 网站：提供 Picker 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 镜重将被移除。仅依赖于这些范围的 API 调用将返回 403 PERMISSION_DENIED。其他一些调用将被限制，只能处理您的应用创建的照片和视频。

您可以在此页面顶部的表格中查看整组更改。

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

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

• 对于照片选择：请迁移到 Google Photos Picker API。
• 对于其他功能：请查看更新后的 Library API 文档， 了解具体变化，并找出应用中可能不再使用的功能 可用。您可能需要调整应用的功能或探索 一些使用场景的替代解决方案。

什么是 Google Photos Picker API？

Picker API 为开发者提供了一种新的安全方式，可让用户选择照片 和相册，然后无缝地将其发回给 部署应用Picker API 提供了强大的照片选择功能， 包括选择个别内容、选择影集中的所有内容，以及 搜索 Google 相册媒体库。

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

您正在查看的此页面提供了 以及所有更改的摘要

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

这篇博文 宣布这些更改

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

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