版本说明

订阅以下版本说明。

只要有新的 Google 相册 API 发布，本页面即会随之更新。更新日志会按日期顺序列出各个版本，并包含所有新功能、问题修复和其他更改。

文档和指南均指向要使用的最新版本。

2025 年 4 月 1 日

备注

此版本实现了之前对 Google 相册 API 所做的变更。

• 从 Library API 中移除了一些镜重。
• 限制了多种方法，使其仅适用于应用创建的内容。
• 新的 《Photos API User Data and Developer Policy》（Google 相册 API 用户数据和开发者政策）已生效，取代了旧的“可接受的使用政策”。

如需了解完整详情，请参阅 Google 相册 API 更新。

2024 年 9 月 16 日

功能

• 引入了新的 Picker API，以实现安全且人性化的照片选择。

备注

在本版本中，我们宣布了对 Library API 做出的重大变更（自 2025 年 3 月 31 日起生效）。

• Library API 只会管理您的应用创建的照片和视频。
• 移除了 photoslibrary.readonly、photoslibrary.sharing 和 photoslibrary 作用域。
• 将多种方法仅限于应用创建的内容。

如需了解完整详情，请参阅 Google 相册 API 更新页面。

2022 年 10 月 27 日

备注

• “使用 Google 相册和 Flutter 构建照片分享应用”Codelab 已不再提供。查看我们的其他示例，并参阅我们的指南中的示例代码。

2022 年 6 月 1 日

备注

• 添加了上传最佳实践，以帮助阐明上传流程、指出常见错误及其避免方法，并提供有关提高上传效率的提示。

2021 年 10 月 27 日

功能

• Google 相册合作伙伴计划：推出高级层级。 高级层级是一套增强型 API 功能，可利用 Google 相册强大的机器智能。

2021 年 9 月 29 日

功能

• 新增了按日期过滤条件对搜索结果进行排序的选项。结果可以按时间由新到旧或由旧到新排序。 这样一来，系统便可提供更具针对性的搜索结果，让用户更轻松地进行搜索并提高效率。

2021 年 7 月 21 日

功能

• 新增了视频基准网址的 -no 参数，用于加载不带播放按钮叠加层的缩略图。默认情况下，视频缩略图会带有播放按钮叠加层。借助这个新参数，您可以控制是否隐藏视频缩略图上的播放按钮。

已解决的问题

• 问题 181282432：视频缩略图始终显示播放按钮叠加层。

2021 年 5 月 25 日

已解决的问题

• 未针对媒体内容中的 photo 元数据填充 exposureTime 属性。

2021 年 5 月 19 日

备注

• 动态照片的基础网址文档已更新，以阐明 Android 动态照片和 iOS 动态照片的 =dv 参数的行为。

2021 年 2 月 11 日

备注

• 使用限制政策已更新，新增了有关广告和尽量减少数据使用的内容。

2020 年 7 月 7 日

功能

• 该 API 已更新，以支持 Google 相册中的新分享控件。现在，系统会在共享影集的 shareInfo 属性中返回一个新字段 isJoinable。当 isJoinable 为 true 时，该 API 可以将用户加入共享影集。如果所有者已在 Google 相册中停用影集的链接分享功能，isJoinable 将为 false，并且该 API 将无法将用户加入该影集。
• 问题 111405623、116379853、117685011：您现在可以更改专辑名称和封面照片，以及更改您的应用创建的媒体内容的说明。请求新的 photoslibrary.edit.appcreateddata 授权范围以获取更新权限。

2020 年 2 月 17 日

功能

• 照片的上传文件大小上限已从 75 MB 提高到 200 MB。
• 现在，在上传文件时，必须在字节上传阶段指定 MIME 类型。
• 现在，您可以在创建媒体内容时指定文件名，而不是在上传媒体字节时指定文件名。simpleMediaItem 中的新 fileName 属性支持 UTF-8 字符串。您仍然可以在上传媒体字节时指定媒体内容的文件名，但我们强烈建议您更新实现方式。

备注

• 使用限制政策已更新，其中新增了一些详细信息，重点介绍了如何尽量减少数据使用和存储。
• 基础网址文档已更新，以添加动态照片。

2019 年 8 月 16 日

功能

• 问题 131874809：在 shareInfo 中新增了 isOwned 属性，用于确定用户是否为共享影集的所有者。如需了解详情，请参阅分享媒体开发者指南。

已解决的问题

• 问题 131711405：albums.list 响应中缺少 shareableUrl 属性。
• 问题 113870729：mediaItems.list 有时会在页面边界返回重复的媒体内容。
• 问题 93428763：视频元数据的 status 字段现可正确返回可用最高画质视频的 VideoProcessingStatus。

2019 年 6 月 12 日

功能

• 问题 110188560：新增搜索过滤器 FeatureFilter，用于选择已标记为“收藏”的媒体内容。
• ContentFilter 的新内容类别，用于过滤与特定类别匹配的媒体内容：ARTS、CRAFTS、FASHION、HOUSES、GARDENS、FLOWERS、HOLIDAYS。

备注

• 更新了用户体验指南，为项目和影集命名提供了更多指导。

2019 年 5 月 7 日

Codelab

• 全新 Codelab：使用 Google 相册和 Flutter 构建照片分享应用。 了解如何在 Flutter 中使用 Google Photos Library API 构建照片分享应用。如需了解详情，请参阅示例指南。

2019 年 4 月 29 日

功能

• 问题 109505022：新增调用，用于向影集添加媒体内容，以及移除影集中的现有媒体内容：

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  这些调用支持应用所创建的媒体内容和影集。有关详情，请参阅管理影集开发者指南。

