معلومات تقسيم الصفحات التي تعرضها عملية List عند تفعيل تقسيم الصفحات حسب الرموز المميّزة
لا تعرض عمليات القائمة التي تتيح تقسيم النتائج إلى صفحات سوى "صفحة" واحدة من النتائج. تصف رسالة وحدة تخزين المؤقت للبروتوكول الصفحة التي تم عرضها.
عند استخدام ميزة تقسيم النتائج على عدّة صفحات باستخدام الرموز المميّزة، على العملاء استخدام الرمز المميّز التالي/السابق للحصول على صفحة أخرى من النتائج. يشير توفّر الرمز المميّز للصفحة التالية/السابقة أو عدم توفّره إلى ما إذا كانت الصفحة التالية/السابقة متاحة، ويقدّم وسيلة للوصول إلى هذه الصفحة. يجب ضبط ListRequest.page_token على nextPageToken أو previousPageToken للوصول إلى صفحة أخرى.
تمثيل JSON |
---|
{ "nextPageToken": string, "previousPageToken": string } |
الحقول | |
---|---|
next |
الرموز المميّزة التي سيتم تمريرها إلى حقل القائمة العادي "pageToken". يُفضّل استخدام الرموز بدلاً من التلاعب بـ startIndex كلما أمكن ذلك. |
previous |
|