يسرد جميع الألبومات المعروضة لمستخدم في علامة تبويب "الألبومات" بتطبيق "صور Google".
طلب HTTP
GET https://photoslibrary.googleapis.com/v1/albums
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
الحد الأقصى لعدد الألبومات التي يمكن عرضها في الرد. قد يتم عرض ألبومات أقل من الرقم المحدد. القيمة التلقائية |
pageToken |
رمز مميز للمتابعة للحصول على الصفحة التالية من النتائج. تؤدي إضافة هذا إلى الطلب إلى عرض الصفوف التي تلي |
excludeNonAppCreatedData |
إذا تم ضبط هذه السياسة، ستستبعد النتائج ملفات الوسائط التي لم ينشئها هذا التطبيق. يتم ضبط الإعدادات التلقائية على "خطأ" (يتم عرض جميع الألبومات). يتم تجاهل هذا الحقل في حال استخدام نطاق photoslibrary.readonly.app saveddata. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة الألبومات المطلوبة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"albums": [
{
object ( |
الحقول | |
---|---|
albums[] |
النتائج فقط. قائمة الألبومات المعروضة في علامة التبويب "الألبومات" في تطبيق "صور Google" الخاص بالمستخدم. |
nextPageToken |
النتائج فقط. رمز مميّز يمكنك استخدامه للحصول على المجموعة التالية من الألبومات. تتم تعبئة هذا الحقل في حال كان هناك المزيد من الألبومات التي يمكن استردادها لهذا الطلب. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata