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

הדוגמאות הבאות ממחישות איך להשלים כמה סוגים שונים של בקשות חיפוש ב-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. הוא קורא ל-method‏ search.list ומגדיר את הערך של הפרמטר type ל-playlist, כדי שקבוצת התוצאות תכלול רק פלייליסטים.

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

ערוצים

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

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

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

בדוגמה הזו, קוראים ל-method‏ 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.

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

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

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

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