אנחנו מעדכנים את Data API כך שיתאים לאופן שבו YouTube סופר צפיות ב-Shorts.
מידע נוסף
הטמעה: חלוקה לדפים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הדוגמה הבאה מראה איך לאחזר קבוצות נוספות של תוצאות לשאילתות של YouTube Data API (גרסה 3).
ה-API משתמש בפרמטר maxResults כדי לציין כמה פריטים צריך לכלול בתגובת ה-API. כמעט כל השיטות של list ב-API (videos.list, playlists.list וכו') תומכות בפרמטר הזה.
אם יש תוצאות נוספות לשאילתה, תגובת ה-API תכיל מאפיין nextPageToken, מאפיין prevPageToken או את שניהם. לאחר מכן אפשר להשתמש בערכים של המאפיינים האלה כדי להגדיר את הפרמטר pageToken לאחזור דף נוסף של תוצאות.
לדוגמה, השאילתה הבאה מאחזרת את תוצאות החיפוש של 10 הסרטונים הנצפים ביותר שתואמים לשאילתה 'כלב שרכב על סקייטבורד':
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
part=snippet
&maxResults=10
&order=viewCount
&q=skateboarding+dog
&type=video
תגובת ה-API מכילה את 10 ההתאמות הראשונות לשאילתה, וגם את המאפיין nextPageToken שאפשר להשתמש בו כדי לאחזר את 10 התוצאות הבאות:
השאילתה הבאה מאחזרת את 10 התוצאות הבאות של השאילתה:
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 כדי להשלים את הבקשה הזו ב-API Explorer. מריצים את השאילתה שמאחזרת את 10 התוצאות הראשונות כדי לקבל את ערך הפרמטר pageToken הנכון.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-23 (שעון UTC).
[null,null,["עדכון אחרון: 2024-11-23 (שעון UTC)."],[[["\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."]]
