API Reference

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

במדריך העזר הזה מוסבר איך להשתמש ב-API כדי לבצע את כל הפעולות האלה. המדריך מסודר לפי סוג המשאב. משאב מייצג סוג של פריט שמרכיבים חלק מחוויית השימוש ב-YouTube, למשל סרטון, פלייליסט או מינוי. לכל סוג משאב, המדריך מציג ייצוג אחד או יותר של נתונים, והמשאבים מיוצגים כאובייקטים של JSON. המדריך כולל גם שיטה נתמכת אחת או יותר (LIST, POST, DELETE וכו') לכל סוג משאב, ומסביר איך להשתמש בשיטות האלה באפליקציה שלכם.

קריאה ל-API

הדרישות הבאות חלות על בקשות של YouTube Data API:

  1. כל בקשה צריכה לציין מפתח API (עם הפרמטר key) או לספק אסימון OAuth 2.0. מפתח ה-API זמין בחלונית API Access במסוף המפתחים של הפרויקט.

  2. חובה לשלוח אסימון הרשאה לכל הוספה, עדכון ומחיקה של בקשה. בנוסף, צריך לשלוח אסימון הרשאה לכל בקשה שמאחזרת את הנתונים הפרטיים של המשתמש המאומת.

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

  3. ה-API תומך בפרוטוקול האימות OAuth 2.0. ניתן לספק אסימון OAuth 2.0 באחת מהדרכים הבאות:

    • צריך להשתמש בפרמטר השאילתה access_token באופן הבא: ?access_token=oauth2-token
    • יש להשתמש בכותרת HTTP Authorization כך: 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 לא מכילה את הכתוביות עצמן, ושהשיטה captions.download מספקת את האפשרות לאחזר רצועת כתוביות.
update PUT /captions עדכון רצועת כתוביות. כשמעדכנים טראק של כתוביות, אפשר לשנות את סטטוס הטיוטה של הטראק, להעלות קובץ כתוביות חדש עבור הטראק או את שניהם.

באנרים של ערוצים

משאב channelBanner מכיל את כתובת ה-URL שבה ייעשה שימוש כדי להגדיר תמונה חדשה שהועלתה כתמונת באנר של ערוץ.

למידע נוסף על המשאב הזה, כדאי לעיין בייצוג המשאבים וברשימת המאפיינים שלו.

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
insert POST /channelBanners/insert מעלה תמונת באנר של הערוץ ל-YouTube. השיטה הזו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של הערוץ:

  1. קוראים ל-method channelBanners.insert כדי להעלות את נתוני התמונה הבינארית ל-YouTube. התמונה צריכה להיות ביחס גובה-רוחב של 16:9 ובגודל של 2,048x1,152 פיקסלים לפחות. מומלץ להעלות תמונה בגודל 2560px על 1440px.
  2. מחלצים את הערך של המאפיין url מהתגובה שה-API מחזיר בשלב 1.
  3. צריך להפעיל את השיטה channels.update כדי לעדכן את הגדרות המיתוג של הערוץ. מגדירים את הערך של המאפיין brandingSettings.image.bannerExternalUrl לכתובת ה-URL שהתקבלה בשלב 2.

מדורי ערוצים

משאב 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, ושל מאפייני הצאצא שלהם.

שרשורי תגובות

משאב 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 שינוי התגובה.

קטגוריות של הנחיות

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

למידע נוסף על המשאב הזה, כדאי לעיין בייצוג המשאבים וברשימת המאפיינים שלו.

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /guideCategories הפונקציה מחזירה רשימת קטגוריות שניתן לשייך לערוצי YouTube.

I18nשפות

משאב i18nLanguage מזהה שפת אפליקציה שנתמכת באתר YouTube. שפת האפליקציה יכולה להיות גם שפת ממשק המשתמש. באתר YouTube, ניתן יהיה לבחור באופן אוטומטי שפת אפליקציה בהתאם להגדרות חשבון Google, לשפת הדפדפן או למיקום ה-IP. המשתמשים יכולים גם לבחור באופן ידני את שפת ממשק המשתמש הרצויה מהכותרת התחתונה של האתר ב-YouTube.

כל משאב של i18nLanguage מזהה קוד שפה ושם. ניתן להשתמש בקוד השפה כערך הפרמטר hl בקריאה ל-methods של API כמו videoCategories.list ו-guideCategories.list.

למידע נוסף על המשאב הזה, כדאי לעיין בייצוג המשאבים וברשימת המאפיינים שלו.

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /i18nLanguages מחזירה רשימה של שפות אפליקציה שנתמכות באתר YouTube.

אזור (I18nRegion)

משאב 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 חייבת לקבל אישור מהבעלים של הערוץ.

רמות במועדון החברים

משאב membershipsLevel מציין את רמת התמחור של היוצר שאישר את בקשת ה-API.

מידע נוסף על המשאב הזה זמין בייצוג המשאבים וברשימת המאפיינים שלו.

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /membershipsLevels הפונקציה מחזירה אוסף של אפס משאבי membershipsLevel או יותר שנמצאים בבעלות הערוץ שאישר את בקשת ה-API. הרמות מוחזרות בסדר תצוגה משתמע.

פריטים בפלייליסט

משאב 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. פלייליסט הוא אוסף של סרטונים שניתן לצפות בהם ברצף ולשתף עם משתמשים אחרים. פלייליסט יכול להכיל עד 200 סרטונים, ו-YouTube לא מגביל את מספר הפלייליסטים שכל משתמש יוצר. כברירת מחדל, פלייליסטים גלויים לכולם, אבל הם יכולים להיות גלויים לכולם או פרטיים.

המערכת של 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 היא בדרך כלל בגודל של 120px על 90px, וגודל התמונה default של משאב channel הוא בדרך כלל 88px על 88px.
  • למשאבים מאותו סוג עדיין יכולים להיות גדלים שונים של תמונות ממוזערות של תמונות מסוימות, בהתאם לרזולוציה של התמונה המקורית או של התוכן שהועלה ל-YouTube. לדוגמה: סרטון באיכות HD עשוי לתמוך בתמונות ממוזערות ברזולוציה גבוהה יותר מאשר בסרטונים שאינם HD.
  • לכל אובייקט שמכיל מידע על גודל של תמונה ממוזערת יש מאפיין width ומאפיין height. עם זאת, ייתכן שמאפייני הרוחב והגובה לא יוחזרו עבור תמונה זו.
  • אם תמונה ממוזערת שהועלתה לא תואמת למידות הנדרשות, גודל התמונה ישתנה בהתאם לגודל הנכון, בלי לשנות את יחס הגובה-רוחב שלה. התמונה לא חתוכה, אבל היא עשויה לכלול פסים שחורים כדי שהגודל יהיה נכון.

למידע נוסף על המשאב הזה, כדאי לעיין בייצוג המשאבים וברשימת המאפיינים שלו.

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
set POST /thumbnails/set מעלה ל-YouTube תמונה ממוזערת מותאמת אישית של סרטון ומגדיר אותה עבור סרטון.

VideoAbuseReportסיבות

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

למידע נוסף על המשאב הזה, כדאי לעיין בייצוג המשאבים וברשימת המאפיינים שלו.

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /videoAbuseReportReasons מאחזרים רשימה של סיבות שבהן ניתן להשתמש כדי לדווח על סרטונים פוגעניים.

קטגוריות וידאו

משאב 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 מחיקת תמונת סימן המים של הערוץ.