דף זה תורגם על ידי Cloud Translation API.

API Reference

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

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

קריאה ל-API

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

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

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

ChannelBanners

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

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

שיטה בקשת HTTP תיאור

שיטה	בקשת HTTP	תיאור
מזהי URI ביחס ל-`https://www.googleapis.com/youtube/v3`
`insert`	`POST /channelBanners/insert`	מעלה תמונת באנר של הערוץ ל-YouTube. שיטה זו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של ערוץ: צריך להפעיל את השיטה `channelBanners.insert` כדי להעלות את נתוני התמונה הבינארית ל-YouTube. התמונה צריכה להיות ביחס גובה-רוחב של 16:9 ובגודל של 2,048x1152 פיקסלים לפחות. מומלץ להעלות תמונה בגודל של 2560 על 1440 פיקסלים. מחלצים את הערך של המאפיין `url` מהתשובה שה-API מחזיר עבור שלב 1. צריך להפעיל את השיטה `channels.update` כדי לעדכן את הגדרות המיתוג של הערוץ. מגדירים את ערך הנכס ב-`brandingSettings.image.bannerExternalUrl` לכתובת ה-URL שהתקבלה בשלב 2.

מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3

insert

POST /channelBanners/insert

מעלה תמונת באנר של הערוץ ל-YouTube. שיטה זו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של ערוץ:

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

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

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

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

VideoAbuseReportReasons

משאב של videoAbuseReportReason מכיל מידע על הסיבה שסרטון יסומן כמכיל תוכן פוגעני. כשהאפליקציה שולחת קריאה לשיטה 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`	מחיקת תמונת סימן המים של הערוץ.