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

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

סרטונים

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

ערוצים

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

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

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

הדוגמה הזו קוראת לשיטה search.list כדי למצוא תוצאות חיפוש שרלוונטיות ביותר לשפה ספציפית. לפי הדוגמה הזו, מונח השאילתה הוא מארין (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.

הערה: השאילתה הזו לא מחזירה תוצאות ב-APIs Explorer מפני ש-APIs Explorer לא תומך בהעלאות סרטונים. אתם יכולים להריץ את השאילתה הזו על האפליקציה שלכם מחוץ ל-APIs Explorer, אבל לא ניתן לקבל תוצאות לאפליקציה שלכם באמצעות APIs Explorer.

כל סרטון שמעלים מתויג באופן אוטומטי במספר הפרויקט שמשויך לאפליקציה של המפתח ב-Google API Console.

כשבקשת חיפוש מגדירה את הפרמטר forDeveloper כ-True, שירות ה-API משתמש בפרטי הכניסה להרשאה כדי לזהות את המפתח. לכן, המפתח יכול להגביל את התוצאות לסרטונים שהועלו דרך האפליקציה או האתר של המפתח, אבל לא לסרטונים שהועלו דרך אפליקציות או אתרים אחרים.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true