ChannelSections: insert

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

Wpływ na limit: wywołanie tej metody kosztuje 50 jednostek limitu.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

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 listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry to parametry zapytania.

Parametry
Parametry wymagane
part string
Parametr part pełni w tej operacji 2 funkcje. Określa właściwości, które zostaną ustawione przez operację zapisu, oraz właściwości, które zostaną uwzględnione w odpowiedzi interfejsu API.

Poniżej znajdziesz listę part nazw, 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 prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów YouTube zajmujących się treściami, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia on właścicielom treści jednorazowe uwierzytelnienie i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, 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 prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwnerChannel określa identyfikator kanału YouTube, do którego dodawany jest film. Ten parametr jest wymagany, gdy żądanie określa wartość parametru onBehalfOfContentOwner, i może być używany tylko w połączeniu z tym parametrem. Ponadto żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści określonym w parametrze onBehalfOfContentOwner. Na koniec kanał określony w wartości parametru onBehalfOfContentOwnerChannel musi być połączony z właścicielem treści określonym w parametrze onBehalfOfContentOwner.

Ten parametr jest przeznaczony dla partnerów YouTube zajmujących się treściami, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia on właścicielom treści jednorazowe uwierzytelnienie 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.

Treść żądania

W treści żądania podaj zasób channelSection. W przypadku tego zasobu:

  • Musisz podać 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 w treści odpowiedzi zasób channelSection.

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 zawierać wartość pola 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 1 z określonych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, należy określić właściwość contentDetails.channels[] i podać co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu zawierał wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału kanały nie są oczekiwane.
invalidValue (400) contentDetailsNeeded Wstawiany zasób musi zawierać obiekt contentDetails w przypadku tego typu sekcji kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelSectionExceeded Nie można zrealizować żądania, ponieważ kanał ma już maksymalną liczbę sekcji.
invalidValue (400) maxChannelsExceeded Żądanie nie zostało zrealizowane, ponieważ próbowało uwzględnić zbyt wiele kanałów w sekcji kanału.
invalidValue (400) maxPlaylistExceeded Żądanie nie zostało zrealizowane, ponieważ próbowało uwzględnić zbyt wiele playlist w sekcji kanału.
invalidValue (400) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę.
invalidValue (400) ownChannelInChannels Nie możesz uwzględnić własnego kanału w sekcji kanału, która pojawia się na tym kanale.
invalidValue (400) playlistIsPrivate Co najmniej 1 z określonych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału.
invalidValue (400) playlistsDuplicated Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty.
invalidValue (400) playlistsNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy określić właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału playlisty nie są oczekiwane.
invalidValue (400) snippetNeeded Aby utworzyć sekcję kanału, musisz określić snippet.
invalidValue (400) titleLengthExceeded Wartość właściwości snippet.title jest zbyt długa.
invalidValue (400) titleRequired Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, określając wartość właściwości snippet.title.
notFound (404) channelNotFound Nie można znaleźć co najmniej 1 z określonych kanałów.
notFound (404) playlistNotFound Nie można znaleźć co najmniej 1 z określonych playlist.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.