Cómo citar un video de YouTube con precisión

Qué aportan los subtítulos sincronizados

Un Actor es un programa de recopilación de datos alojado en un servidor. El Actor YouTube Transcript lee una pista pública de subtítulos a partir de una URL de video que ya conocés. Una pista de subtítulos es texto con tiempos asociados que se guarda junto con el video. El Actor copia ese texto guardado. No convierte el habla en texto nuevo. No identifica a las personas que hablan. No comprueba hechos. No puede demostrar que una cita sea exacta.

Una Task es una configuración de entrada guardada. La Task de transcripción de YouTube en JSON con marcas de tiempo es la configuración inicial publicada. Solicita segmentos con tiempos asociados en formato JSON. JSON es una forma de escribir nombres de campos y valores como texto. Una Task publicada es solo una configuración inicial. No hace esta comprobación de citas por vos.

La compilación pública 0.1.43 de YouTube Transcript acepta 4 campos de entrada.

• `startUrls` contiene URL o identificadores de videos conocidos.
• `preferredLanguages` contiene los códigos de los idiomas que preferís. Una lista vacía no fuerza la selección de un idioma.
• `outputFormats` solicita el formato del resultado. Usá JSON.
• `includeFailedInputDetails` con el valor true solicita una fila de detalles cuando falla una entrada.

La Task publicada incluye 3 URL de videos de ejemplo. Esos ejemplos no son tu fuente. Reemplazá toda la lista por un video público conocido. Si dejás los ejemplos, podrías leer una fila de otro video. Mantené JSON como formato de salida. Mantené `includeFailedInputDetails` con el valor true. Una fila de error puede explicar el fallo. Una fila de error no es una cita verificada. El Actor no busca videos dentro de un canal. Tampoco busca videos dentro de una lista de reproducción.

{
  "startUrls": ["https://www.youtube.com/watch?v=YOUR_VIDEO_ID"],
  "preferredLanguages": [],
  "outputFormats": ["json"],
  "includeFailedInputDetails": true
}

Poné la URL de tu video público real en `startUrls`. Eliminá todas las URL de ejemplo. Las llaves externas marcan el inicio y el final de la entrada. Los corchetes marcan el inicio y el final de una lista. Si conocés el idioma hablado, poné su código en `preferredLanguages`. Si no lo conocés, dejá la lista vacía. Una lista de idiomas vacía no significa que los subtítulos estén en inglés.

Una comprobación compatible devolvió 1 fila con estado succeeded. Esa fila tenía una pista manual de subtítulos en inglés con contenido. Manual significa que una persona preparó la pista, en lugar de generarse automáticamente. Los segmentos con tiempos asociados pertenecían al video previsto. Podés reutilizar ese dato sobre el estado. No reutilices palabras de un video de ejemplo. Esas palabras no forman parte de este método.

Una fila es un resultado de un video. Conservá cada campo devuelto tal como lo recibiste. Estos campos son útiles:

• `videoId` es el identificador público del video.
• `videoUrl` es la dirección pública del video.
• `transcriptLanguageCode` es el código de idioma de los subtítulos.
• `isAutoGenerated` indica si YouTube generó la pista automáticamente. La comprobación compatible usó una pista manual en inglés, por lo que esa pista no era automática. Si este campo tiene el valor null, no sabés cómo se creó la pista.
• `text` es el texto de los subtítulos de la fila. Cada segmento también tiene su propio `text`. Conservá ambos.
• `segments` es la lista de fragmentos con tiempos asociados. Un segmento es un fragmento de la pista de subtítulos con tiempos asociados.
• `status` indica qué ocurrió con esa entrada. La comprobación compatible usó succeeded. Si el estado no es succeeded, no cites esa fila.
• `scrapedAt` indica cuándo se recopiló la fila. No indica el momento en que se pronunciaron las palabras.

Cada segmento conserva `startSeconds`, `endSeconds`, `durationSeconds` y `text`. `startSeconds` indica cuándo empieza el fragmento, contando desde el inicio de ese video. `endSeconds` indica cuándo termina. `durationSeconds` es la duración que envió el Actor. Si un valor es null, dejalo como null. Null significa que el valor está ausente. Un valor ausente no equivale a 0.

Podés comprobar una duración con una resta simple. Duración del pasaje = segundos de finalización - segundos de inicio. Si tu resta no coincide con `durationSeconds`, conservá el valor del Actor. Anotá la diferencia en tu registro de citas. No reemplaces el valor del Actor.

