ChannelSections: delete

Usuwa 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

DELETE 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
id string
Parametr id określa identyfikator, który jednoznacznie identyfikuje usuwaną sekcję kanału. W zasobie channelSection właściwość id określa identyfikator sekcji.
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr można używać 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 logowania autoryzacji żą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 do 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

Podczas wywoływania tej metody nie podawaj treści żądania.

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 usunąć tej sekcji kanału.
forbidden (403) channelSectionForbidden Żądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego 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ść, która identyfikuje usuwaną sekcję kanału.
notFound (404) channelNotFound Nie znaleziono kanału.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.

Wypróbuj

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