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.