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 רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ שלהם, בלי שיצטרכו לספק פרטי כניסה לאימות לכל ערוץ בנפרד. חשבון מערכת ניהול התוכן שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube.

גוף הבקשה

מזינים משאב של פלייליסט בגוף הבקשה. לגבי המשאב הזה:

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

    • id
    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

תשובה

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

שגיאות

הטבלה הבאה מזהה את הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. אפשר לקרוא פרטים נוספים בתיעוד של הודעות שגיאה.

סוג השגיאה פרטי השגיאה תיאור
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 והתגובה.