الحد الأقصى لعدد الألبومات التي سيتم عرضها في الردّ قد يتم عرض عدد ألبومات أقل من العدد المحدّد. القيمة التلقائية pageSize هي 20، والحد الأقصى هو 50.
pageToken
string
رمز استمرارية للحصول على الصفحة التالية من النتائج تؤدي إضافة هذا إلى الطلب إلى عرض الصفوف بعد pageToken. يجب أن تكون pageToken هي القيمة المعروضة في المَعلمة nextPageToken في الاستجابة لطلب listAlbums.
excludeNonAppCreatedData
boolean
في حال ضبط هذا الخيار، تستبعد النتائج عناصر الوسائط التي لم ينشئها هذا التطبيق. الإعداد التلقائي هو خطأ (يتم عرض كل الألبومات). يتم تجاهل هذا الحقل في حال استخدام النطاق photoslibrary.readonly.appcreateddata.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بالألبومات المطلوبة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
النتائج فقط. قائمة الألبومات المعروضة في علامة التبويب "الألبومات" في تطبيق "صور Google" الخاص بالمستخدم
nextPageToken
string
النتائج فقط. الرمز المميّز الذي سيتم استخدامه للحصول على المجموعة التالية من الألبومات يتمّ تعبئته إذا كان هناك المزيد من الألبومات التي يجب استرجاعها لهذا الطلب.
تاريخ التعديل الأخير: 2025-01-30 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-01-30 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists all albums displayed in the user's Google Photos Albums tab."],["Allows filtering by page size, page token, and excluding non-app created data."],["Responses include an array of albums and a token for retrieving further pages."],["Requires specific authorization scopes for access, with some legacy scopes being phased out."],["Functionality will be limited to app-created media starting March 31, 2025."]]],["This document details how to retrieve a list of albums from the Google Photos app using the `GET https://photoslibrary.googleapis.com/v1/albums` request. The request requires no body but accepts `pageSize`, `pageToken`, and `excludeNonAppCreatedData` as query parameters. The response includes an array of albums and an optional `nextPageToken` for pagination. It also outlines the required authorization scopes and indicates that certain scopes will limit functionality to app-created content after March 31, 2025.\n"]]