أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات Google Photos Library API.
Method: albums.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد جميع الألبومات التي تظهر لمستخدم في علامة التبويب "الألبومات" في تطبيق "صور Google".
طلب HTTP
GET https://photoslibrary.googleapis.com/v1/albums
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد الألبومات التي يمكن عرضها في الردّ قد يتم عرض ألبومات أقلّ من الرقم المحدَّد. القيمة التلقائية للسمة pageSize هي 20، والحدّ الأقصى هو 50.
|
pageToken |
string
رمز مميز للمتابعة للحصول على الصفحة التالية من النتائج. تؤدي إضافة هذه القاعدة إلى الطلب إلى عرض الصفوف بعد pageToken . يجب أن تكون pageToken هي القيمة المعروضة في المَعلمة nextPageToken في الاستجابة لطلب listAlbums .
|
excludeNonAppCreatedData |
boolean
في حال ضبط السياسة، تستبعد النتائج ملفات الوسائط التي لم ينشئها هذا التطبيق. يتم ضبط الإعدادات التلقائية على "خطأ" (يتم عرض جميع الألبومات). يتم تجاهل هذا الحقل في حال استخدام نطاق photoslibrary.readonly.app منشئ البيانات.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة الألبومات المطلوبة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"albums": [
{
object (Album )
}
],
"nextPageToken": string
} |
الحقول |
albums[] |
object (Album )
النتائج فقط. قائمة الألبومات المعروضة في علامة التبويب "الألبومات" في تطبيق "صور Google" لدى المستخدم
|
nextPageToken |
string
النتائج فقط. رمز مميز لاستخدامه للحصول على المجموعة التالية من الألبومات. تتم تعبئة هذا الحقل إذا كان هناك المزيد من الألبومات المطلوب استردادها لهذا الطلب.
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists all albums displayed in the user's Google Photos Albums tab using the `GET https://photoslibrary.googleapis.com/v1/albums` request."],["Allows pagination with `pageSize` and `pageToken` query parameters to control the number of albums returned and retrieve subsequent pages."],["The response provides a list of `albums` and a `nextPageToken` for further navigation if available."],["Requires authorization with one of the specified OAuth scopes, such as `https://www.googleapis.com/auth/photoslibrary`, for access."],["Can exclude non-app created data using the `excludeNonAppCreatedData` parameter or the `photoslibrary.readonly.appcreateddata` scope."]]],["To retrieve a user's albums from Google Photos, send a `GET` request to `https://photoslibrary.googleapis.com/v1/albums`. The request body must be empty. Optional query parameters include `pageSize` (default 20, max 50), `pageToken` for pagination, and `excludeNonAppCreatedData`. The response contains an array of album objects and `nextPageToken` for subsequent requests. Authorization requires one of three specified OAuth scopes.\n"]]