הטמעה: בקשות חיפוש

הדוגמאות הבאות מדגימות איך להשלים כמה סוגים שונים של בקשות חיפוש ב-API בגרסה 3.

סרטונים

בדוגמה הזו קוראים ל-method‏ search.list כדי למצוא את הסרטונים הנצפים ביותר באיכות HD שמשויכים לשאילתה 'כלב שרוכב על סקייטבורד'. השאילתה מגדירה את הפרמטרים order, part, q, type ו-videoDefinition.

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

דוגמאות קוד זמינות במסמכי העזרה של השיטה search.list.

פלייליסטים

בדוגמה הזו נסביר איך למצוא פלייליסטים שתואמים למונח השאילתה 'GoogleDevelopers'. הוא קורא לשיטה search.list ומגדיר את הערך של הפרמטר type כ-playlist, כך שקבוצת התוצאות תכלול רק פלייליסטים.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=GoogleDevelopers
        &type=playlist

ערוצים

בדוגמה הזו מוסבר איך למצוא ערוצים שתואמים למונח השאילתה 'נסיעות'. הוא קורא ל-method‏ search.list ומגדיר את הערך של הפרמטר type כ-channel, כך שקבוצת התוצאות תכלול רק ערוצים.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

תוצאות שרלוונטיות לשפה מסוימת

בדוגמה הזו קוראים לשיטה search.list כדי למצוא את תוצאות החיפוש שרלוונטיות ביותר לשפה ספציפית. בדוגמה הזו מוצג מונח השאילתה marine (q=marine), ותגובת ה-API צריכה להכיל את התוצאות הרלוונטיות ביותר לשפה הצרפתית (relevanceLanguage=fr).

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=marine
        &relevanceLanguage=fr

שימו לב שבבקשה לא מוגדר ערך לפרמטר type, כלומר כל תוצאת חיפוש יכולה להפנות לסרטון, לפלייליסט או לערוץ.

סרטונים שהועלו דרך האפליקציה או האתר של המפתח

בדוגמה הזו מוצג איך להשתמש בפרמטר 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