Un subtítulo puede contener errores aunque el estado sea succeeded. Los segmentos pueden superponerse. Conservá los 2 segmentos superpuestos. No los combines para formar una oración nueva. La pista puede omitir un cambio de persona que habla. Puede omitir algo en pantalla que cambie el significado. Conservá el texto y los tiempos originales. No inventes una etiqueta para identificar a quien habla. No reemplaces un tiempo de la fuente por un tiempo estimado.

Si un video es privado, no obtenés una cita verificada. Si fue eliminado, no obtenés una cita verificada. Si no tiene subtítulos, no obtenés una cita verificada. Podés escucharlo y hacer una transcripción humana. Una transcripción es el texto que escribís después de escuchar. Identificala como tu propia transcripción. No digas que la creó el Actor.

`transcriptLanguageCode` no demuestra cuáles fueron las palabras pronunciadas. Si traducís, indicá que es una traducción. No presentes una traducción como una cita exacta en el idioma original.

La configuración guarda 1 resumen de ejecución antes de revisar el texto. inputsReceived es la cantidad de entradas que ingresaron a la ejecución. uniqueVideosPlanned es la cantidad de videos diferentes que la ejecución tenía previsto abrir. rowsWritten es la cantidad de filas de transcripción obtenidas correctamente. successfulTranscriptRows es la cantidad de filas de transcripción obtenidas correctamente. Una transcripción es el texto escrito de los subtítulos con sus tiempos. rowsWritten y successfulTranscriptRows no cuentan las filas guardadas con detalles de fallos. failedInputs es la cantidad de entradas de subtítulos que fallaron. failedInputs no cuenta el trabajo sin terminar. duplicateVideosSkipped es la cantidad de videos repetidos que la ejecución no volvió a abrir. statusCounts es la cantidad de resultados de entradas procesadas para cada estado de pista. Estos resultados incluyen fallos. El estado de pista es la etiqueta de resultado de una pista de subtítulos. errorCodeCounts es la cantidad de fallos de cada código de error. Un código de error es el nombre corto de un tipo de fallo. failedInputDetails es la lista de cada entrada que falló y su error. includeFailedInputDetails: true permite guardar filas con detalles de fallos. Esas filas se mantienen separadas de los recuentos de transcripciones obtenidas correctamente. Conciliá estos registros antes de revisar el texto. Conciliar significa compararlos hasta que coincidan. Deben coincidir el video previsto, el idioma de la pista, el estado de la pista, las filas con estado succeeded, los recuentos de fallos y la lista de fallos. El video previsto es el video que la ejecución debía abrir. El idioma de la pista es la etiqueta de idioma de esa pista de subtítulos. Una extracción correcta solo indica que la ejecución encontró los subtítulos y sus tiempos. No demuestra que las palabras citadas, la identidad de quien habla o la afirmación sean correctas.

Comprobá las palabras en 8 pasos

Seguí estos pasos para cada pasaje breve que podrías citar.

1. Escribí la afirmación que la cita debe respaldar.

Escribí la afirmación en una oración antes de elegir las palabras. Después, elegí un video público conocido. Elegí un pasaje breve como posible cita. Tenés que comprobar por tu cuenta las palabras pronunciadas. Un fragmento de texto recuperado solo sirve para orientarte. Una nota sobre dónde hiciste clic solo sirve para orientarte. Ninguno de los dos constituye la cita. Si no escribís primero la afirmación, es fácil eliminar palabras hasta que aparezca una afirmación diferente.

1. Obtené el JSON actual con tiempos asociados o revisá el video de forma manual.

Guardá el identificador de la fuente, la URL de la fuente, el código de idioma, el estado y el texto y los tiempos originales de los segmentos. Si faltan los subtítulos, escuchá el video y hacé una transcripción humana. Identificá esa transcripción como tal. No digas que la hizo el Actor. Mantené la pista original de subtítulos sin cambios después de encontrar un error. La pista original muestra lo que envió el Actor. Tu corrección debe ir en el registro de citas, no dentro de esa pista.

1. Abrí el pasaje en los tiempos de la posible cita.

Reproducí suficiente video antes y después de la frase. Las palabras y las imágenes que la rodean son el contexto. El contexto muestra quién habla. Muestra a qué se refiere una palabra como "eso" o "ellos". Muestra una condición, una unidad y una negación. Una negación es una palabra como "no". Una condición es un requisito que debe cumplirse antes de la acción. Una unidad es la medida, como tazas o minutos. Mirá la imagen cuando pueda cambiar el significado. Un signo de puntuación en el subtítulo no demuestra cómo habló la persona. Un nombre en el subtítulo no demuestra quién habló. Un segmento breve puede omitir una negación que se pronunció justo antes. Incluí el segmento contiguo cuando la condición esté allí.

