For the complete documentation index, see llms.txt. This page is also available as Markdown.

Descargador

Descarga contenido de audio y video de YouTube por ID de video, con calidad de video configurable hasta 8K, entregado directamente a tu almacenamiento en la nube.

La youtube_download La fuente entrega el contenido de audio/video de un video de YouTube de su elección. Tenga en cuenta que, debido al posible gran volumen de datos, esta fuente solo está disponible a través de la integración asíncrona integración Push-Pull y la Almacenamiento en la nube función.

Cómo funciona YouTube Downloader

  1. Enviar mediante API:

    • Uno o más IDs de video de YouTube;

    • Detalles del almacenamiento en la nube.

  2. Obtenga la respuesta de la API con la confirmación de que su solicitud para descargar un video ha sido aceptada correctamente.

  3. Obtenga los videos en la ubicación de almacenamiento en la nube especificada tan pronto como sean procesados por nuestro sistema.

Valores de los parámetros de entrada

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper. Usa youtube_download.

consulta

ID del video de YouTube.

storage_type

Tipo de almacenamiento del servicio en la nube (gcs, s3 o s3_compatible)

storage_url

El nombre del bucket (para AWS S3) o la URL (para otro almacenamiento compatible con S3) de la ubicación de almacenamiento en la nube a la que desea que se cargue el resultado.

callback_url

La URL de su endpoint de callback. Más información

context: download_type

Especifica si descargar audio, video, o ambos - audio_video.

audio_video

context: video_quality

Establece la calidad del video: mejor, peor, o una resolución: 144, 360, 480, 720, 1080, 1440, 2160(4K), 4320(8K).

720

contexto: audio_language

Especifica qué pista de audio descargar. Acepta predeterminado o original (la pista de audio original del video).

predeterminado

context: start_at

Marca de tiempo para que inicie la descarga parcial del video (clip) en hh:mm:ss formato. Más información.

context: end_at

Marca de tiempo para que termine la descarga parcial del video (clip) en hh:mm:ss formato. Debe ser posterior a start_at. Más información.

– parámetro obligatorio

Envío de un trabajo individual

Punto de conexión

Entrada

Proporcione los parámetros del trabajo en un payload JSON como se muestra en el siguiente ejemplo:

Trabajo por lotes

Puede enviar hasta 5.000 IDs de video en una sola solicitud por lotes.

Punto de conexión

Entrada

La API responderá con un objeto JSON que contiene la información del trabajo para cada trabajo creado. El estado del trabajo será pendiente hasta que se complete la descarga.

Comprobación del estado del trabajo

Si proporcionó una URL de callback al enviar su trabajo, le notificaremos al completarse enviando una JSON carga útil a la URL de callback especificada.

Sin embargo, si envió un trabajo sin usar el servicio de callback, puede comprobar manualmente el estado del trabajo. Recupere la URL del href campo en la rel:self sección del mensaje de respuesta recibido después de enviar el trabajo. La URL para comprobar el estado del trabajo se parecerá a la siguiente: http://data.oxylabs.io/v1/queries/12345678900987654321. Consultar esta URL devolverá la información del trabajo, incluido su estado actual, status.

Punto de conexión

Descarga parcial (recorte)

Para descargar un segmento o clip específico en lugar del video completo, agregue 2 parámetros adicionales a su contexto arreglo:

  • start_at – marca de tiempo de inicio del clip recortado en hh:mm:ss formato.

  • end_at – marca de tiempo de fin del clip recortado en hh:mm:ss formato.

Si se omiten ambos parámetros, la solicitud se comporta como una descarga estándar de video completo.

Si start_at o end_at no superan la validación, el error HTTP 400 se devuelve con un message campo.

Condición
Mensaje de error

start_at no está en hh:mm:ss formato

Valor start_at inválido en el contexto. Formato compatible: hh:mm:ss.

end_at no está en hh:mm:ss formato

Valor end_at inválido en el contexto. Formato compatible: hh:mm:ss.

end_at no es posterior a start_at

Valor end_at inválido en el contexto. Debe ser posterior a start_at.

Almacenamiento en la nube

Puede recibir sus videos de YouTube en Google Cloud Storage, Amazon S3, Alibaba OSS, o otro almacenamiento en la nube compatible con S3.

Los archivos de contenido aparecerán en su ubicación de almacenamiento en la nube y se nombrarán según uno de los siguientes esquemas de nomenclatura:

  • {video_id}_{job_id}.mp4 – para video

  • {video_id}_{job_id}.m4a – para audio

Parámetros de almacenamiento

Parámetro
Descripción
Valores válidos

storage_type

Su tipo de almacenamiento en la nube.

gcs (Google Cloud Storage);

s3 (AWS S3); s3_compatible (otras soluciones de almacenamiento compatibles con S3).

storage_url

La URL de su almacenamiento en la nube

Cualquiera s3 o gcs nombre de bucket;

Cualquiera compatible con S3 URL de almacenamiento.

Configuración de Google Cloud Storage

Para que los resultados de su trabajo se carguen en su bucket de Google Cloud Storage, por favor configure permisos especiales para nuestro servicio como se muestra en nuestra documentación de Google Cloud Storage.

Configuración de Amazon S3

Para que los resultados de su trabajo se carguen en su bucket de Amazon S3, configure los permisos de acceso para nuestro servicio. Para hacerlo, vaya a https://s3.console.aws.amazon.com/S3AlmacenamientoNombre del bucket ``(si no tiene uno, cree uno nuevo)PermisosPolítica del bucket. Puede encontrar todos los pasos necesarios en nuestra documentación en la nube de Amazon S3.

Use la política del bucket a continuación (no olvide cambiar el nombre del bucket debajo de YOUR_BUCKET_NAME):

Esta política nos permite escribir en su bucket, darle acceso a los archivos cargados y conocer la ubicación del bucket.

Configuración de Alibaba Cloud OSS

Para guardar los resultados en su Alibaba Cloud Object Storage Service (OSS), debe crear la ACCESS_KEY_ID y ACCESS_KEY_SECRET y usarlos para formar la URL de almacenamiento. Siga las instrucciones descritas en nuestra documentación de Alibaba Cloud OSS .

Configuración de almacenamiento compatible con S3

Si desea que sus resultados se entreguen en otro almacenamiento compatible con S3 ubicación, deberá incluir la ACCESS_KEY:SECRET cadena de autenticación en la storage_url valor en el payload:

Códigos de error

Código
Estado
Descripción

11201

VIDEO_DELETED

El video está eliminado.

11202

VIDEO_UNAVAILABLE

El video no está disponible.

11203

VIDEO_PRIVATE

El video está configurado como privado por el autor de la subida y solo él y las personas invitadas explícitamente pueden verlo.

11204

VIDEO_GEO_RESTRICTED

El video tiene restricción geográfica.

11205

VIDEO_LIVE

El video está en directo ahora.

11206

VIDEO_AGE_RESTRICTED

El video tiene restricción de edad.

11207

VIDEO_MEMBER_ONLY

El video es solo para miembros del canal, y los espectadores tienen que pagar la cuota de suscripción mensual.

11208

VIDEO_PREMIUM_ONLY

El video requiere la suscripción a YouTube Premium.

11209

VIDEO_LIVE_OR_TOO_LONG

El video está en directo o es demasiado largo para descargar.

11210

VIDEO_TOO_LONG

El video es demasiado largo para descargar.

11211

VIDEO_SIGN_IN_REQUIRED

Es necesario iniciar sesión.

Última actualización

¿Te fue útil?