• 用于创建媒体内容的 REST 调用 mediaItems.batchCreate 现在会在无法创建某些媒体内容时返回 HTTP 状态 207 MULTI-STATUS，表示部分内容创建成功。如需了解详情，请参阅上传媒体开发者指南。

备注

• 客户端库的最新版本新增一项重大变化。与 MediaItem、Album 和 DateRange 相关的类已移至全新专用软件包。这些类的功能仍保持不变，发生变化的只有其在客户端库中的位置。详情请参阅 Java 客户端库 (1.2.0) 和 PHP 客户端库 (1.2.0) 的版本说明。

2019 年 2 月 14 日

备注

• 为通过基准网址访问媒体字节应用新配额限制。您可以在 Google API 控制台中监控此配额。

已解决的问题

• 问题 124355983：为部分共享媒体内容调用 mediaItems.get 时出现 500 错误。

2019 年 1 月 21 日

已解决的问题

• 问题 121998358：albums.create 响应中缺少 isWriteable 属性。

2019 年 1 月 7 日

已解决的问题

• 问题 118464845：mediaItems.list 返回过多空白页面。
• 问题 111714379：mediaItems.search 返回的 pageSize 数量只有一半。

2018 年 11 月 30 日

功能

• 新增调用 mediaItems.batchGet，用于按标识符获取多项媒体内容。
• 问题 111279349：新增调用 sharedAlbums.leave，用于退出已加入的影集。
• 问题 111279347：新增调用 albums.unshare，用于将共享影集标记为不公开。

已解决的问题

• 问题 113978705：在 mediaItems.batchCreate 中设置的说明转换为 HTML 实体。
• 问题 114462217：无法在 mediaItems.batchCreate 中为视频文件设置文件名。
• 问题 118475587：为媒体内容返回无效的产品网址。
• 问题 111862704：访问基准网址时出现 403 错误。
• 问题 115932469：因出现配额错误而上传失败。

2018 年 9 月 6 日

功能

• 现支持 Java 和 PHP 客户端库。

备注

• Google Photos Library API 已正式发布。感谢您在 Library API 开发者预览阶段提供反馈和功能请求。
• 开始使用 Java 和 PHP 客户端库时，请查看全新指南。
• 我们已在指南中添加 Java 和 PHP 示例代码段，以便演示客户端库的用法。

2018 年 9 月 5 日

功能

• 新增了使用 shareToken 获取影集的 sharedAlbums.get 调用。
• 在 shareInfo 中新增了 isJoined 属性，用于确定用户是否已加入共享影集。

已解决的问题

• 问题 79321120：对视频媒体内容的 mediaItems.batchCreate 响应中缺少 mimeType 属性。
• 问题 79319272：mediaItems.batchCreate 响应中缺少 mediaMetadata、contributorInfo 等属性。
• 问题 110237685：修复了与 CORS 相关的文件上传问题。
• 问题 79318118：在 mediaItems.batchCreate 调用中将多项内容上传到影集时，未保持顺序一致。

备注

• 如果您在 2018 年 9 月 5 日前存储了 ID（例如影集、媒体内容或丰富内容的 ID），则其会因格式发生更改而失效。您需要获取新 ID，以便在您的应用中使用。
• 影集资源的 totalMediaItems 属性已重命名为 mediaItemsCount。
• 在 mediaItems.list 和 mediaItems.search 调用中，pageSize 参数的最大值已更改为 100。未指定 pageSize 参数时，返回的默认媒体内容数量已更改为 25。
• 更新了列出媒体库内容、分享媒体和访问媒体内容指南，在其中添加了2018 年 7 月 31 日发布的excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created)过滤条件功能。

2018 年 7 月 31 日

功能

• 新增调用 mediaItems.list，用于列出媒体内容。
• 新增过滤器 excludeNonAppCreatedData，用于搜索由应用创建的内容或列表影集。
• 新增了用于访问图片的参数：
  • 问题 79871479：c 剪裁参数，用于将图片剪裁为精确尺寸。
  • 问题 110343547、问题 111228390：d 下载参数，用于下载原始图片。
• sharedAlbums.join 调用现在会返回影集。
• 问题 109655786：album 现在包含封面照片的媒体内容 ID coverPhotoMediaItemId。
• 问题 79656863：mediaItem 现在包含媒体内容的文件名 filename。

已解决的问题

• 问题 79757390：上传请求期间未设置文件名。请参阅上传媒体指南中的 X-Goog-Upload-File-Namefile 和 X-Goog-Upload-Protocol 字段。
• 问题 80182372：断点续传返回错误。有关最新协议，请参阅全新断点续传指南。
• 问题 79497397：albums.list 响应中缺少 isWriteable 属性。
• 问题 111143493：PEOPLE 内容类别过滤器返回不准确的结果。
• 问题 111056278：BIRTHDAYS 内容类别过滤器返回错误。

预览版 - 2018 年 5 月 8 日

Library API 的初始版本。

已知问题

• 如果收到的媒体内容 id 属于共享影集的媒体内容且非用户所有，则 GET mediaItem 会抛出错误。
• batchCreate 调用的响应不会返回 mediaMetadata 或 contributorInfo。
• 如果媒体内容是视频，则 batchCreate 调用不返回 mimeType。
• 上传多项内容时，batchCreate 中的顺序未保持一致。
• 当作为共享影集的所有者在该影集中创建媒体内容时，batchCreate 不支持排序（在 position 中添加）。默认创建在影集的末尾。