التنفيذ: التقسيم على صفحات

يوضح المثال التالي كيفية استرداد مجموعات إضافية من النتائج لطلبات بحث البيانات في YouTube (الإصدار 3).

تستخدم واجهة برمجة التطبيقات المَعلمة maxResults للإشارة إلى عدد العناصر التي يجب تضمينها في استجابة واجهة برمجة التطبيقات. تدعم جميع طرق واجهة برمجة التطبيقات list تقريبًا (videos.list وplaylists.list وما إلى ذلك) هذه المعلمة تقريبًا.

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

على سبيل المثال، يسترد طلب البحث التالي نتائج البحث عن مقاطع الفيديو العشرة الأكثر مشاهدة التي تتطابق مع طلب البحث "كلب تزلج":

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &q=skateboarding+dog
        &type=video

تحتوي استجابة واجهة برمجة التطبيقات على أول 10 مطابقات لطلب البحث بالإضافة إلى خاصية nextPageToken التي يمكن استخدامها لاسترداد النتائج العشر التالية:

يسترد طلب البحث أدناه النتائج العشر التالية لطلب البحث:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &pageToken=CAoQAA
        &q=skateboarding+dog
        &type=video

ملاحظة: قد تحتاج إلى تعديل قيمة المعلَمة pageToken لإكمال هذا الطلب في مستكشف واجهات برمجة التطبيقات. نفِّذ طلب البحث الذي يسترد أول 10 نتائج للحصول على قيمة معلمة pageToken الصحيحة.