Usunięcie elementu 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/playlistItems
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 elementu playlisty YouTube, który jest usuwany. W zasobie playlistItem właściwość id określa identyfikator elementu playlisty. |
|
Parametry opcjonalne | ||
onBehalfOfContentOwner |
string Uwaga: parametr onBehalfOfContentOwner jest przeznaczony wyłącznie dla partnerów w zakresie treści w YouTube i może być używany tylko w przypadku odpowiednio autoryzowanego żądania.Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia użytkownikom powiązanym z właścicielem treści uwierzytelnianie raz, a następnie może uzyskiwać dostęp do wszystkich filmów i kanału właściciela treści oraz zarządzać nimi bez konieczności podawania danych uwierzytelniających dla każdego kanału. Gdy ten parametr jest obecny, jego wartość identyfikuje właściciela treści, a w żądaniach autoryzacji znajduje się użytkownik YouTube, który jest upoważniony do występowania w imieniu właściciela treści. Konto, z którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w ustawieniach YouTube Studio. |
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) |
playlistItemsNotAccessible |
Żądanie nie jest prawidłowo autoryzowane do usunięcia wskazanego elementu playlisty. |
notFound (404) |
playlistItemNotFound |
Nie można znaleźć elementu playlisty z parametrem id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje usuwania filmów z określonej playlisty. Nie możesz np. usunąć filmu z przesłanej playlisty. |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.