نظرة عامة

تقسيم النتائج على عدّة صفحات

تتيح خدمة LSA تقسيم النتائج إلى صفحات لاستيعاب طلبات اللقطات الكبيرة في عمليات جلب (سحب) متعددة للصفحات. سيجلب محرّك بحث Google نقطة نهاية شريك معيّن مع المَعلمة maxresults للحدّ من الحد الأقصى لعدد مقدّمي الخدمات المعروضين في استجابة JSON. سيملأ الشركاء رمزًا مميزًا للتصفّح في الحقل metadata.pagination.nextTokenParam في استجابة JSON. قيمة الرمز المميز هذا خاصة بالشريك ويتم استخدامها لإنشاء عنوان URL للصفحة التالية. يجب عدم ملء الحقل nextTokenParam للصفحة الأخيرة. يُرجى العِلم أنّه يجب دائمًا ملء العنصر metadata.pagination (لأنّه مطلوب في المخطط)، حتى إذا لم تتضمّن الصفحة الأخيرة الحقل nextTokenParam. بالإضافة إلى ذلك، يشير totalCount إلى إجمالي عدد مقدّمي الخدمات (أو reviewItems في حال خلاصة المراجعات) على مستوى جميع الصفحات.

على سبيل المثال، إذا كان لدى شريك 200 مقدّم خدمة في اللقطة الكاملة. عندما تبدأ Google عملية نقل الخلاصات باستخدام عنوان URL http://www.partners.com/feeds/{version}/profile&maxresults=100، يجب أن تعرض الصفحة الأولى أول 100 مقدّم خدمة من الشركاء مع metaData التالي:

"metaData": {
     "feedCategory":"SNAPSHOT",
     "feedTimestampMicros":1532930955190163,
     "apiVersion": "v1",
     "pagination": {
        "nextTokenParam": "yre7yiesar"
     },
     "totalCount":200
}
"serviceProviders": {....}   // Contains 100 service provider objects.

ستحلّل Google القيمة nextTokenParam: "yre7yiesar" وستبدأ عملية النقل الثانية باستخدام عنوان URL التالي: http:partners.com/feeds/{version}/profile&nextpagetoken=yre7yiesar&maxresults=100

يجب أن تعرض الصفحة الثانية آخر 100 مقدّم خدمة. بما أنّ الصفحة الثانية هي أيضًا الصفحة الأخيرة، لن تتم تعبئة nextTokenParam (metaData مثال أدناه)، ما يشير إلى نهاية التقسيم على صفحات.

"metaData": {
     "feedCategory":"SNAPSHOT",
     "feedTimestampMicros":1532930955190164,
     "apiVersion": "v1",
     "pagination": {},
     "totalCount":200
}
"serviceProviders": {....}

يُرجى العِلم أنّه بعد استرجاع جميع الصفحات، يجب أن يساوي إجمالي عدد عناصر serviceProviders (في جميع الصفحات) قيمة totalCount الموضّحة في عملية استرجاع الصفحة الأولى.