REST Resource: sharedAlbums

資源:相簿

表示 Google 相簿中的相簿。相簿是媒體項目的容器,如果應用程式已經分享相簿,其中會包含額外的 shareInfo 屬性。

JSON 表示法
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
欄位
id

string

專輯的 ID。這是一個永久性識別碼,可用於在各工作階段之間用來辨識這本相簿。

title

string

在 Google 相簿帳戶中向使用者顯示的相簿名稱。這個字串不得超過 500 個半形字元。

productUrl

string

[僅供輸出] 相簿的 Google 相簿網址。使用者必須登入 Google 相簿帳戶,才能存取這個連結。

isWriteable

boolean

[Output only] 如果您可以在這本相簿中建立媒體項目,則為 True。這個欄位是根據授予相簿的範圍和權限而定。如果範圍有所變更,或相簿權限有所變更,這個欄位也會隨之更新。

shareInfo

object (ShareInfo)

[Output only] 共用相簿相關資訊。只有在相簿是共享相簿、開發人員建立相簿,且使用者將 photoslibrary.sharing 範圍設為共用相簿時,這個欄位才會填入資料。

mediaItemsCount

string (int64 format)

[Output only] 相簿中的媒體項目數量。

coverPhotoBaseUrl

string

[Output only] 封面相片的位元組網址。這個網址不應直接使用,而是應在使用前附加參數。如需支援參數的完整清單,請參閱開發人員說明文件。舉例來說,'=w2048-h1024' 可將封面相片的尺寸設為 2048 像素,高度則為 1024 像素。

coverPhotoMediaItemId

string

與封面相片相關的媒體項目 ID。

方法

get

根據指定的 shareToken 傳回專輯。

join

代表 Google 相簿使用者加入共享相簿。

leave

代表 Google 相簿使用者離開先前加入的共享相簿。

list

列出使用者 Google 相簿應用程式「共享」分頁中的所有共享相簿。