העלאת קובץ של סימן מים ל-YouTube והגדרתו לערוץ.
השיטה הזו תומכת בהעלאת מדיה. הקבצים שהועלו צריכים לעמוד במגבלות הבאות:
- גודל קובץ מקסימלי: 10MB
- סוגי MIME מקובלים של מדיה:
image/jpeg, image/png, application/octet-stream
השפעה על המכסה: קריאה לשיטה הזו מחייבת עלות מכסה של 50 יחידות.
בקשה
בקשת HTTP
POST https://www.googleapis.com/upload/youtube/v3/watermarks/set
אישור
הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים. למידע נוסף על אימות והרשאות, קראו את המאמר הטמעת הרשאות OAuth 2.0.
| היקף |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמפורטים הם פרמטרים של שאילתות.
| פרמטרים | ||
|---|---|---|
| פרמטרים נדרשים | ||
channelId |
stringהפרמטר channelId מציין את מזהה ערוץ YouTube שעבורו סימן המים מסופק. |
|
| פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
stringהערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube. הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של הבקשה מזהים משתמש במערכת ניהול התוכן של YouTube שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן ב-YouTube שיש להם בעלות על ערוצי YouTube רבים ושהם מנהלים אותם. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי כניסה לכל ערוץ בנפרד. חשבון ה-CMS שבו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוין ב-YouTube. |
|
גוף הבקשה
מספקים משאב watermark בגוף הבקשה.
תשובה
אם הפעולה מצליחה, השיטה הזו מחזירה קוד סטטוס HTTP 204 No Content.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במאמר YouTube Data API – שגיאות.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
badRequest (400) |
imageFormatUnsupported |
התמונה שצירפת היא בפורמט שאינו נתמך. |
badRequest (400) |
imageTooTall |
התמונה שצירפת גבוהה מדי. |
badRequest (400) |
imageTooWide |
התמונה שצירפת רחבה מדי. |
badRequest (400) |
mediaBodyRequired |
הבקשה לא כוללת את תוכן התמונה. |
forbidden (403) |
forbidden |
לא ניתן להגדיר את סימן המים בערוץ שצוין. יכול להיות שהבקשה לא אושרה כראוי או שהפרמטר channelId מוגדר לערך לא חוקי. |
נסה בעצמך!
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה ואת התשובה של ה-API.