‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ChannelSections: update

עדכון של אוסף בערוץ.

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

גוף הבקשה

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

חובה לציין ערך למאפיינים האלה:
- snippet.type
אפשר להגדיר ערכים למאפיינים הבאים:
- snippet.type
- snippet.title
- snippet.position
- contentDetails.playlists[]
- contentDetails.channels[]
אם אתם שולחים בקשת עדכון, ובבקשה לא מצוין ערך למאפיין שכבר יש לו ערך, הערך הקיים של המאפיין יימחק.

תשובה

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

שגיאות

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

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

ChannelSections: update קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.