版本说明

订阅以下版本说明。

每次发布新版本的 Google Photos Library API，此页面都会更新。更新日志 按日期列出各发行版本，并包括所有新功能、问题修复 更改。

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

2024 年 9 月 16 日

功能

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

备注

在此版本中，我们宣布了对 Library API 的主要更改 （自 2025 年 3 月 31 日起生效）。

• Library API 将仅管理您的应用创建的照片和视频。
• 移除了 photoslibrary.readonly、photoslibrary.sharing 和 photoslibrary 范围。
• 将多种方法限制为仅适用于应用创建的内容。

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

2022 年 10 月 27 日

备注

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

2022 年 6 月 1 日

备注

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

2021 年 10 月 27 日

功能

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

2021 年 9 月 29 日

功能

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

2021 年 7 月 21 日

功能

• 新增了 -no 视频基准网址参数 以便加载没有播放按钮叠加层的缩略图。默认视频 并带有播放按钮叠加层。这个新参数可让您 控件，用于隐藏视频缩略图上的播放按钮。

“Resolved”类别的问题

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

2021 年 5 月 25 日

“Resolved”类别的问题

• 未针对以下条件填充 exposureTime 属性： photo 元数据 。

2021 年 5 月 19 日

备注

• 有关运动的基准网址文档 张照片 进行了更新，以阐明 Android 动作的 =dv 参数的行为 和 iOS Live Photos 功能。

2021 年 2 月 11 日

备注

• 使用限制政策已 更新，添加与广告相关的内容，并最大限度地减少数据使用。

2020 年 7 月 7 日

功能

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

2020 年 2 月 17 日

功能

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

备注

• 使用限制政策已 进行了更新，还添加了一些侧重于最大限度地减少数据使用和存储的额外细节。
• 基准网址 文档 已更新为包含动态照片。

2019 年 8 月 16 日

功能

• 问题 131874809：新媒体资源 “shareInfo”中的isOwned 来标识用户是否为共享影集的所有者。更多详情请参阅 可在 媒体 开发者指南。

“Resolved”类别的问题

• 问题 131711405：shareableUrl 属性原为 albums.list中缺少的 响应。
• 问题 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 控制台中监控此配额。

“Resolved”类别的问题

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

2019 年 1 月 21 日

“Resolved”类别的问题

• 问题 121998358：isWriteable 属性原为 缺失的 albums.create 响应。

2019 年 1 月 7 日

“Resolved”类别的问题

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

2018 年 11 月 30 日

功能

• 发起新通话 mediaItems.batchGet 来根据标识符检索多个媒体项。
• 问题 111279349：新增调用 sharedAlbums.leave，用于退出已加入的影集。
• 问题 111279347：新增调用 albums.unshare，用于将共享影集标记为不公开。

“Resolved”类别的问题

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

2018 年 9 月 6 日

功能

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

备注

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

2018 年 9 月 5 日

功能

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

“Resolved”类别的问题

• 问题 79321120：缺少 mimeType 属性 在 mediaItems.batchCreate 对视频媒体项的响应。
• 问题 79319272：如 mediaMetadata、contributorInfo在 mediaItems.batchCreate 响应。
• 问题 110237685：修复了与 CORS 相关的文件上传问题。
• 问题 79318118：没有一致的顺序 在将多个项目上传到 mediaItems.batchCreate 调用。

备注

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

2018 年 7 月 31 日

功能

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

“Resolved”类别的问题

• 问题 79757390：未设置文件名 上传请求期间发生的所有事件请参阅X-Goog-Upload-File-Namefile和 上传中的 X-Goog-Upload-Protocol 字段 媒体指南。
• 问题 80182372：可续传上传返回了一个 错误。请参阅新增的可续传 更新的上传指南 协议。
• 问题 79497397：缺少 isWriteable 属性 （位于 albums.list 响应中）。
• 问题 111143493：PEOPLE 内容分类 过滤器返回的结果不准确。
• 问题 111056278：BIRTHDAYS 内容分类 过滤器返回了错误。

预览版 - 2018 年 5 月 8 日

Library API 的初始版本。

已知问题

• 如果 GET mediaItem 收到的媒体内容 id 属于 来自共享影集的媒体内容，但不归该用户所有。
• batchCreate 调用的响应不返回 mediaMetadata 或 contributorInfo。
• 如果媒体内容是视频，则 batchCreate 调用不会返回 mimeType。
• 上传多项内容时，batchCreate 的顺序不一致。
• batchCreate 不支持排序（在 position 中添加） 以共享影集所有者的身份在共享影集中创建媒体内容。默认创建在影集的末尾。