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。這是一個永久 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

[僅供輸出] 封面相片位元組的網址。請勿依原樣使用。使用前請先在這個網址後方加上參數。如需完整的支援參數清單,請參閱開發人員說明文件。舉例來說,'=w2048-h1024' 會將封面相片的寬度和高度分別設為 2048 像素和 1024 像素。

coverPhotoMediaItemId

string

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

方法

get

根據指定的 shareToken 傳回專輯。

join

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

leave

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

list

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