PlaylistImages: insert

הוספת תמונה לפלייליסט.

השיטה הזו תומכת בהעלאה של מדיה. הקבצים שהועלו חייבים לעמוד במגבלות הבאות:

  • גודל קובץ מקסימלי: 2MB
  • יחס גובה-רוחב קביל: 1:1 (ריבוע)
  • סוגי MIME של מדיה קבילים: image/jpeg, image/png

השפעה על המכסה: לקריאה לשיטה הזו יש עלות מכסה של 50 יחידות.

בקשה

בקשת HTTP

POST https://www.googleapis.com/youtube/v3/playlistImages

אישור

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

היקף
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שנתמכים בשאילתה הזו. כל הפרמטרים הרשומים הם פרמטרים של שאילתות.

פרמטרים
פרמטרים נדרשים
part string

הפרמטר part מציין רשימה מופרדת בפסיקים של משאב playlistImage אחד או יותר מאפיינים שתגובת ה-API תכלול.

אם הפרמטר מזהה נכס שמכיל נכסי צאצא, את נכסי הצאצאים. ייכללו בתשובה.
פרמטרים אופציונליים
onBehalfOfContentOwner string
ניתן להשתמש בפרמטר הזה רק בבקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

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

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

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

גוף הבקשה

מספקים מקור מידע מיומן Google Slides בגוף הבקשה.

לגבי המשאב הזה:

  • צריך לציין ערך למאפיינים הבאים:

    • snippet.playlistId
    • snippet.type

  • אפשר להגדיר ערכים לנכסים הבאים:

    • snippet.width
    • snippet.height

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב של התכונה 'תמונות' בגוף התשובה.