באמצעות YouTube Data API אפשר לשלב באתר או באפליקציה שלכם פונקציות שפועלות בדרך כלל באתר של YouTube. ברשימות הבאות מפורטים סוגי המשאבים השונים שאפשר לאחזר באמצעות ה-API. ה-API תומך גם בשיטות להוספה, לעדכון או למחיקה של רבים מהמשאבים האלה.
במדריך הזה מוסבר איך משתמשים ב-API כדי לבצע את כל הפעולות האלה. המדריך מחולק לפי סוג המשאב. משאב מייצג סוג של פריט שמהווה חלק מחוויית השימוש ב-YouTube, כמו סרטון, פלייליסט או מינוי. לכל סוג משאב מופיע במדריך ייצוג נתונים אחד או יותר, והמשאבים מיוצגים כאובייקטים של JSON. במדריך מפורטות גם שיטה נתמכת אחת או יותר (LIST
, POST
, DELETE
וכו') לכל סוג משאב, ומוסבר איך להשתמש בשיטות האלה באפליקציה.
קריאה ל-API
הדרישות הבאות חלות על בקשות ל-YouTube Data API:
-
בכל בקשה צריך לציין מפתח API (עם הפרמטר
key
) או לספק אסימון OAuth 2.0. מפתח ה-API זמין בחלונית API Access (גישת API) של הפרויקט ב-Developer Console. -
חובה לשלוח אסימון הרשאה לכל בקשת הטמעה, עדכון ומחיקה. צריך גם לשלוח אסימון הרשאה לכל בקשה שאוחזרים בה הנתונים הפרטיים של המשתמש המאומת.
בנוסף, שיטות API מסוימות לאחזור משאבים עשויות לתמוך בפרמטרים שדורשים הרשאה, או להכיל מטא-נתונים נוספים כשבקשות מאושרות. לדוגמה, בקשה לאחזר סרטונים שהמשתמש העליך עשויה לכלול גם סרטונים פרטיים, אם הבקשה אושרה על ידי המשתמש הספציפי הזה.
-
ה-API תומך בפרוטוקול האימות OAuth 2.0. אפשר לספק אסימון OAuth 2.0 באחת מהדרכים הבאות:
- משתמשים בפרמטר השאילתה
access_token
כך:?access_token=
oauth2-token
- משתמשים בכותרת
Authorization
של HTTP באופן הבא:Authorization: Bearer
oauth2-token
הוראות מלאות להטמעת אימות OAuth 2.0 באפליקציה מפורטות במדריך האימות.
- משתמשים בפרמטר השאילתה
סוגי המשאבים
פעילויות
משאב activity
מכיל מידע על פעולה שבוצעה על ידי ערוץ או משתמש מסוימים ב-YouTube. הפעולות שמדווחות בפיד הפעילות כוללות דירוג סרטון, שיתוף סרטון, סימון סרטון כמועדף, העלאת סרטון וכו'. כל משאב activity
מזהה את סוג הפעולה, את הערוץ שמשויך לפעולה ואת המשאבים שמשויכים לפעולה, כמו הסרטון שסומן או הועלה.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /activities |
הפונקציה מחזירה רשימה של אירועי פעילות בערוץ שתואמים לקריטריונים של הבקשה. לדוגמה, אפשר לאחזר אירועים שמשויכים לערוץ מסוים או לערוץ של המשתמש עצמו. |
insert |
POST /activities |
הערה: השיטה הזו הוצאה משימוש ולא נתמכת יותר. |
כתוביות
משאב caption
מייצג רצועת כתוביות ב-YouTube. רצועת כתוביות משויכת לסרטון אחד בלבד ב-YouTube.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /captions |
מחיקת רצועת הכתוביות שצוינה. |
download |
GET /captions/id |
הורדת רצועת כתוביות. טראק הכתוביות מוחזר בפורמט המקורי שלו, אלא אם בבקשה צוין ערך לפרמטר tfmt , ובשפה המקורית שלו, אלא אם בבקשה צוין ערך לפרמטר tlang . |
insert |
POST /captions |
העלאת רצועת כתוביות. |
list |
GET /captions |
הפונקציה מחזירה רשימה של רצועות כתוביות שמשויכות לסרטון מסוים. חשוב לזכור שתגובת ה-API לא מכילה את הכתוביות בפועל, ושהשימוש ב-method captions.download מאפשר לאחזר רצועת כתוביות. |
update |
PUT /captions |
עדכון של רצועת כתוביות. כשמעדכנים טראק של כתוביות, אפשר לשנות את סטטוס הטיוטה שלו, להעלות קובץ כתוביות חדש לטראק או לבצע את שתי הפעולות האלה. |
ChannelBanners
משאב channelBanner
מכיל את כתובת ה-URL שבה משתמשים כדי להגדיר תמונה חדשה שהועלתה כתמונה של באנר לערוץ.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
insert |
POST /channelBanners/insert |
מעלה תמונת באנר של הערוץ ל-YouTube. השיטה הזו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של הערוץ:
|
ChannelSections
משאב channelSection
מכיל מידע על קבוצת סרטונים שהבעלים של הערוץ בחר להציג. לדוגמה, קטע יכול לכלול את ההעלאות האחרונות של הערוץ, את ההעלאות הפופולריות ביותר או סרטונים מפלייליסט אחד או יותר.
לתשומת ליבכם: הקטעים של הערוץ גלויים רק אם התוכן בערוץ מוצג בתצוגת'עיון' (ולא בתצוגת פיד). כדי לאפשר לערוץ להציג תוכן בתצוגת גלישה, צריך להגדיר את המאפיין brandingSettings.channel.showBrowseView
לערך true
בערוץ שצוין.
בערוץ אפשר ליצור עד 10 מדפים.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /channelSections |
מחיקה של קטע בערוץ. |
insert |
POST /channelSections |
הוספת קטע לערוץ של המשתמש המאומת. בערוץ אפשר ליצור עד 10 מדפים. |
list |
GET /channelSections |
הפונקציה מחזירה רשימה של משאבי channelSection שתואמים לקריטריונים של בקשת ה-API. |
update |
PUT /channelSections |
עדכון קטע בערוץ. |
ערוצים
משאב channel
מכיל מידע על ערוץ YouTube.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /channels |
הפונקציה מחזירה אוסף של אפס או יותר משאבים מסוג channel שתואמים לקריטריונים של הבקשה. |
update |
PUT /channels |
עדכון המטא-נתונים של הערוץ. חשוב לזכור שהשיטה הזו תומכת כרגע רק בעדכונים של האובייקטים brandingSettings ו-invideoPromotion של המשאב channel ושל נכסי הצאצאים שלהם. |
CommentThreads
משאב commentThread
מכיל מידע על שרשור תגובות ב-YouTube, שכולל תגובה ברמה העליונה ותשובות, אם יש כאלה, לתגובה הזו. משאב commentThread
יכול לייצג תגובות לגבי סרטון או ערוץ.
גם התגובה ברמת העליונה וגם התשובות הן למעשה משאבי comment
שמוטמעים בתוך המשאב commentThread
. המשאב commentThread
לא מכיל בהכרח את כל התשובות לתגובה מסוימת, וצריך להשתמש בשיטה comments.list
כדי לאחזר את כל התשובות לתגובה מסוימת. חשוב גם לזכור שלחלק מהתגובות אין תשובות.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /commentThreads |
הפונקציה מחזירה רשימה של שרשורי תגובות שתואמים לפרמטרים של בקשת ה-API. |
insert |
POST /commentThreads |
יצירת תגובה חדשה ברמה העליונה. כדי להוסיף תשובה לתגובה קיימת, צריך להשתמש במקום זאת בשיטה comments.insert . |
תגובות
משאב comment
מכיל מידע על תגובה אחת ב-YouTube. משאב comment
יכול לייצג תגובה על סרטון או על ערוץ. בנוסף, התגובה יכולה להיות תגובה ברמה העליונה או תגובה לתגובה ברמה העליונה.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /comments |
הפונקציה מחזירה רשימה של תגובות שתואמות לפרמטרים של בקשת ה-API. |
setModerationStatus |
POST /comments/setModerationStatus |
הגדרת סטטוס ניהול של תגובה אחת או יותר. הבעלים של הערוץ או הסרטון שמשויכים לתגובות צריכים לאשר את בקשת ה-API. |
insert |
POST /comments |
יצירת תשובה לתגובה קיימת. הערה: כדי ליצור תגובה ברמה העליונה, משתמשים בשיטה commentThreads.insert . |
markAsSpam |
POST /comments/markAsSpam |
הערה: השיטה הזו הוצאה משימוש ולא נתמכת יותר. |
delete |
DELETE /comments |
מחיקת תגובה. |
update |
PUT /comments |
שינוי תגובה. |
GuideCategories
משאב guideCategory
מזהה קטגוריה שמערכת YouTube מקצה באופן אלגוריתמי על סמך התוכן של הערוץ או על סמך אינדיקטורים אחרים, כמו הפופולריות של הערוץ. הרשימה דומה לקטגוריות של סרטונים, עם ההבדל הבא: מעלה הסרטון יכול להקצות קטגוריה של סרטון, אבל רק YouTube יכול להקצות קטגוריה של ערוץ.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /guideCategories |
הפונקציה מחזירה רשימה של קטגוריות שאפשר לשייך לערוצי YouTube. |
I18nLanguages
משאב i18nLanguage
מזהה שפת אפליקציה שאתר YouTube תומך בה. שפת האפליקציה יכולה להיקרא גם שפת ממשק המשתמש. באתר YouTube, שפת האפליקציה עשויה להיבחר באופן אוטומטי על סמך ההגדרות בחשבון Google, שפת הדפדפן או מיקום כתובת ה-IP. משתמשים יכולים גם לבחור באופן ידני את שפת ממשק המשתמש הרצויה בכותרת התחתונה של אתר YouTube.
כל משאב i18nLanguage
מזהה קוד שפה ושם. אפשר להשתמש בקוד השפה כערך של הפרמטר hl
כשקוראים לשיטות API כמו videoCategories.list
ו-guideCategories.list
.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /i18nLanguages |
הפונקציה מחזירה רשימה של שפות האפליקציות שבהן אתר YouTube תומך. |
I18nRegions
משאב i18nRegion
מזהה אזור גיאוגרפי שמשתמש ב-YouTube יכול לבחור בתור אזור התוכן המועדף. אפשר גם להתייחס לאזור התוכן בתור לוקאל התוכן. באתר YouTube, אזור התוכן יכול להיבחר באופן אוטומטי על סמך שיטות ניתוח כמו הדומיין של YouTube או מיקום כתובת ה-IP של המשתמש. משתמשים יכולים גם לבחור באופן ידני את אזור התוכן הרצוי בכותרת התחתונה של אתר YouTube.
כל משאב i18nRegion
מזהה קוד אזור ושם. אפשר להשתמש בקוד האזור כערך של הפרמטר regionCode
כשקוראים לשיטות API כמו search.list
, videos.list
, activities.list
ו-videoCategories.list
.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /i18nRegions |
הפונקציה מחזירה רשימה של אזורי תוכן שבהם האתר של YouTube תומך. |
חברי מועדון
משאב member
מייצג חבר במועדון של ערוץ YouTube. חברי מועדון נותנים תמיכה כספית קבועה ליוצרים ומקבלים הטבות מיוחדות. לדוגמה, חברי המועדון יכולים להתכתב בצ'אט כשהיוצר מפעיל את המצב 'צ'אט לחברי מועדון בלבד'.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימת המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /members |
רשימה של חברי מועדון (לשעבר 'נותני חסות') בערוץ. הבעלים של הערוץ צריך לאשר את בקשת ה-API. |
MembershipsLevels
משאב membershipsLevel
מזהה את רמת התמחור של היוצר שהעניק הרשאה לבקשת ה-API.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימת המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /membershipsLevels |
הפונקציה מחזירה אוסף של אפס משאבים או יותר מסוג membershipsLevel
שבבעלות הערוץ שהעניק הרשאה לבקשת ה-API. הרמות מוחזרות בסדר הצגה משתמע. |
PlaylistItems
משאב playlistItem
מזהה משאב אחר, כמו סרטון, שכלול בפלייליסט. בנוסף, המשאב playlistItem
מכיל פרטים על המשאב הכלול שקשורים באופן ספציפי לאופן שבו המשאב הזה משמש בפלייליסט.
מערכת YouTube משתמשת גם בפלייליסט כדי לזהות את רשימת הסרטונים שהועלו בערוץ, כאשר כל playlistItem
ברשימה מייצג סרטון אחד שהועלה. אפשר לאחזר את מזהה הפלייליסט של הרשימה הזו מהשדה channel resource
של ערוץ נתון. לאחר מכן תוכלו להשתמש בשיטה playlistItems.list
ברשימה.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /playlistItems |
מחיקת פריט מפלייליסט. |
insert |
POST /playlistItems |
הוספת משאב לפלייליסט. |
list |
GET /playlistItems |
הפונקציה מחזירה אוסף של פריטים בפלייליסט שתואמים לפרמטר הבקשה של ה-API. אפשר לאחזר את כל הפריטים בפלייליסט מסוים או פריט אחד או יותר בפלייליסט לפי המזהים הייחודיים שלהם. |
update |
PUT /playlistItems |
שינוי פריט בפלייליסט. לדוגמה, אפשר לעדכן את המיקום של הפריט בפלייליסט. |
פלייליסטים
משאב playlist
מייצג פלייליסט ב-YouTube. פלייליסט הוא אוסף של סרטונים שניתן לצפות בהם ברצף ולשתף עם משתמשים אחרים. כברירת מחדל, פלייליסטים גלויים לכולם, אבל אפשר להגדיר אותם כ'גלויים לכולם' או כ'פרטיים'.
מערכת YouTube משתמשת גם בפלייליסטים כדי לזהות אוספים מיוחדים של סרטונים בערוץ, כמו:
- סרטונים שהועלו
- סרטונים שקיבלו דירוג חיובי (סימן 'אהבתי')
- היסטוריית צפייה
- לצפייה בהמשך
channel resource
של ערוץ נתון.לאחר מכן תוכלו להשתמש בשיטה
playlistItems.list
כדי לאחזר כל אחת מהרשימות האלה. אפשר גם להוסיף או להסיר פריטים מהרשימות האלה באמצעות קריאה לשיטות playlistItems.insert
ו-playlistItems.delete
.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /playlists |
מחיקה של פלייליסט. |
list |
GET /playlists |
הפונקציה מחזירה אוסף של פלייליסטים שתואמים לפרמטר של בקשת ה-API. לדוגמה, אפשר לאחזר את כל הפלייליסטים שבבעלות המשתמש המאומת, או לאחזר פלייליסט אחד או יותר לפי המזהים הייחודיים שלהם. |
insert |
POST /playlists |
יצירת פלייליסט. |
update |
PUT /playlists |
שינוי פלייליסט. לדוגמה, אפשר לשנות את השם, התיאור או סטטוס הפרטיות של פלייליסט. |
חיפוש
תוצאת חיפוש מכילה מידע על סרטון, ערוץ או פלייליסט ב-YouTube שתואמים לפרמטרים של החיפוש שצוינו בבקשת ה-API. תוצאת חיפוש מפנה למשאב שניתן לזהות באופן ייחודי, כמו סרטון, אבל אין לה נתונים קבועים משלה.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /search |
הפונקציה מחזירה אוסף של תוצאות חיפוש שתואמות לפרמטר השאילתה שצוין בבקשת ה-API. כברירת מחדל, קבוצת תוצאות חיפוש מזהה משאבים תואמים מסוג video , channel ו-playlist , אבל אפשר גם להגדיר שאילתות כדי לאחזר רק סוג ספציפי של משאב. |
מינויים
משאב subscription
מכיל מידע על מינוי של משתמש ב-YouTube. מינוי מאפשר למשתמש לקבל התראות כשנוספים סרטונים חדשים לערוץ או כשמשתמש אחר מבצע אחת מכמה פעולות ב-YouTube, כמו העלאת סרטון, דירוג סרטון או הוספת תגובה לסרטון.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /subscriptions |
מחיקה של מינוי. |
insert |
POST /subscriptions |
הוספת מינוי לערוץ של המשתמש המאומת. |
list |
GET /subscriptions |
הפונקציה מחזירה משאבי מינויים שתואמים לקריטריונים של בקשת ה-API. |
תמונות ממוזערות
משאב thumbnail
מזהה גדלים שונים של תמונות ממוזערות שמשויכות למשאב. חשוב לשים לב למאפיינים הבאים של תמונות ממוזערות:
- המאפיין
snippet.thumbnails
של משאב הוא אובייקט שמזהה את התמונות הממוזערות שזמינות למשאב הזה. - משאב
thumbnail
מכיל סדרה של אובייקטים. השם של כל אובייקט (default
,medium
,high
וכו') מתייחס לגודל של התמונה הממוזערת. - סוגים שונים של משאבים עשויים לתמוך בגדלים שונים של תמונות ממוזערות.
- סוגים שונים של משאבים עשויים להגדיר גדלים שונים לתמונות ממוזערות עם אותו שם. לדוגמה, התמונה הממוזערת
default
של משאבvideo
היא בדרך כלל בגודל 120 על 90 פיקסלים, והתמונה הממוזערתdefault
של משאבchannel
היא בדרך כלל בגודל 88 על 88 פיקסלים. - יכול להיות שעדיין יהיו משאבים מאותו סוג עם גדלים שונים של תמונות ממוזערות לתמונות מסוימות, בהתאם לרזולוציה של התמונה המקורית או של התוכן שהועלה ל-YouTube. לדוגמה, סרטון HD עשוי לתמוך בתמונות ממוזערות ברזולוציה גבוהה יותר מאשר סרטונים באיכות אחרת.
- לכל אובייקט שמכיל מידע על גודל של תמונה ממוזערת יש מאפיין
width
ומאפייןheight
. עם זאת, יכול להיות שנכסי הרוחב והגובה לא יחזרו עבור התמונה הזו. - אם תמונה ממוזערת שהועלו לא תואמת למימדים הנדרשים, המערכת תשנה את גודל התמונה כך שתתאים לגודל הנכון, בלי לשנות את יחס הגובה-רוחב שלה. התמונה לא חתוכה, אבל יכול להיות שהיא תכלול פסים שחורים כדי שהגודל יהיה נכון.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
set |
POST /thumbnails/set |
הקוד מעלה תמונה ממוזערת מותאמת אישית של סרטון ל-YouTube ומגדיר אותה לסרטון. |
VideoAbuseReportReasons
משאב videoAbuseReportReason
מכיל מידע על הסיבה לסימון סרטון כי הוא מכיל תוכן פוגעני. כשהאפליקציה שלכם קוראת ל-method videos.reportAbuse
כדי לדווח על סרטון שמכיל תוכן פוגעני, הבקשה משתמשת במידע ממקור videoAbuseReportReason
כדי לזהות את הסיבה לדיווח על הסרטון.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /videoAbuseReportReasons |
אחזור רשימה של סיבות שאפשר להשתמש בהן כדי לדווח על סרטונים שמכילים תוכן פוגעני. |
VideoCategories
משאב videoCategory
מזהה קטגוריה ששויכה או שיכולה להיות משויכת לסרטונים שהועלו.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /videoCategories |
הפונקציה מחזירה רשימה של קטגוריות שאפשר לשייך לסרטונים ב-YouTube. |
סרטונים
משאב video
מייצג סרטון ב-YouTube.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
insert |
POST /videos |
העלאת סרטון ל-YouTube, ואפשרות להגדיר את המטא-נתונים של הסרטון. |
list |
GET /videos |
הפונקציה מחזירה רשימה של סרטונים שתואמים לפרמטרים של בקשת ה-API. |
delete |
DELETE /videos |
מחיקת סרטון ב-YouTube. |
update |
PUT /videos |
עדכון המטא-נתונים של סרטון. |
rate |
POST /videos/rate |
להוסיף לסרטון דירוג לייק או דיסלייק, או להסיר דירוג מסרטון. |
getRating |
GET /videos/getRating |
אחזור הדירוגים שהמשתמש המורשה נתן לרשימת סרטונים ספציפית. |
reportAbuse |
POST /videos/reportAbuse |
דיווח על סרטון שמכיל תוכן פוגע. |
סימני מים
משאב watermark
מזהה תמונה שמוצגת במהלך ההפעלה של סרטונים בערוץ מסוים. אתם יכולים גם לציין ערוץ יעד שאליו התמונה תקשר, ופרטים לגבי תזמון שיגדירו מתי סימן המים יופיע במהלך הפעלות של הסרטון ואת משך הזמן שבו הוא יהיה גלוי.
מידע נוסף על המשאב הזה זמין בייצוג המשאב וברשימה של המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
set |
POST /watermarks/set |
העלאת קובץ תמונה של סימן מים ל-YouTube והגדרתו לערוץ. |
unset |
POST /watermarks/unset |
מחיקת התמונה של סימן המים של הערוץ. |