REST Resource: sharedAlbums

資源:Album

相片中的 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

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

shareInfo

object (ShareInfo)

[僅限輸出] 共享相簿的相關資訊。只有當相簿是共享相簿、開發人員建立相簿,且使用者已授予 photoslibrary.sharing 範圍時,系統才會填入這個欄位。

mediaItemsCount

string (int64 format)

[僅限輸出] 相簿中的媒體項目數量。

coverPhotoBaseUrl

string

[僅限輸出] 封面相片的位元組網址。這個值不應依原樣使用。使用參數前,必須先為這個網址附加參數。如需支援參數的完整清單,請參閱開發人員說明文件。舉例來說,'=w2048-h1024' 會將封面相片的尺寸設為 2048 px,高度為 1024 px。

coverPhotoMediaItemId

string

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

方法

get

根據指定的 shareToken 傳回相簿。

join

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

leave

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

list

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