Playlists: update

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

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

תרחישים נפוצים לדוגמה

בקשה

בקשת HTTP

PUT https://www.googleapis.com/youtube/v3/playlists

אישור

הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים. למידע נוסף על אימות והרשאות, קראו את המאמר הטמעת הרשאות OAuth 2.0.

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

גוף הבקשה

מספקים משאב playlist בגוף הבקשה.

במשאב הזה:

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

    • id
    • snippet.title

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

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

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

תשובה

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

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במאמר YouTube Data API – שגיאות.

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSetError צריך להגדיר את defaultLanguage כך שיעדכן את localizations.
badRequest (400) localizationValidationError אחד מהערכים באובייקט localizations נכשל באימות. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומוודאים לעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה של משאב הפלייליסטים.
forbidden (403) playlistForbidden הפעולה אסורה או שהבקשה לא אושרה כראוי.
invalidValue (400) invalidPlaylistSnippet הבקשה כוללת קטע פלייליסט לא חוקי.
notFound (404) playlistNotFound לא ניתן למצוא את הפלייליסט שזוהה באמצעות הפרמטר id של הבקשה.
required (400) playlistTitleRequired בבקשה צריך לציין שם של פלייליסט.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות לעדכן את הפלייליסט שצוין. לדוגמה, אי אפשר לעדכן את המאפיינים של פלייליסט הסרטונים שהועלו.

נסה בעצמך!

משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה ואת התשובה של ה-API.