שינוי פלייליסט. לדוגמה, אפשר לשנות את השם, התיאור או סטטוס הפרטיות של פלייליסט.
ההשפעה של המכסה: קריאה לשיטה הזו כוללת עלות מכסה של 50 יחידות.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
PUT https://www.googleapis.com/youtube/v3/playlists
אישור
בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).
היקף |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.
פרמטרים | ||
---|---|---|
הפרמטרים הנדרשים | ||
part |
string הפרמטר part משרת שתי מטרות בפעולה זו. היא מזהה את המאפיינים שפעולת הכתיבה תגדיר, וגם את המאפיינים שייכללו בתגובת ה-API.לתשומת ליבך, השיטה הזו תבטל את הערכים הקיימים של מאפיינים שניתנים לשינוי, שנכללים בכל החלקים שגוף הבקשה מציין. לדוגמה: תיאור של פלייליסט נכלל בחלק snippet , שחייב להיכלל בגוף הבקשה. אם הבקשה לא מציינת ערך עבור המאפיין snippet.description , התיאור הקיים של הפלייליסט יימחק.הרשימה הבאה כוללת את שמות part שאפשר לכלול בערך הפרמטר:
|
|
פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
string ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube. הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של ההרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שהם הבעלים והמנהלים של ערוצי YouTube רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד. חשבון ה-CMS שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube. |
גוף הבקשה
צריך לספק משאב של הפלייליסט בגוף הבקשה. במשאב הזה:
-
צריך לציין ערך למאפיינים הבאים:
id
snippet.title
-
ניתן להגדיר ערכים למאפיינים הבאים:
snippet.title
snippet.description
status.privacyStatus
snippet.defaultLanguage
localizations.(key)
localizations.(key).title
localizations.(key).description
אם שולחים בקשה לעדכון, ובבקשה לא מצוין ערך לנכס שכבר יש לו ערך, הערך הקיים של הנכס יימחק.
תשובה
אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה משאב של הפלייליסט בגוף התשובה.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שה-API עלול להחזיר בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במסמכים בנושא הודעת שגיאה.
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את defaultLanguage כדי לעדכן את localizations . |
badRequest (400) |
localizationValidationError |
אחד הערכים באובייקט הלוקליזציה נכשל. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומקפידים לעדכן אותם לפי ההנחיות בתיעוד המשאבים של הפלייליסט. |
forbidden (403) |
playlistForbidden |
פעולה זו אסורה או שהבקשה אינה מורשית כראוי. |
invalidValue (400) |
invalidPlaylistSnippet |
הבקשה מספקת קטע טקסט לא חוקי של פלייליסט. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר id של הבקשה. |
required (400) |
playlistTitleRequired |
הבקשה חייבת לציין כותרת לפלייליסט. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך באפשרות לעדכן את הפלייליסט שצוין. לדוגמה, אי אפשר לעדכן את המאפיינים של הפלייליסט של הסרטונים שהעליתם. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.