ChannelSections: insert

הוספת קטע ערוץ לערוץ של המשתמש המאומת. ערוץ יכול ליצור עד 10 מדפים.

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

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

בקשה

בקשת HTTP

POST https://www.googleapis.com/youtube/v3/channelSections

אישור

בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.

פרמטרים
הפרמטרים הנדרשים
part string
הפרמטר part משרת שתי מטרות בפעולה זו. היא מזהה את המאפיינים שפעולת הכתיבה תגדיר, וגם את המאפיינים שייכללו בתגובת ה-API.

הרשימה הבאה מכילה את שמות part שניתן לכלול בערך הפרמטר:
  • contentDetails
  • id
  • snippet
פרמטרים אופציונליים
onBehalfOfContentOwner string
ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של ההרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שהם הבעלים והמנהלים של ערוצי YouTube רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד. חשבון ה-CMS שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube.
onBehalfOfContentOwnerChannel string
ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

הפרמטר onBehalfOfContentOwnerChannel מציין את מזהה ערוץ YouTube של הערוץ שאליו מוסיפים את הסרטון. הפרמטר הזה נדרש כאשר בקשה מציינת ערך לפרמטר onBehalfOfContentOwner, ואפשר להשתמש בו רק בשילוב עם הפרמטר הזה. בנוסף, יש לאשר את הבקשה באמצעות חשבון CMS שמקושר לבעלי התוכן בפרמטר onBehalfOfContentOwner. לבסוף, הערוץ שצוין בערך הפרמטר onBehalfOfContentOwnerChannel חייב להיות מקושר לבעלי התוכן שהפרמטר onBehalfOfContentOwner מציין.

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

גוף הבקשה

צריך לספק משאב Channel section בגוף הבקשה. במשאב הזה:

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

    • snippet.type

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

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) notEditable לא ניתן ליצור את הקטע הזה בערוץ.
badRequest (400) typeRequired המשאב channelSection חייב לציין ערך עבור השדה snippet.type.
forbidden (403) channelSectionForbidden הבקשה לא מאומתת כראוי או שאינה נתמכת בערוץ הזה.
invalidValue (400) channelNotActive לפחות אחד מהערוצים שצוינו אינו פעיל.
invalidValue (400) channelsDuplicated הבקשה נכשלה כי צוינו ערוצים כפולים.
invalidValue (400) channelsNeeded אם למאפיין snippet.type יש ערך של multipleChannels, צריך לציין את המאפיין contentDetails.channels[] ולציין לפחות ערוץ אחד.
invalidValue (400) channelsNotExpected במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.channels[], אבל לא צפויים ערוצים עבור סוג הערוץ הזה.
invalidValue (400) contentDetailsNeeded המשאב שברצונך להוסיף חייב להכיל אובייקט contentDetails עבור סוג הערוץ הזה.
invalidValue (400) inValidPosition המאפיין snippet.position מכיל ערך לא חוקי.
invalidValue (400) maxChannelSectionExceeded לא ניתן להשלים את הבקשה כי בערוץ כבר יש את המספר המקסימלי של אוספים בערוץ.
invalidValue (400) maxChannelsExceeded הבקשה נכשלה כי ניסתה לכלול יותר מדי ערוצים בקטע הערוצים.
invalidValue (400) maxPlaylistExceeded הבקשה נכשלה כי ניסתה לכלול יותר מדי פלייליסטים בקטע הערוץ.
invalidValue (400) onePlaylistNeeded אם למאפיין snippet.type יש את הערך singlePlaylist, המאפיין contentDetails.playlists[] צריך לציין פלייליסט אחד בדיוק.
invalidValue (400) ownChannelInChannels לא ניתן לכלול את הערוץ שלכם בקטע שמופיע בערוץ הזה בערוץ.
invalidValue (400) playlistIsPrivate אחד או יותר מהפלייליסטים שצוינו הם פרטיים, ולכן לא ניתן לכלול אותם בקטע הערוץ.
invalidValue (400) playlistsDuplicated הבקשה נכשלה כי צוינו פלייליסטים כפולים.
invalidValue (400) playlistsNeeded אם למאפיין snippet.type יש ערך של singlePlaylist או multiplePlaylists, צריך לציין את המאפיין contentDetails.playlists[].
invalidValue (400) playlistsNotExpected במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.playlists[], אבל לא צריך להשתמש בפלייליסטים בקטעים מהסוג הזה בערוצים.
invalidValue (400) snippetNeeded יש לציין snippet כדי ליצור את הקטע בערוץ.
invalidValue (400) titleLengthExceeded הערך של המאפיין snippet.title ארוך מדי.
invalidValue (400) titleRequired אם למאפיין snippet.type יש ערך של multiplePlaylists או multipleChannels, צריך לציין ערך עבור המאפיין snippet.title כדי להגדיר את כותרת הקטע.
notFound (404) channelNotFound לא ניתן למצוא אחד או יותר מהערוצים שצוינו.
notFound (404) playlistNotFound לא ניתן למצוא אחד או יותר מהפלייליסטים שצוינו.

רוצה לנסות?

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