订阅以下版本说明。
每次发布新版本的 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
中添加)。默认为影集末尾。