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

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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