PlaylistItems: delete

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. Para obtener más información sobre la autenticación y la autorización, consulta Cómo implementar la autorización de OAuth 2.0.

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 playlist de YouTube que se está borrando. En un recurso playlistItem, la propiedad id especifica el ID del elemento de la playlist.
Parámetros opcionales
onBehalfOfContentOwner string
Nota: El parámetro onBehalfOfContentOwner está destinado exclusivamente a los socios de contenido de YouTube y solo se puede usar en una solicitud debidamente autorizada.

Este parámetro está diseñado para los socios de contenido de YouTube que poseen y administran muchos canales diferentes de YouTube. 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 individual.

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 del contenido. 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 la operación se realiza correctamente, este método muestra un código de estado 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. Para obtener más detalles, consulta API de YouTube Data: Errores.

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 playlist identificado con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de borrar videos de la playlist especificada. Por ejemplo, no puedes borrar un video de tu playlist de videos subidos.

Pruébalo

Usa el APIs Explorer para llamar a esta API y ver la solicitud a la API y la respuesta.