PlaylistItems: delete

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.