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

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

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

גוף הבקשה

מציינים משאב channelSection בגוף הבקשה. למשאב הזה:

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

    • snippet.type

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

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

תשובה

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

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שיכולות להתקבל מה-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 והתגובה.