2025 年 4 月 1 日,Library API 中的部分範圍已遭到移除。
詳情請參閱這篇文章。
Method: albums.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://photoslibrary.googleapis.com/v1/albums
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"album": {
object (Album )
}
} |
欄位 |
album |
object (Album )
必要欄位。要建立的相簿。
|
回應主體
如果成功,回應主體會包含新建立的 Album
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/photoslibrary.appendonly
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-04-01 (世界標準時間)。
[[["容易理解","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"]],["上次更新時間:2025-04-01 (世界標準時間)。"],[[["This documentation outlines the process for creating an album in a user's Google Photos library using the Photos Library API."],["The API request involves sending a POST request to a specific endpoint with a JSON body containing the album details."],["A successful response will return the newly created album object, including its properties and metadata."],["Authentication requires one of the provided OAuth scopes to grant necessary permissions."],["Beginning March 31, 2025, the scopes will change to limit functionality to media items created by the user's application, as outlined in the Photos APIs updates document."]]],["This document details creating albums in a user's Google Photos library via the API. It uses a `POST` request to `https://photoslibrary.googleapis.com/v1/albums`. The request body, formatted as JSON, requires an `album` object. Successful requests return the newly created `Album` instance. Authorization necessitates specific OAuth scopes: `photoslibrary`, `photoslibrary.appendonly`, or `photoslibrary.sharing`. Note that scopes will limit interactions with media items, created by the app, after March 31, 2025.\n"]]