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

ChannelSections: insert

Dodaje sekcję kanału do kanału uwierzytelnionego użytkownika. Na kanale można utworzyć maksymalnie 10 półek.

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

Typowe przypadki użycia

Prośba

Żądanie HTTP

POST 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.
`onBehalfOfContentOwnerChannel`	`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 `onBehalfOfContentOwnerChannel` określa identyfikator kanału w YouTube, do którego jest dodawany film. Ten parametr jest wymagany, gdy w żądaniu określona jest wartość parametru `onBehalfOfContentOwner` i można go używać tylko w połączeniu z tym parametrem. Prośba musi być dodatkowo autoryzowana za pomocą konta CMS połączonego z właścicielem treści określonym w parametrze `onBehalfOfContentOwner`. Kanał wskazany za pomocą parametru `onBehalfOfContentOwnerChannel` musi być połączony z właścicielem treści określonym w parametrze `onBehalfOfContentOwner`. Ten parametr jest przeznaczony dla partnerów dostarczających treści do YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Pozwala właścicielom treści jednorazowo uwierzytelnić się i wykonywać działania w imieniu kanału określonego w wartości parametru bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna.

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[]

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`	Nie można utworzyć tej sekcji kanału.
`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`	Wstawiony zasób musi zawierać obiekt `contentDetails` dla tego typu sekcji kanału.
`invalidValue (400)`	`inValidPosition`	Właściwość `snippet.position` zawiera nieprawidłową wartość.
`invalidValue (400)`	`maxChannelSectionExceeded`	Nie można zrealizować tej prośby, ponieważ kanał ma już maksymalną liczbę sekcji.
`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 utworzyć 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)`	`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.