REST Resource: albums

資源：相簿
方法

資源：相簿

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

JSON 表示法

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

{
  "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` [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。

isCollaborative

boolean

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

isCommentable

boolean

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

方法
`addEnrichment`	在已定義相簿的特定位置新增充實內容。
`batchAddMediaItems`	將使用者的 Google 相簿相片庫中的一或多個媒體項目新增至相簿。
`batchRemoveMediaItems`	從指定相簿中移除一或多個媒體項目。
`create`	在使用者的 Google 相簿相片庫中建立相簿。
`get`	根據指定的 `albumId` 傳回專輯。
`list`	在 Google 相簿應用程式的「相簿」分頁中，列出使用者看到的所有相簿。
`patch`	使用指定的 `id` 更新相簿。
`share`	將相簿標示為共享，其他使用者可存取。
`unshare`	將先前共享的相簿標示為私人。

REST Resource: albums

資源：相簿

ShareInfo

SharedAlbumOptions

方法

`addEnrichment`

`batchAddMediaItems`

`batchRemoveMediaItems`

`create`

`get`

`list`

`patch`

`unshare`