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

ChannelSections: insert

Dodaje sekcję kanału do kanału uwierzytelnionego użytkownika. Kanał może mieć maksymalnie 10 półek.

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

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z co najmniej jednym z poniższych 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 poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
`part`	`string` Parametr `part` spełnia 2 cele w tej operacji. Określa właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie uwzględniać odpowiedź interfejsu API. Ta lista zawiera nazwy `part`, które możesz uwzględnić w wartości parametru: `contentDetails` `id` `snippet`
Parametry opcjonalne
`onBehalfOfContentOwner`	`string` Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube. Parametr `onBehalfOfContentOwner` wskazuje, że dane logowania żądania autoryzacji to użytkownik YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelni, musi być połączone z określonym właścicielem treści w YouTube.
`onBehalfOfContentOwnerChannel`	`string` Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony tylko dla dostawców treści w YouTube. Parametr `onBehalfOfContentOwnerChannel` określa identyfikator kanału YouTube, do którego jest dodawany film. Ten parametr jest wymagany, gdy żądanie określa wartość parametru `onBehalfOfContentOwner` i można go używać tylko w połączeniu z tym parametrem. Dodatkowo żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści, które jest określone w parametrze `onBehalfOfContentOwner`. Na koniec kanał, który określa parametr `onBehalfOfContentOwnerChannel`, musi być powiązany z właścicielem treści, który jest określony przez parametr `onBehalfOfContentOwner`. Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie raz i wykonywanie działań 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. Dla tego zasobu:

Musisz określić wartość tych właściwości:
- snippet.type
Możesz ustawić wartości tych właściwości:
- snippet.type
- snippet.title
- snippet.position
- contentDetails.playlists[]
- contentDetails.channels[]

Odpowiedź

Jeśli operacja się uda, ta 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 informacji 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 zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
`invalidValue (400)`	`channelNotActive`	Co najmniej 1 z podanych kanałów nie jest aktywny.
`invalidValue (400)`	`channelsDuplicated`	Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane kanały.
`invalidValue (400)`	`channelsNeeded`	Jeśli właściwość `snippet.type` ma wartość `multipleChannels`, musisz określić właściwość `contentDetails.channels[]` oraz co najmniej 1 kanał.
`invalidValue (400)`	`channelsNotExpected`	Zasób podany w żądaniu określa wartość właściwości `contentDetails.channels[]`, ale kanały nie są przeznaczone do tego typu kanału.
`invalidValue (400)`	`contentDetailsNeeded`	Wstawiony zasób musi zawierać obiekt `contentDetails` dla tego typu kanału.
`invalidValue (400)`	`inValidPosition`	Właściwość `snippet.position` zawiera nieprawidłową wartość.
`invalidValue (400)`	`maxChannelSectionExceeded`	Nie można przetworzyć żądania, ponieważ kanał ma już maksymalną liczbę sekcji.
`invalidValue (400)`	`maxChannelsExceeded`	Nie udało się dodać zbyt wielu kanałów do sekcji kanału.
`invalidValue (400)`	`maxPlaylistExceeded`	Nie udało się dodać zbyt wielu playlist do 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 jedną playlistę.
`invalidValue (400)`	`ownChannelInChannels`	Nie możesz umieścić własnego kanału w sekcji, która pojawia się na nim.
`invalidValue (400)`	`playlistIsPrivate`	Co najmniej jedna z określonych playlist jest prywatna i dlatego nie można jej dodać do sekcji kanału.
`invalidValue (400)`	`playlistsDuplicated`	Żądanie nie zostało zrealizowane, ponieważ określono 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`	W zasobie podanym w żądaniu określono wartość właściwości `contentDetails.playlists[]`, ale w przypadku tego typu sekcji kanału nie należy oczekiwać 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 określić tytuł sekcji, podając wartość właściwości `snippet.title`.
`notFound (404)`	`channelNotFound`	Nie udało się znaleźć co najmniej jednego z podanych kanałów.
`notFound (404)`	`playlistNotFound`	Nie udało się znaleźć co najmniej jednej z określonych playlist.

Wypróbuj

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