نحن بصدد تعديل Data API لتتطابق مع طريقة YouTube في احتساب مشاهدات Shorts.
مزيد من المعلومات
التنفيذ: التقسيم على صفحات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح المثال التالي كيفية استرداد مجموعات إضافية من النتائج لاستعلامات YouTube Data API (الإصدار 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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe YouTube Data API (v3) uses the \u003ccode\u003emaxResults\u003c/code\u003e parameter to determine the number of items returned in a query response.\u003c/p\u003e\n"],["\u003cp\u003eAPI \u003ccode\u003elist\u003c/code\u003e methods, such as \u003ccode\u003evideos.list\u003c/code\u003e and \u003ccode\u003eplaylists.list\u003c/code\u003e, support the \u003ccode\u003emaxResults\u003c/code\u003e parameter for pagination.\u003c/p\u003e\n"],["\u003cp\u003eIf more results are available, the API response includes \u003ccode\u003enextPageToken\u003c/code\u003e and/or \u003ccode\u003eprevPageToken\u003c/code\u003e properties.\u003c/p\u003e\n"],["\u003cp\u003eThese token values can be used to set the \u003ccode\u003epageToken\u003c/code\u003e parameter to retrieve additional result pages.\u003c/p\u003e\n"],["\u003cp\u003eThe initial request fetches the first page of results, and subsequent requests use the \u003ccode\u003epageToken\u003c/code\u003e from the previous response to get the next page of results.\u003c/p\u003e\n"]]],["The YouTube Data API (v3) uses `maxResults` to specify the number of items in a response. `list` methods support this, and responses with additional results include `nextPageToken` or `prevPageToken`. These tokens, used with the `pageToken` parameter, retrieve further result sets. For instance, a query can get 10 most viewed videos, and a `nextPageToken` in the response allows fetching the next 10 by adding this value in the `pageToken` parameter.\n"],null,["# Implementation: Pagination\n\nThe following example shows how to retrieve additional sets of results for YouTube Data API (v3) queries.\n\nThe API uses the `maxResults` parameter to indicate how many items should be included in an API response. Almost all of the API's `list` methods ([videos.list](/youtube/v3/docs/videos/list), [playlists.list](/youtube/v3/docs/playlists/list), etc.) support that parameter.\n\nIf additional results are available for a query, then the API response will contain either a `nextPageToken` property, a `prevPageToken` property, or both. Those properties' values can then be used to set the `pageToken` parameter to retrieve an additional page of results.\n\nFor example, the following query retrieves search results for the 10 most viewed videos matching the query \"skateboarding dog\": \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &maxResults=10\n &order=viewCount\n &q=skateboarding+dog\n &type=video\n```\n\nThe API response contains the first 10 matches for the query as well as a `nextPageToken` property that can be used to retrieve the next 10 results:\n\nThe query below retrieves the next 10 results for the query: \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &maxResults=10\n &order=viewCount\n &pageToken=CAoQAA\n &q=skateboarding+dog\n &type=video\n```\n\n**Note:** You may need to update the value of the `pageToken` parameter to complete this request in the APIs Explorer. Execute the query that retrieves the first 10 results to obtain the correct `pageToken` parameter value."]]
