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。
|
方法 |
|
|
|
|
|
|
|
|
|
|
|
|
|
使用指定的 id 更新專輯。 |
|
|
|
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-12 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-12 (世界標準時間)。"]]