PlaylistItems: delete

Usuwa element playlisty.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

Typowe przypadki użycia

Prośba

Żądanie HTTP

DELETE https://www.googleapis.com/youtube/v3/playlistItems

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego 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 parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
id string
Parametr id określa identyfikator usuniętego elementu playlisty w YouTube. 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żna go używać tylko w przypadku prawidłowo autoryzowanych żądań.

Ten parametr jest przeznaczony dla partnerów w zakresie treści YouTube, którzy są właścicielami wielu różnych kanałów YouTube i zarządzają nimi. Umożliwia on użytkownikom powiązanym z właścicielem treści jednorazowe uwierzytelnienie się, a później uzyskiwanie dostępu do wszystkich filmów i danych kanału właściciela treści oraz zarządzanie nimi bez konieczności podawania danych uwierzytelniających dla każdego kanału.

Gdy ten parametr jest obecny, jego wartość określa właściciela treści, a dane logowania do autoryzacji żądania wskazują użytkownika YouTube upoważnionego do działania w imieniu tego właściciela treści. Konto, na którym użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w ustawieniach YouTube Studio.

Treść żądania

Nie podawaj treści żądania podczas wywoływania tej metody.

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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma prawidłowej autoryzacji do usunięcia określonego elementu playlisty.
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty określonego za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości usuwania filmów ze wskazanej playlisty. Nie możesz na przykład usunąć filmu z playlisty z przesłanymi filmami.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.