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.