ChannelSections: update

Aktualizuje sekcję kanału.

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu wynoszącym 50 jednostek.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym 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 są parametrami 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 będą 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 dotyczących filmów i kanałów 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.

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

    Jeśli przesyłasz prośbę o aktualizację i nie określisz w niej wartości właściwości, która już ma wartość, istniejąca wartość właściwości zostanie usunięta.

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 Tej sekcji kanału nie można edytować.
badRequest (400) typeRequired Zasób channelSection musi zawierać wartość pola 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 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 Zasób, który aktualizujesz, musi zawierać obiekt contentDetails w przypadku tego typu sekcji kanału.
invalidValue (400) idInvalid Właściwość id zawiera nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) idRequired Właściwość id musi zawierać wartość, która identyfikuje 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ż próbowało uwzględnić w sekcji kanału zbyt wiele kanałów.
invalidValue (400) maxPlaylistExceeded Żądanie nie zostało zrealizowane, ponieważ próbowało uwzględnić w sekcji kanału zbyt wiele playlist.
invalidValue (400) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi zawierać 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 zaktualizować 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, podają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) channelSectionNotFound Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.
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.