1. Volvé a escuchar y escribí las palabras que necesitás.

Escuchá 1 vez sin mirar el subtítulo. Transcribí solo las palabras exactas que necesitás. Volvé a reproducir cualquier palabra sobre la que tengas dudas. Si una palabra incorrecta pudiera dar lugar a una afirmación falsa grave, pedile a otra persona que escuche. Si el audio no es claro, escribí "no se entiende". No completes el espacio con una palabra probable. Identificá a quien habla solo a partir de una presentación o de otra declaración explícita en la fuente. Una voz que suena conocida no basta para establecer una identidad. Una suposición del subtítulo no basta para establecer una identidad. Si la fuente no identifica a quien habla, escribí "desconocido". Lo desconocido sigue siendo desconocido. No escribas un nombre ni 0.

1. Compará las palabras del subtítulo con las palabras que comprobaste.

Escribí el motivo de la corrección en el registro de citas. Anotá el intervalo de la fuente que escuchaste. No cambies el texto original de los subtítulos. No cambies los tiempos originales. El texto que comprobaste es tu transcripción. No es un campo nuevo del Actor. No mejores la redacción de una oración y la dejes entre comillas. Una oración con mejor redacción puede ser más fácil de leer y aun así no ser fiel a la fuente. Las comillas indican que esas son las palabras comprobadas.

1. Elegí una cita textual o una paráfrasis.

Una cita textual repite el texto comprobado y usa comillas. Una paráfrasis expresa el mismo significado con tus propias palabras. Una paráfrasis no usa comillas y también debe incluir un enlace a la fuente. Solo podés omitir palabras si el significado sigue siendo el mismo. No omitas una condición. No omitas una negación. Si eliminás una palabra como "no", podés invertir el significado. Respetá los límites para las citas del lugar donde publiques. Este método no indica qué permite la ley de derechos de autor. No copies un extracto largo de un video real.

1. Guardá el registro de citas.

Incluí la afirmación, la URL de la fuente y el identificador de la fuente. Incluí los segundos de inicio y de finalización del pasaje. Incluí el idioma, la evidencia sobre quién habla y el extracto original de los subtítulos. Incluí el texto comprobado, el método de comprobación y el momento de la comprobación. Incluí una nota de contexto, la corrección y el estado de revisión. Citá un momento que el lector pueda abrir. En una computadora, YouTube permite compartir un enlace que empieza en un tiempo elegido. YouTube llama a esta opción Comenzar en. La página de ayuda es Ayuda de YouTube para compartir videos: Comenzar en. Probá un enlace real a un momento específico antes de citarlo. Confirmá que abre el video previsto en el momento previsto. Conservá `videoUrl` en la fila original. El enlace a un momento específico es para el lector. No demuestra que la cita sea correcta. No demuestra que la afirmación sea cierta. Un revisor que no puede abrir ese momento no puede comprobar tus palabras. Un enlace que abre ese momento sigue siendo solo una forma de navegar.

1. Pedile a un revisor que abra el pasaje antes de publicar.

El revisor compara la cita final con el audio. También la compara con la afirmación que la acompaña. Si queda sin resolver una palabra necesaria, mantené el estado de revisión `needs_review`. Si la fuente no permite establecer quién habla, mantené `needs_review`. No publiques una cita con estado `needs_review` como si estuviera comprobada. `verified_wording` significa que se comprobaron las palabras y la evidencia sobre quién habla. No significa que se haya demostrado la afirmación. Una transcripción precisa puede expresar una afirmación sin respaldo. Mantené separadas la comprobación del texto y la comprobación de la afirmación. Un revisor vuelve a escuchar, para que la comprobación no dependa de una sola persona. El revisor no convierte una afirmación falsa en verdadera.

Ejemplo resuelto paso a paso: ficción original

La lección de jardinería de esta sección es una ficción original. No es un resultado del Actor. No corresponde a un video real ni a una persona real. Aquí no se aporta ningún dato sobre imágenes. No agregues ninguno.

El identificador de la fuente ficticia es el marcador de posición VIDEO_ID. Un segmento original de subtítulos que va de los 42 segundos a los 48 segundos dice: "agregá agua cuando la bandeja esté nivelada." Luego, la persona que escucha reproduce el video desde los 38 segundos hasta los 51 segundos. En ese intervalo más amplio, quien habla dice: "No agregues agua hasta que la bandeja esté nivelada."

El subtítulo omite la negación "no". También omite "hasta que", que expresa la condición temporal. Un lector que cite solo el subtítulo original enseñará la acción contraria. La cita breve comprobada es: "No agregues agua hasta que la bandeja esté nivelada."

