Method: albums.list
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
برخی از محدوده هایی که قبلا برای این روش استفاده می شد در حال حذف یا تغییر هستند. از 31 مارس 2025، عملکرد به تعامل با موارد رسانه ایجاد شده توسط برنامه شما محدود خواهد شد. برای جزئیات بیشتر لطفاً بهروزرسانیهای Photos APIs را ببینید.
همه آلبومهایی را که در برگه آلبومهای برنامه Google Photos به کاربر نشان داده میشود فهرست میکند.
درخواست HTTP GET https://photoslibrary.googleapis.com/v1/albums
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو پارامترها pageSize
integer
حداکثر تعداد آلبوم برای بازگشت در پاسخ. ممکن است تعداد کمتری آلبوم از تعداد مشخص شده بازگردانده شود. pageSize
پیش فرض 20 و حداکثر 50 است.
pageToken
string
یک نشانه ادامه برای دریافت صفحه بعدی نتایج. با افزودن این به درخواست، ردیفهای بعد از pageToken
برمیگردد. pageToken
باید مقداری باشد که در پارامتر nextPageToken
در پاسخ به درخواست listAlbums
برگردانده شده است.
excludeNonAppCreatedData
boolean
اگر تنظیم شود، نتایج شامل موارد رسانهای نمیشوند که توسط این برنامه ایجاد نشدهاند. پیش فرض ها به false (همه آلبوم ها برگردانده می شوند). اگر از محدوده photoslibrary.readonly.appcreateddata استفاده شود، این قسمت نادیده گرفته می شود.
درخواست بدن بدنه درخواست باید خالی باشد.
بدن پاسخگو لیست آلبوم های درخواستی
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON {
"albums" : [
{
object (Album
)
}
] ,
"nextPageToken" : string
}
فیلدها albums[]
object ( Album
)
فقط خروجی فهرست آلبومهایی که در برگه آلبومها در برنامه Google Photos کاربر نشان داده شده است.
nextPageToken
string
فقط خروجی رمزی برای استفاده برای دریافت مجموعه بعدی آلبوم ها. اگر آلبومهای بیشتری برای بازیابی برای این درخواست وجود داشته باشد، تکمیل میشود.
محدوده مجوز به یکی از حوزه های OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
https://www.googleapis.com/auth/photoslibrary.readonly.originals
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-09-23 بهوقت ساعت هماهنگ جهانی.
[{
"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": "\u062a\u0627\u0631\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-09-23 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","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-23 بهوقت ساعت هماهنگ جهانی."]]