PlaylistImages: update

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

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

בקשה

בקשת HTTP

PUT 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
הערה: הפרמטר onBehalfOfContentOwner מיועד אך ורק לשותפי תוכן של YouTube, ואפשר להשתמש בו רק בבקשה מורשית מתאימה.

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

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

גוף הבקשה

מזינים מקור מידע מיומן פלייליסטים בגוף הבקשה.

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

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

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

    • snippet.width
    • snippet.height

תשובה

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