PlaylistItems: delete

Usuwa element z playlisty.

Wpływ na limit: wywołanie tej metody ma koszt związany z limitem wynoszący 50 jednostek.

Typowe zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzowaniu znajdziesz w artykule Wdrażanie autoryzacji OAuth 2.0.

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 elementu playlisty YouTube dla elementu playlisty, który ma zostać usunięty. 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 treści YouTube i może być używany tylko w ramach prawidłowo autoryzowanego żądania.

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

Jeśli parametr jest obecny, jego wartość identyfikuje właściciela treści, a dane logowania autoryzacji żądania identyfikują użytkownika YouTube, który jest upoważniony do działania w imieniu tego właściciela treści. Konto, za pomocą 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ę powiedzie, zwróci kod stanu 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 artykule Błędy w interfejsie YouTube Data API.

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible prośba nie jest odpowiednio upoważniona do usunięcia określonego elementu playlisty;
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty zidentyfikowanego za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości usuwania filmów z określonej playlisty. Nie możesz na przykład usunąć filmu z playlisty przesłanych filmów.

Wypróbuj

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