订阅以下版本说明。
每次发布新版本的 Google Photos Library API，此页面都会更新。更新日志会按日期列出版本，并包含所有新功能、bug 修复和其他更改。
文档和指南均指向要使用的最新版本。
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”类别的问题
- 未为媒体内容中的
photo元数据填充exposureTime属性。
2021 年 5 月 19 日
备注
- 更新了动态照片的基本网址文档，以阐明适用于 Android 动态照片和 iOS Live Photos 的
=dv参数的行为。
2021 年 2 月 11 日
备注
- 使用限制政策已更新，增加了有关广告的内容并最大限度地减少数据使用。
2020 年 7 月 7 日
特性
- 此 API 已更新，可支持 Google 相册中新的共享控件。现在，新字段
isJoinable作为共享影集的shareInfo属性的一部分返回。当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，用于识别用户是否为共享影集的所有者。如需了解详情，请参阅分享媒体开发者指南。
“Resolved”类别的问题
- 问题 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：用于向影集添加媒体内容以及从中移除现有媒体内容的新调用：
这些调用支持应用创建的媒体内容和影集。有关详情，请参阅管理影集开发者指南。
现在，如果无法创建某些媒体内容，用于创建媒体内容的 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：针对某些共享媒体内容调用
mediaItems.get时出现 500 错误。
2019 年 1 月 21 日
“Resolved”类别的问题
- 问题 121998358：
albums.create响应中缺少isWriteable属性。
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 已进入正式版阶段。感谢您在 Library API 开发者预览版期间提供反馈和功能请求。
- 查看 Java 和 PHP 客户端库入门指南。
- 指南中添加了示例 Java 和 PHP 代码段，以演示如何使用客户端库。
2018 年 9 月 5 日
特性
- 新调用
sharedAlbums.get，以便使用shareToken获取影集。 shareInfo中新增了isJoined属性，用于标识用户是否已加入共享影集。
“Resolved”类别的问题
- 问题 79321120：视频媒体内容的 mediaItems.batchCreate 响应中缺少
mimeType属性。 - 问题 79319272：mediaItems.batchCreate 响应中缺少
mediaMetadata、contributorInfo等属性。 - 问题 110237685：修复了与 CORS 相关的文件上传问题。
- 问题 79318118：在 mediaItems.batchCreate 调用中将多项内容上传到影集时，未保持一致顺序。
备注
- 如果您在 2018 年 9 月 5 日之前存储 ID（例如影集、媒体内容或扩充项的 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下载参数，用于下载原始图片。
- 问题 79871479：
sharedAlbums.join调用现在会返回一个影集。- 问题 109655786：
album现在包含封面照片coverPhotoMediaItemId的媒体内容 ID。 - 问题 79656863：
mediaItem现在包含媒体内容的文件名filename。
“Resolved”类别的问题
- 问题 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中添加）。默认为影集末尾。