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