Elimina un elemento de una lista de reproducción.
Impacto en la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.
Casos de uso habituales
Solicitud
Solicitud HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).
Alcance |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parámetros
En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.
Parámetros | ||
---|---|---|
Parámetros obligatorios | ||
id |
string El parámetro id especifica el ID del elemento de la lista de reproducción de YouTube del elemento que se borrará. En un recurso playlistItem , la propiedad id especifica el ID del elemento de la lista de reproducción. |
|
Parámetros opcionales | ||
onBehalfOfContentOwner |
string Nota: El parámetro onBehalfOfContentOwner está dirigido exclusivamente a socios de contenido de YouTube y solo se puede utilizar en una solicitud autorizada debidamente.Este parámetro está diseñado para socios de contenido de YouTube que poseen y administran muchos canales de YouTube diferentes. Permite que los usuarios afiliados al propietario del contenido se autentiquen una vez y, luego, puedan acceder y administrar todos los datos de video y del canal del propietario del contenido, sin tener que proporcionar credenciales de autenticación para cada canal. Cuando el parámetro está presente, su valor identifica a un propietario del contenido, y las credenciales de autorización de la solicitud identifican a un usuario de YouTube que está autorizado para actuar en nombre de ese propietario. La cuenta con la que se autentica el usuario debe estar vinculada al propietario del contenido especificado en la configuración de YouTube Creator Studio. |
Cuerpo de la solicitud
No proporciones un cuerpo de solicitud cuando invoques este método.
Respuesta
Si se aplica correctamente, este método muestra un código de respuesta HTTP 204
(No Content
).
Errores
En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.
Tipo de error | Detalle del error | Descripción |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
La solicitud no está debidamente autorizada para eliminar el elemento de la lista de reproducción especificada. |
notFound (404) |
playlistItemNotFound |
No se puede encontrar el elemento de la lista de reproducción identificado con el parámetro id de la solicitud. |
invalidValue (400) |
playlistOperationUnsupported |
La API no permite borrar videos de la lista de reproducción especificada. Por ejemplo, no puedes borrar un video de la lista de reproducción que subiste. |
Pruébela.
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.