PlaylistItems: insert

Agrega un recurso a una lista de reproducción. Pruébalo ahora.

Solicitud

Solicitud HTTP

POST 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

Parámetros

La tabla a continuación muestra los parámetros compatibles con esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
part string
El parámetro part sirve para dos propósitos en esta operación. Identifica las propiedades que establecerá la operación de escritura, así como las propiedades que incluirá la respuesta de la API.

Los nombres de part que se pueden incluir en el valor del parámetro son snippet, contentDetails y status.

Cuerpo de la solicitud

Proporciona un recurso playlistItem en el cuerpo de la solicitud. Para ese recurso:

  • Debes especificar un valor para estas propiedades:

    • snippet.playlistId
    • snippet.resourceId

  • Puedes establecer los valores de las siguientes propiedades:

    • snippet.playlistId
    • snippet.position
    • snippet.resourceId
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

Respuesta

Si se aplica correctamente, este método muestra un recurso playlistItem en el cuerpo de la respuesta.

Errores

En la tabla a continuación se identifican los mensajes de error que la API podría mostrar en respuesta a una invocación 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
duplicate videoAlreadyInPlaylist El video que intentas agregar a la lista de reproducción ya está en ella.
forbidden playlistContainsMaximumNumberOfVideos La lista de reproducción ya contiene el número máximo permitido de elementos.
invalidValue invalidPlaylistItemPosition La solicitud intenta establecer la posición del elemento de la lista de reproducción en un valor no válido o no admitido. Comprueba el valor de la propiedad de position en el snippet del recurso.
invalidValue invalidResourceType El type especificado para el ID de recurso no se admite en esta operación. El ID identifica el elemento que se agrega a la lista de reproducción, por ejemplo, youtube#video.
notFound playlistNotFound No se puede encontrar la lista de reproducción identificada con el parámetro playlistId de la solicitud.
notFound videoNotFound El video que intentas agregar a la lista de reproducción no se puede encontrar. Comprueba el valor de la propiedad videoId para asegurarte de que sea correcto.
required channelIdRequired La solicitud no especifica un valor para la propiedad channelId requerida.
required playlistIdRequired La solicitud no especifica un valor para la propiedad playlistId requerida.
required resourceIdRequired La solicitud debe contener un recurso en el que el objeto snippet especifique un resourceId.

¡Pruébalo!

Utiliza el Explorador de la API para invocar este método con datos en directo y ver la solicitud y la respuesta de la API.