REST Resource: albums

資源：相簿

表示 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

[僅供輸出] 如果您可以在這個相簿中建立媒體項目，則傳回值為「是」。這個欄位是根據授予相簿的範圍和權限而定。如果範圍有所變更，或相簿權限有所變更，這個欄位也會隨之更新。
shareInfo

object (ShareInfo)

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

string (int64 format)

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

string

[Output only] 封面相片的位元組網址。請勿依原樣使用。使用前請先在這個網址後方加上參數。如需支援參數的完整清單，請參閱開發人員說明文件。舉例來說，'=w2048-h1024' 可將封面相片的尺寸設為 2048 像素，高度則為 1024 像素。
coverPhotoMediaItemId

string

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

ShareInfo

共享相簿的相關資訊。只有在您建立相簿、與他人共享相簿，以及設定共用範圍的情況下，系統才會納入這類資訊。

JSON 表示法 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
欄位
sharedAlbumOptions

object (SharedAlbumOptions)

控管其他人能否在共享相簿中新增媒體項目或留言。
shareableUrl

string

共享 Google 相簿的相簿連結。知道連結的任何人都能查看相簿內容，因此請謹慎使用。

只有在相簿已啟用連結共享功能時，才會傳回 shareableUrl 參數。如果使用者已加入未透過連結共用功能共享的相簿，可以改用相簿的 productUrl 存取相簿。

如果擁有者關閉 Google 相簿應用程式中的連結共用設定，或是相簿已取消共享，shareableUrl就會失效。
shareToken

string

此權杖可用於代表非擁有者加入、離開或擷取共享相簿的詳細資料。

如果擁有者關閉 Google 相簿應用程式中的連結共用設定，或是相簿已取消共享，shareToken就會失效。
isJoined

boolean

如果使用者加入相簿，則為「是」。對相簿擁有者而言，這點一律是。
isOwned

boolean

如果使用者擁有相簿，則傳回「是」。
isJoinable

boolean

如果使用者可以加入相簿，則為「是」。

SharedAlbumOptions

用於控制相簿共用設定的選項。

JSON 表示法 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
欄位
isCollaborative

boolean

如果共享相簿允許協作者 (已加入相簿的使用者) 在相簿中新增媒體項目，則為「是」。預設值為 false。
isCommentable

boolean

如果共享相簿允許協作者 (已加入相簿的使用者) 在相簿中新增留言，則為 True。預設值為 false。

方法

addEnrichment

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

 使用指定的 id 更新專輯。

share

unshare