Se usó la API de Cloud Translation para traducir esta página.

Captions

Nota: El 13 de marzo de 2024, YouTube anunció que el parámetro sync dejará de estar disponible para el captions.insert y Extremos de la API de captions.update. La sincronización automática de subtítulos aún está disponible en YouTube Creator Studio. Consulta la Historial de revisión de la API de más detalles.

Un recurso caption representa una pista de subtítulos de YouTube. Una pista de subtítulos se asocia con exactamente un video de YouTube.

Métodos

La API admite los siguientes métodos para los recursos captions:

list: Recupera una lista de pistas de subtítulos asociadas con un video específico. Ten en cuenta que la respuesta de la API no contiene los subtítulos reales y que el método captions.download proporciona la capacidad de recuperar una pista de subtítulos. Pruébalo ahora.
insertar: Sube una pista de subtítulos.
actualización: Actualiza una pista de subtítulos. Cuando actualizas una pista de subtítulos, puedes cambiar el estado del borrador de la pista, subir un nuevo archivo de subtítulos para la pista o realizar ambas acciones.
borrar: Borra una pista de subtítulos especificada. Pruébala ahora.
descargar: Descargar una pista de subtítulos. La pista de subtítulos se muestra en su formato original, a menos que la solicitud especifique un valor para el parámetro tfmt y en su idioma original, a menos que la solicitud especifique un valor para el parámetro tlang.

Representación de recursos

La siguiente estructura JSON muestra el formato de un recurso captions:

{
  "kind": "youtube#caption",
  "etag": etag,
  "id": string,
  "snippet": {
    "videoId": string,
    "lastUpdated": datetime,
    "trackKind": string,
    "language": string,
    "name": string,
    "audioTrackType": string,
    "isCC": boolean,
    "isLarge": boolean,
    "isEasyReader": boolean,
    "isDraft": boolean,
    "isAutoSynced": boolean,
    "status": string,
    "failureReason": string
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
`kind`	`string` Identifica el tipo de recurso de la API. El valor será `youtube#caption`.
`etag`	`etag` Etag de este recurso.
`id`	`string` ID que YouTube utiliza para identificar de forma exclusiva la pista de subtítulos.
`snippet`	`object` El objeto `snippet` contiene información básica sobre la leyenda.
`snippet.videoId`	`string` Es el ID que YouTube usa para identificar de forma exclusiva el video asociado con la pista de subtítulos.
`snippet.lastUpdated`	`datetime` Es la fecha y hora de la última actualización de la pista de subtítulos. El valor se especifica en el formato ISO 8601.
`snippet.trackKind`	`string` El tipo de pista de subtítulos. Los valores válidos para esta propiedad son los siguientes: `ASR`: Es una pista de subtítulos generada con el reconocimiento de voz automático. `forced`: es una pista de subtítulos que se reproduce cuando no se selecciona otra pista en el reproductor. Por ejemplo, un video en el que se muestran alienígenas hablando en un idioma alienígena podría tener una pista de subtítulos forzada para mostrar solo los subtítulos en el idioma alienígena. `standard`: Es una pista de subtítulos normal. Este es el valor predeterminado.
`snippet.language`	`string` El idioma de la pista de subtítulos. El valor de la propiedad es una etiqueta de idioma BCP-47.
`snippet.name`	`string` Es el nombre de la pista de subtítulos. El nombre está pensado para que el usuario pueda verlo como una opción durante la reproducción. La longitud máxima admitida para el nombre es de 150 caracteres.
`snippet.audioTrackType`	`string` El tipo de pista de audio asociada con la pista de subtítulos. Los valores válidos para esta propiedad son los siguientes: `commentary`: La pista de subtítulos corresponde a una pista de audio alternativa que incluye comentarios, como los comentarios del directorio. `descriptive`: La pista de subtítulos corresponde a una pista de audio alternativa que incluye audio descriptivo adicional. `primary`: la pista de subtítulos corresponde a la pista de audio principal del video, que es la pista de audio que normalmente se asocia con el video. `unknown`: este es el valor predeterminado.
`snippet.isCC`	`boolean` Indica si la pista contiene subtítulos para personas sordas o con hipoacusia. El valor predeterminado es `false`.
`snippet.isLarge`	`boolean` Indica si la pista de subtítulos utiliza texto grande para las personas con visión reducida. El valor predeterminado es `false`.
`snippet.isEasyReader`	`boolean` Indica si la pista de subtítulos tiene el formato de “lector fácil”, es decir, que está en un nivel de tercer grado para estudiantes de idiomas. El valor predeterminado es `false`.
`snippet.isDraft`	`boolean` Indica si la pista de subtítulos es un borrador. Si el valor es `true`, el segmento no es visible para el público. El valor predeterminado es `false`.
`snippet.isAutoSynced`	`boolean` Indica si YouTube sincroniza la pista de subtítulos con la pista de audio del video. El valor será `true` si se solicitó explícitamente una sincronización cuando se subió la pista de subtítulos. Por ejemplo, cuando llamas a los métodos `captions.insert` o `captions.update`, puedes establecer el parámetro `sync` en `true` para indicarle a YouTube que sincronice la pista subida con el video. Si el valor es `false`, YouTube usa los códigos de tiempo de la pista de subtítulos que se subió para determinar cuándo mostrarlos.
`snippet.status`	`string` Es el estado de la pista de subtítulos. Los valores válidos para esta propiedad son los siguientes: `failed` `serving` `syncing`
`snippet.failureReason`	`string` El motivo por el que YouTube no pudo procesar la pista de subtítulos. Esta propiedad solo está presente si el valor de la propiedad `state` es `failed`. Los valores válidos para esta propiedad son los siguientes: `processingFailed`: YouTube no pudo procesar la pista de subtítulos que se subió. `unknownFormat`: no se reconoció el formato de la pista de subtítulos. `unsupportedFormat`: No se admite el formato de la pista de subtítulos.