אנחנו מעדכנים את Data API כך שיתאים לאופן שבו YouTube סופר צפיות ב-Shorts.
מידע נוסף
הטמעה: בקשות חיפוש
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הדוגמאות הבאות מדגימות איך להשלים כמה סוגים שונים של בקשות חיפוש ב-API בגרסה 3.
סרטונים
פלייליסטים
ערוצים
תוצאות שרלוונטיות לשפה מסוימת
סרטונים שהועלו דרך האפליקציה או האתר של המפתח
בדוגמה הזו מוצג איך להשתמש בפרמטר forDeveloper כדי להגביל חיפוש כך שיציג רק סרטונים שהועלו דרך האפליקציה או האתר של המפתח. אפשר להשתמש בפרמטר הזה בשילוב עם פרמטרים אופציונליים לחיפוש, כמו הפרמטר q.
הערה: השאילתה הזו לא מחזירה תוצאות ב-API Explorer כי הכלי לא תומך בהעלאות של סרטונים. אפשר להריץ את השאילתה הזו לאפליקציה שלכם מחוץ ל-APIs Explorer, אבל אי אפשר לקבל תוצאות לאפליקציה שלכם באמצעות APIs Explorer.
כל סרטון שמעלים מתויג באופן אוטומטי במספר הפרויקט שמשויך לאפליקציה של המפתח ב-מסוף Google API.
כשבקשת חיפוש מגדירה את הפרמטר forDeveloper ל-true, שירות ה-API משתמש בפרטי הכניסה של הבקשה לצורך אימות המפתח. לכן, מפתח יכול להגביל את התוצאות לסרטונים שהועלו דרך האפליקציה או האתר שלו, אבל לא לסרטונים שהועלו דרך אפליקציות או אתרים אחרים.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
part=snippet
&q=fun
&forDeveloper=true
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-23 (שעון UTC).
[null,null,["עדכון אחרון: 2024-11-23 (שעון UTC)."],[[["\u003cp\u003eThis content demonstrates various search requests using the v3 API's \u003ccode\u003esearch.list\u003c/code\u003e method for finding different types of content.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter search results to include only videos, playlists, or channels by specifying the \u003ccode\u003etype\u003c/code\u003e parameter in the API request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eorder\u003c/code\u003e, \u003ccode\u003eq\u003c/code\u003e, and \u003ccode\u003evideoDefinition\u003c/code\u003e parameters are used to refine video searches, as seen with the "skateboarding dog" example, allowing specification of search order, search query, and video definition.\u003c/p\u003e\n"],["\u003cp\u003eSearch results can be tailored to specific languages using the \u003ccode\u003erelevanceLanguage\u003c/code\u003e parameter, enabling targeted content discovery.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eforDeveloper\u003c/code\u003e parameter allows searching for videos uploaded through the developer's app, utilizing the developer's project number, but not within the API's Explorer.\u003c/p\u003e\n"]]],["The v3 API's `search.list` method performs various searches. It finds HD videos related to a query by setting parameters like `order`, `q`, and `videoDefinition`. It locates playlists or channels by specifying `type` as 'playlist' or 'channel'. Results relevant to a language are found using `relevanceLanguage`. Developers can find videos uploaded via their app with `forDeveloper`, using their credentials and project number tagged to each upload.\n"],null,["# Implementation: Search requests\n\nThe following examples demonstrate how to complete several different types of search requests in the v3 API.\n\nVideos\n------\n\nThis example calls the [search.list](/youtube/v3/docs/search/list) method to find the most viewed, high-definition (HD) videos associated with the query \"skateboarding dog.\" The query sets the `order`, `part`, `q`, `type`, and `videoDefinition` parameters. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &order=viewCount\n &q=skateboarding+dog\n &type=video\n &videoDefinition=high\n```\n\nSee the [search.list](/youtube/v3/docs/search/list#usage) method's documentation for code samples.\n\nPlaylists\n---------\n\nThis example shows how to find playlists matching the query term \"GoogleDevelopers.\" It calls the [search.list](/youtube/v3/docs/search/list) method and sets the [type](/youtube/v3/docs/search/list#type) parameter's value to `playlist` so that the result set only includes playlists. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &q=GoogleDevelopers\n &type=playlist\n```\n\nChannels\n--------\n\nThis example shows how to find channels matching the query term \"travel.\" It calls the [search.list](/youtube/v3/docs/search/list) method and sets the [type](/youtube/v3/docs/search/list#type) parameter's value to `channel` so that the result set only includes channels. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &q=travel\n &type=channel\n```\n\nResults relevant to a specific language\n---------------------------------------\n\nThis example calls the [search.list](/youtube/v3/docs/search/list) method to find search results that are most relevant to a specific language. The example shows that the query term is **marine** (`q=marine`) and that the API response should contain results most relevant to the French language (`relevanceLanguage=fr`). \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &q=marine\n &relevanceLanguage=fr\n```\n\nNote that the request does not set a value for the `type` parameter, which means each search result could reference a video, playlist, or channel.\n\nVideos uploaded via the developer's app or website\n--------------------------------------------------\n\nThis example shows how to use the [forDeveloper](/youtube/v3/docs/search/list#forDeveloper) parameter to restrict a search to only retrieve videos uploaded via the developer's application or website. This parameter can be used in conjunction with optional search parameters, like the `q` parameter.\n\n**Note:** This query does not actually return results in the APIs Explorer because the APIs Explorer doesn't support video uploads. You can run this query for your own application outside of the APIs Explorer, but you can't get results for *your* application using the APIs Explorer.\n\nEach uploaded video is automatically tagged with the project number that is associated with the developer's application in the [Google API Console](https://console.developers.google.com/).\n\nWhen a search request subsequently sets the `forDeveloper` parameter to true, the API service uses the request's authorization credentials to identify the developer. Thus, a developer can restrict results to videos uploaded through the developer's own app or website but not to videos uploaded through other apps or sites. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?\n part=snippet\n &q=fun\n &forDeveloper=true\n```"]]
