דף זה תורגם על ידי Cloud Translation API.

ChannelSections: update

מעדכן קטע בערוץ.

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

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

בקשה

בקשת HTTP

PUT 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.

גוף הבקשה

צריך לספק משאב 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)`	`idInvalid`	המאפיין `id` מציין מזהה קטע לא חוקי בערוץ.
`invalidValue (400)`	`idRequired`	המאפיין `id` חייב לציין ערך שמזהה את קטע הערוץ שמתעדכן.
`invalidValue (400)`	`inValidPosition`	המאפיין `snippet.position` מכיל ערך לא חוקי.
`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)`	`channelSectionNotFound`	קטע הערוץ שניסית לעדכן לא נמצא.
`notFound (404)`	`playlistNotFound`	לא ניתן למצוא אחד או יותר מהפלייליסטים שצוינו.

רוצה לנסות?

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