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 Creator Studio.

גוף הבקשה

מציינים משאב playlistImages בגוף הבקשה.

במשאב הזה:

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

תשובה

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