Duración del pasaje = segundos de finalización - segundos de inicio. El intervalo del subtítulo es 48 - 42 = 6 segundos. El intervalo de escucha es 51 - 38 = 13 segundos. Guardá ambos intervalos. El intervalo corto es el segmento original. El intervalo más largo es el contexto que escuchaste.

La presentación ficticia identifica al Hablante A. Guardá esa presentación como evidencia de quién habla. Dejá el subtítulo original exactamente como lo recibiste. El motivo de la corrección es la omisión de la negación y de la condición. El estado de revisión es `verified_wording`. En esta ficción se desconoce el momento de la comprobación. Un dato desconocido no equivale a 0.

Una paráfrasis es: Esperá a que la bandeja esté nivelada antes de agregar agua. No pongas esa paráfrasis entre comillas. Es una reformulación, no una segunda cita verificada. Una propuesta de cita que diga solo "Agregá agua" invierte la instrucción. Elimina la negación y la condición. Rechazala.

La posible cita 2 también es una ficción original. Su fila de subtítulos tuvo estado succeeded. Esta ficción no aporta una oración original que pueda usarse con seguridad, por lo que el extracto original sigue siendo desconocido. No inventes una unidad para completar lo que falta. La palabra que indica la unidad no se entiende en el audio. La fuente no confirma un cambio de persona que habla. El texto comprobado es desconocido. Se desconoce quién habla. Se desconocen los tiempos del pasaje. El estado de revisión es `needs_review`. No está verificada.

2 filas de subtítulos con estado succeeded no se convierten en 2 citas verificadas. La obtención correcta de subtítulos solo indica que se devolvió una fila. Solo la posible cita 1 tiene palabras comprobadas, evidencia sobre quién habla y un motivo de corrección.

La decisión de publicación tiene un alcance limitado. Publicá la cita textual comprobada de la posible cita 1 solo después de que un revisor escuche desde los 38 segundos hasta los 51 segundos y esté de acuerdo. No publiques las palabras "Agregá agua" como cita. No publiques la posible cita 2. Mantené la posible cita 2 en `needs_review` hasta resolver la unidad y la identidad de quien habla.

Un enlace a un momento específico de esta ficción sigue únicamente este modelo:

https://www.youtube.com/watch?v=VIDEO_ID&t=42s

Este modelo no es evidencia que se pueda reproducir. No es una fuente real accesible. No publiques VIDEO_ID como referencia de un hecho. Cuando uses el método con un video real, citá ese video real. Probá primero el enlace real al momento específico. Mantené la cita breve. Conservá el contexto de la fuente donde el lector pueda verlo.

Record 1 (original fiction)
claim: The speaker tells the viewer not to add water until the tray is level.
source id: VIDEO_ID (placeholder, not a real video)
moment link: template only, not playable evidence
passage in seconds: 42
passage out seconds: 48
passage length: 48 - 42 = 6 seconds
wider checked interval: 38 to 51 seconds
wider length: 51 - 38 = 13 seconds
language heard: English
speaker evidence: The fictional introduction names Speaker A.
raw caption excerpt: add water when the tray is level.
checked wording: Do not add water until the tray is level.
check method: Listen from 38 seconds to 51 seconds. Compare with the raw caption. Leave the raw caption unchanged.
check time: unknown
context note: The wider window contains the negation and the condition. No picture fact is supplied.
correction: The caption omitted the negation and the timing condition.
review state: verified_wording

Record 2 (original fiction)
claim: unknown
source id: VIDEO_ID (same fictional placeholder)
passage in seconds: unknown
passage out seconds: unknown
language heard: unknown
speaker evidence: none. No speaker change is confirmed.
raw caption excerpt: unknown. A caption row succeeded, but its words are not supplied here.
checked wording: unknown. The unit word is unclear in the audio.
check method: Listen. Do not guess the unit. Do not guess the speaker.
check time: unknown
context note: Caption success does not verify the words.
correction: none yet
review state: needs_review

Separá la precisión del texto de la veracidad de la afirmación

Una cita comprobada puede expresar una afirmación débil o falsa. La precisión de las palabras solo significa que escuchaste esas palabras. No significa que la afirmación sea verdadera. Verificá la afirmación con evidencia adecuada para ella. Esa comprobación es independiente del registro de citas. `verified_wording` no demuestra que la instrucción de jardinería sea correcta, ni siquiera dentro de la ficción. Solo significa que se comprobó que las palabras ficticias coincidían con lo que se dijo.