ממשק 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 |
עדכון רצועת כתוביות. כשמעדכנים טראק של כתוביות, אפשר לשנות את סטטוס הטיוטה של הטראק, להעלות קובץ כתוביות חדש עבור הטראק או את שניהם. |
באנרים של ערוצים
משאב channelBanner
מכיל את כתובת ה-URL שבה ייעשה שימוש כדי להגדיר תמונה חדשה שהועלתה כתמונת באנר של ערוץ.
למידע נוסף על המשאב הזה, כדאי לעיין בייצוג המשאבים וברשימת המאפיינים שלו.
שיטה | בקשת HTTP | תיאור |
---|---|---|
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3 |
||
insert |
POST /channelBanners/insert |
מעלה תמונת באנר של הערוץ ל-YouTube. השיטה הזו מייצגת את שני השלבים הראשונים בתהליך בן שלושה שלבים לעדכון תמונת הבאנר של הערוץ:
|
מדורי ערוצים
משאב 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 משתמשת גם בפלייליסטים כדי לזהות אוספים מיוחדים של סרטונים בערוץ, למשל:
- סרטונים שהועלו
- סרטונים עם דירוג חיובי (אהבתי)
- היסטוריית הצפייה
- לצפייה בהמשך
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 |
מחיקת תמונת סימן המים של הערוץ. |