Playlists: update

שינוי פלייליסט. לדוגמה, אפשר לשנות את השם, התיאור או סטטוס הפרטיות של פלייליסט.

ההשפעה של המכסה: קריאה לשיטה הזו כוללת עלות מכסה של 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 שאפשר לכלול בערך הפרמטר:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
פרמטרים אופציונליים
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.