Photos Library API

管理 Google 相簿中的相片、影片和相簿

服務: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
傳回指定媒體項目 ID 的媒體項目清單。
get GET /v1/mediaItems/{mediaItemId}
傳回指定媒體項目 ID 的媒體項目。
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 相簿應用程式「共享」分頁中的所有共享相簿。