Sube una pista de subtítulos.
Este método admite la carga de medios. Los archivos cargados deben cumplir con los siguientes requisitos:
- Tamaño máximo de los archivos: 100 MB
- Tipos de MIME multimedia aceptados:
text/xml
,application/octet-stream
,*/*
Impacto de la cuota: Una llamada a este método tiene un costo de cuota de 400 unidades.
Casos de uso habituales
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/upload/youtube/v3/captions
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/youtube.force-ssl |
https://www.googleapis.com/auth/youtubepartner |
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 | ||
part |
string El parámetro part especifica las partes de los recursos caption que incluirá la respuesta de la API. Establece el valor del parámetro en snippet .La siguiente lista contiene los nombres de part que puedes incluir en el valor del parámetro:
|
|
Parámetros opcionales | ||
onBehalfOfContentOwner |
string Este parámetro solo se puede usar en una solicitud autorizada debidamente. Nota: Este parámetro está dirigido exclusivamente a socios de contenido de YouTube. El parámetro onBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario de CMS de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro. Este parámetro está dirigido a socios de contenido de YouTube que poseen y administran varios canales de YouTube diferentes. Permite a los propietarios de contenido autenticarse una vez y acceder a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal. La cuenta de CMS con la que se autentica el usuario debe estar relacionada con el propietario del contenido de YouTube especificado. |
|
sync |
boolean Este parámetro dejó de estar disponible. El parámetro sync indica si YouTube debe sincronizar automáticamente el archivo de subtítulos con la pista de audio del video. Si estableces el valor en true , YouTube ignorará los códigos de tiempo del archivo de subtítulos que subiste y generará códigos de tiempo nuevos para los subtítulos.Debes configurar el parámetro sync como true si estás subiendo una transcripción sin códigos de tiempo o si sospechas que los códigos de tiempo del archivo son incorrectos y quieres que YouTube los corrija. |
Cuerpo de la solicitud
Proporciona un recurso de subtítulos en el cuerpo de la solicitud. Para ese recurso:
-
Debes especificar un valor para estas propiedades:
snippet.videoId
snippet.language
snippet.name
-
Puedes establecer los valores de las siguientes propiedades:
snippet.videoId
snippet.language
snippet.name
snippet.isDraft
Respuesta
Si se aplica correctamente, este método muestra un recurso de subtítulos en el cuerpo de la respuesta.
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 |
---|---|---|
badRequest (400) |
contentRequired |
La solicitud no incluye el contenido de la pista de subtítulos. |
conflict (409) |
captionExists |
El video especificado ya tiene una pista de subtítulos con snippet.language y snippet.name . Un video puede tener varias pistas para el mismo idioma, pero cada una debe tener un nombre distinto.Existen varias formas de solucionar el error. Puedes eliminar la pista existente y luego insertar una nueva o cambiar el nombre de la pista nueva antes de insertarla. |
forbidden (403) |
forbidden |
Los permisos asociados con la solicitud no son suficientes para subir la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada. |
invalidValue (400) |
invalidMetadata |
La solicitud contiene valores de metadatos no válidos, lo que impide la creación de la pista. Confirma que la solicitud especifique valores válidos para las propiedades snippet.language , snippet.name y snippet.videoId . También se puede incluir la propiedad snippet.isDraft , pero no es obligatoria. |
notFound (404) |
videoNotFound |
No se pudo encontrar el video identificado por el parámetro videoId . |
invalidValue (400) |
nameTooLong |
El snippet.name especificado en la solicitud es demasiado largo. La longitud máxima admitida es de 150 caracteres. |
Pruébalo
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.