Photos Library API

管理 Google 相册中的照片、视频和影集

• REST 资源：v1.albums
• REST 资源：v1.mediaItems
• REST 资源：v1.sharedAlbums

服务：photoslibrary.googleapis.com

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点，下面的所有 URI 都与此服务端点相关：

• https://photoslibrary.googleapis.com

REST 资源：v1.albums

方法
addEnrichment	POST /v1/albums/{albumId}:addEnrichment（ ） 在指定影集中的指定位置添加扩充项。
batchAddMediaItems	POST /v1/albums/{albumId}:batchAddMediaItems（ ） 将用户 Google 相册媒体库中的一项或多项媒体内容添加到影集。
batchRemoveMediaItems	POST /v1/albums/{albumId}:batchRemoveMediaItems（ ） 从指定影集中移除一项或多项媒体内容。
create	POST /v1/albums（ ） 在用户的 Google 相册媒体库中创建影集。
get	GET /v1/albums/{albumId} 根据指定的 albumId 返回影集。
list	GET /v1/albums（ ） 列出 Google 相册应用的“影集”标签页中向用户显示的所有影集。
patch	PATCH /v1/albums/{album.id} 更新专辑，使用指定的 id。
share	POST /v1/albums/{albumId}:share（ ） 将影集标记为共享影集，以供其他用户访问。
unshare	POST /v1/albums/{albumId}:unshare（ ） 将先前的共享影集标记为不公开。

REST 资源：v1.mediaItems

方法
batchCreate	POST /v1/mediaItems:batchCreate（ ） 在用户的 Google 相册媒体库中创建一项或多项媒体内容。
batchGet	GET /v1/mediaItems:batchGet（ ） 返回具有指定媒体内容标识符的媒体内容列表。
get	GET /v1/mediaItems/{mediaItemId}（ ） 返回具有指定媒体内容标识符的媒体内容。
list	GET /v1/mediaItems（ ） 列出用户 Google 相册媒体库中的所有媒体内容。
patch	PATCH /v1/mediaItems/{mediaItem.id}（ ） 使用指定的 id 更新媒体内容。
search	POST /v1/mediaItems:search（ ） 搜索用户 Google 相册媒体库中的媒体内容。

REST 资源：v1.sharedAlbums

方法
get	GET /v1/sharedAlbums/{shareToken}（ ） 根据指定的 shareToken 返回影集。
join	POST /v1/sharedAlbums:join（ ） 代表 Google 相册用户加入共享影集。
leave	POST /v1/sharedAlbums:leave（ ） 代表 Google 相册用户退出先前加入的共享影集。
list	GET /v1/sharedAlbums（ ） 列出用户 Google 相册应用“分享”标签页中提供的所有共享影集。