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.appcreateddata.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة بالألبومات المطلوبة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals