Aktualizujemy interfejs Data API, aby był zgodny ze sposobem zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
PlaylistImages: delete
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Usuwa obraz playlisty.
Wpływ limitu: wywołanie tej metody ma limit wynoszący 50 jednostek.
Żądanie
Żądanie HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistImages
Autoryzacja
To żądanie wymaga autoryzacji przy użyciu co najmniej 1 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 obrazu playlisty YouTube, który jest powiązany z usuwanym obrazem playlisty. W zasobie playlistImages właściwość id określa identyfikator obrazu playlisty. |
Parametry opcjonalne |
onBehalfOfContentOwner |
string ,
Uwaga: parametr onBehalfOfContentOwner jest przeznaczony wyłącznie dla dostawców treści w YouTube i można go użyć tylko w przypadku odpowiednio autoryzowanego żądania.
Ten parametr jest przeznaczony dla dostawców treści w YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia użytkownikom powiązanym z właścicielem treści jednorazowe uwierzytelnienie się, dzięki czemu mogą uzyskać dostęp do wszystkich danych filmów i kanałów właściciela treści oraz nimi zarządzać bez konieczności podawania danych uwierzytelniających każdego kanału.
Gdy jest dostępny parametr, jego wartość identyfikuje właściciela treści, a dane autoryzacji żądania identyfikują użytkownika YouTube, który jest upoważniony do działania w imieniu właściciela treści. Konto, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w ustawieniach YouTube Studio. |
Treść żądania
Nie podawaj treści żądania przy wywoływaniu tej metody.
Odpowiedź
Jeśli operacja się uda, metoda zwróci kod odpowiedzi HTTP 204
(No Content
).
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-08-16 UTC.
[null,null,["Ostatnia aktualizacja: 2024-08-16 UTC."],[[["\u003cp\u003eThis method allows for the deletion of a playlist image using the YouTube Data API.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a playlist image requires authorization with one of the specified scopes, including \u003ccode\u003eyoutubepartner\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eid\u003c/code\u003e parameter is mandatory and specifies the unique ID of the playlist image to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method has a quota cost of 50 units per request.\u003c/p\u003e\n"],["\u003cp\u003eContent partners managing multiple channels can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter to manage their data.\u003c/p\u003e\n"]]],["This method deletes a specific playlist image on YouTube, identified by its `id`. The request is made via a `DELETE` HTTP request to the `/playlistImages` endpoint. Authorization is required, using one of the specified scopes. A `quota cost` of 50 units is associated with each call. An optional parameter, `onBehalfOfContentOwner`, allows content partners to manage data across multiple channels. Upon successful deletion, a `204` response code is returned. No request body is needed.\n"],null,["# PlaylistImages: delete\n\nDeletes a playlist image.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nDELETE https://www.googleapis.com/youtube/v3/playlistImages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/guides/authentication)).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `id` | `string` The **id** parameter specifies the YouTube playlist image ID for the playlist image that is being deleted. In a `playlistImages` resource, the `id` property specifies the playlist image's ID. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\n\n### Request body\n\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204` response code (`No Content`)."]]