Usunięcie playlisty.
Wpływ limitu: wywołanie tej metody ma limit kosztów wynoszący 50 jednostek.
Typowe przypadki użycia
Żądanie
Żądanie HTTP
DELETE https://www.googleapis.com/youtube/v3/playlists
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 | ||
id |
string Parametr id określa identyfikator playlisty YouTube, która jest usuwana. W zasobie playlist właściwość id określa identyfikator playlisty. |
|
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. |
Treść żądania
Podczas wywoływania tej metody nie podawaj treści żądania.
Odpowiedź
Jeśli operacja się uda, metoda zwróci kod odpowiedzi HTTP 204
(No Content
).
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 |
---|---|---|
forbidden (403) |
playlistForbidden |
Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje usuwania określonej playlisty. Nie możesz na przykład usunąć przesłanej playlisty filmów. |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.