Ta strona została przetłumaczona przez Cloud Translation API.

ChannelSections: update

Aktualizuje sekcję kanału.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

Parametry

W tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
`part`	`string` Parametr `part` służy w tej operacji do 2 celów. Określa właściwości, które ustawi operacja zapisu, a także właściwości uwzględnione w odpowiedzi interfejsu API. Na poniższej liście znajdziesz nazwy typu `part`, które możesz uwzględnić w wartości parametru: `contentDetails` `id` `snippet`
Parametry opcjonalne
`onBehalfOfContentOwner`	`string` Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla dostawców treści w YouTube. Parametr `onBehalfOfContentOwner` wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści YouTube.

Treść żądania

Podaj zasób channelsection w treści żądania. W przypadku tego zasobu:

Musisz podać wartość tych właściwości:
- snippet.type
Możesz ustawić wartości dla tych właściwości:
- snippet.type
- snippet.title
- snippet.position
- contentDetails.playlists[]
- contentDetails.channels[]
Jeśli przesyłasz prośbę o aktualizację usługi, która ma już wartość, ale nie jest w niej określona, obecna wartość usługi zostanie usunięta.

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób channelSection w treści odpowiedzi.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu	Szczegóły błędu	Opis
`badRequest (400)`	`notEditable`	Tej sekcji kanału nie można edytować.
`badRequest (400)`	`typeRequired`	Zasób `channelSection` musi określać wartość w polu `snippet.type`.
`forbidden (403)`	`channelSectionForbidden`	Żądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
`invalidValue (400)`	`channelNotActive`	Co najmniej jeden z podanych kanałów jest nieaktywny.
`invalidValue (400)`	`channelsDuplicated`	Żądanie nie zostało zrealizowane, ponieważ wskazano zduplikowane kanały.
`invalidValue (400)`	`channelsNeeded`	Jeśli właściwość `snippet.type` ma wartość `multipleChannels`, musisz określić właściwość `contentDetails.channels[]`, która musi określać co najmniej 1 kanał.
`invalidValue (400)`	`channelsNotExpected`	Zasób podany w żądaniu ma podaną wartość właściwości `contentDetails.channels[]`, ale w przypadku sekcji kanałów tego typu nie należy spodziewać się kanałów.
`invalidValue (400)`	`contentDetailsNeeded`	Zasób, który aktualizujesz, musi zawierać obiekt `contentDetails` dla tego typu sekcji kanału.
`invalidValue (400)`	`idInvalid`	Właściwość `id` określa nieprawidłowy identyfikator sekcji kanału.
`invalidValue (400)`	`idRequired`	Właściwość `id` musi określać wartość identyfikującą aktualizowaną sekcję kanału.
`invalidValue (400)`	`inValidPosition`	Właściwość `snippet.position` zawiera nieprawidłową wartość.
`invalidValue (400)`	`maxChannelsExceeded`	Żądanie nie zostało zrealizowane, ponieważ chciała uwzględnić zbyt wiele kanałów w sekcji kanałów.
`invalidValue (400)`	`maxPlaylistExceeded`	Żądanie nie zostało zrealizowane, ponieważ usiłowano uwzględnić zbyt wiele playlist w sekcji kanału.
`invalidValue (400)`	`onePlaylistNeeded`	Jeśli właściwość `snippet.type` ma wartość `singlePlaylist`, to właściwość `contentDetails.playlists[]` musi określać dokładnie 1 playlistę.
`invalidValue (400)`	`ownChannelInChannels`	Nie możesz dodać swojego kanału do sekcji kanału, która się na nim wyświetla.
`invalidValue (400)`	`playlistIsPrivate`	Co najmniej jedna z podanych playlist jest prywatna i dlatego nie można ich uwzględnić w sekcji kanału.
`invalidValue (400)`	`playlistsDuplicated`	Żądanie nie zostało zrealizowane, ponieważ wskazano zduplikowane playlisty.
`invalidValue (400)`	`playlistsNeeded`	Jeśli właściwość `snippet.type` ma wartość `singlePlaylist` lub `multiplePlaylists`, musisz określić właściwość `contentDetails.playlists[]`.
`invalidValue (400)`	`playlistsNotExpected`	Zasób podany w żądaniu ma podaną wartość właściwości `contentDetails.playlists[]`, ale w przypadku tego typu sekcji kanału nie należy tworzyć playlist.
`invalidValue (400)`	`snippetNeeded`	Aby zaktualizować sekcję kanału, musisz określić `snippet`.
`invalidValue (400)`	`titleLengthExceeded`	Wartość właściwości `snippet.title` jest za długa.
`invalidValue (400)`	`titleRequired`	Jeśli właściwość `snippet.type` ma wartość `multiplePlaylists` lub `multipleChannels`, musisz ustawić tytuł sekcji, podając wartość właściwości `snippet.title`.
`notFound (404)`	`channelNotFound`	Nie można znaleźć co najmniej jednego z podanych kanałów.
`notFound (404)`	`channelSectionNotFound`	Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.
`notFound (404)`	`playlistNotFound`	Nie można znaleźć co najmniej jednej z podanych playlist.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.