شما در حال مشاهده اسناد قدیمی برای Google Photos Library API هستید.
Method: albums.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
آلبومی را در کتابخانه Google Photos کاربر ایجاد می کند.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/albums
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"album": {
object (Album)
}
} |
| فیلدها |
|---|
album | object ( Album ) مورد نیاز. آلبومی که قرار است ساخته شود. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Album است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary -
https://www.googleapis.com/auth/photoslibrary.appendonly -
https://www.googleapis.com/auth/photoslibrary.sharing
،
آلبومی را در کتابخانه Google Photos کاربر ایجاد می کند.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/albums
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"album": {
object (Album)
}
} |
| فیلدها |
|---|
album | object ( Album ) مورد نیاز. آلبومی که قرار است ساخته شود. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Album است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary -
https://www.googleapis.com/auth/photoslibrary.appendonly -
https://www.googleapis.com/auth/photoslibrary.sharing
،
آلبومی را در کتابخانه Google Photos کاربر ایجاد می کند.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/albums
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"album": {
object (Album)
}
} |
| فیلدها |
|---|
album | object ( Album ) مورد نیاز. آلبومی که قرار است ساخته شود. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Album است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary -
https://www.googleapis.com/auth/photoslibrary.appendonly -
https://www.googleapis.com/auth/photoslibrary.sharing
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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`"]]
