מוצג לך תיעוד של הגרסה הקודמת של Google Photos Library API.
Method: albums.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת אלבום בספרייה של משתמש ב-Google Photos.
בקשת HTTP
POST https://photoslibrary.googleapis.com/v1/albums
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג JSON |
{
"album": {
object (Album)
}
} |
| שדות |
album |
object (Album)
חובה. האלבום שמיועד ליצירה.
|
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Album.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/photoslibraryhttps://www.googleapis.com/auth/photoslibrary.appendonlyhttps://www.googleapis.com/auth/photoslibrary.sharing
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eCreates a new album within a user's Google Photos library using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the album details in JSON format, specifying properties like title and description.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns the newly created album object with its assigned ID and other relevant information.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization using one of the specified OAuth scopes to access and modify the user's Google Photos library.\u003c/p\u003e\n"]]],["A user can create a new album in their Google Photos library by sending a `POST` request to `https://photoslibrary.googleapis.com/v1/albums`. The request body must include an \"album\" object. Successful requests return the newly created album. This action requires authorization through one of three OAuth scopes: `photoslibrary`, `photoslibrary.appendonly`, or `photoslibrary.sharing`. The album is to be made using a JSON structured representation.\n"],null,["# Method: albums.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an album in a user's Google Photos library.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/albums`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"album\": { object (/photos/library/legacy/reference/rest/v1/albums#Album) } } ``` |\n\n| Fields ||\n|---------|----------------------------------------------------------------------------------------------------------------|\n| `album` | `object (`[Album](/photos/library/legacy/reference/rest/v1/albums#Album)`)` Required. The album to be created. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/photoslibrary`\n- `https://www.googleapis.com/auth/photoslibrary.appendonly`\n- `https://www.googleapis.com/auth/photoslibrary.sharing`"]]
