Method: sharedAlbums.list

يسرد جميع الألبومات المشتركة المتاحة في علامة التبويب "مشاركة" في تطبيق "صور Google" لدى المستخدم.

طلب HTTP

GET https://photoslibrary.googleapis.com/v1/sharedAlbums

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معامِلات طلب البحث

المعلمات
pageSize

integer

الحد الأقصى لعدد الألبومات التي يمكن عرضها في الردّ قد يتم عرض ألبومات أقلّ من الرقم المحدَّد. القيمة التلقائية للسمة pageSize هي 20، والحدّ الأقصى هو 50.
pageToken

string

رمز مميز للمتابعة للحصول على الصفحة التالية من النتائج. تؤدي إضافة هذا إلى الطلب إلى عرض الصفوف بعد pageToken. يجب أن تكون السمة pageToken هي القيمة التي تعرضها المَعلمة nextPageToken في الردّ على طلب listSharedAlbums.
excludeNonAppCreatedData

boolean

في حال ضبط السياسة، تستبعد النتائج ملفات الوسائط التي لم ينشئها هذا التطبيق. يتم ضبط الإعدادات التلقائية على "خطأ" (يتم عرض جميع الألبومات). يتم تجاهل هذا الحقل في حال استخدام نطاق photoslibrary.readonly.app منشئ البيانات.

نص الطلب

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

نص الاستجابة

تم طلب قائمة الألبومات المشتركة.

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

تمثيل JSON 
{
  "sharedAlbums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
الحقول
sharedAlbums[]

object (Album)

النتائج فقط. قائمة الألبومات المشترَكة
nextPageToken

string

النتائج فقط. الرمز المميّز الذي يجب استخدامه للحصول على المجموعة التالية من الألبومات المشترَكة تتم تعبئة هذا الحقل إذا كان هناك المزيد من الألبومات المشتركة لاستردادها لهذا الطلب.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata