此页面由 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 内容管理系统用户。此参数适用于拥有和管理众多不同 YouTube 频道的 YouTube 内容合作伙伴。它可让内容所有者在一次身份验证后获得访问其所有视频和频道数据的权限，而无需为每个频道提供身份验证凭据。用户进行身份验证时所用的 CMS 账号必须与指定的 YouTube 内容所有者相关联。

请求正文

在请求正文中提供 channelSection 资源。针对该资源：

您必须为以下属性指定一个值：
- snippet.type
您可以为以下属性设置值：
- snippet.type
- snippet.title
- snippet.position
- contentDetails.playlists[]
- contentDetails.channels[]
如果您要提交更新请求，但您的请求没有为已经包含某个值的属性值指定值，则该属性的现有值将被删除。

响应

如果成功，此方法将在响应正文中返回 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)`	`idInvalid`	`id` 属性指定的频道版块 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 请求和响应。