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。這是一個永久 ID，可在工作階段之間用於識別此專輯。
title

string

使用者在 Google 相簿帳戶中看到的相簿名稱。此字串的長度不得超過 500 個半形字元。
productUrl

string

[Output only] 相簿的 Google 相簿網址。使用者必須登入 Google 相簿帳戶，才能存取這個連結。
isWriteable

boolean

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

object (ShareInfo)

[僅供輸出] 與共用相簿相關的資訊。只有在相簿是共享相簿、開發人員建立相簿，且使用者將 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

 將使用者 Google 相簿相片庫中的一或多個媒體項目新增至相簿。

batchRemoveMediaItems

 從指定相簿中移除一或多個媒體項目。

create

 在使用者的 Google 相簿相片庫中建立相簿。

get

 根據指定的 albumId 傳回專輯。

list

 在 Google 相簿應用程式的「相簿」分頁中，列出使用者看到的所有相簿。

patch

 使用指定的 id 更新專輯。

share

 將相簿標示為已分享且可供其他使用者存取。

unshare

 將先前共享的相簿標示為私人。