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
Enviar mediante API:
Uno o más IDs de video de YouTube;
Detalles del almacenamiento en la nube.
Obtenga la respuesta de la API con la confirmación de que su solicitud para descargar un video ha sido aceptada correctamente.
Obtenga los videos en la ubicación de almacenamiento en la nube especificada tan pronto como sean procesados por nuestro sistema.
Nota:
El descargador usa por defecto una resolución de video de 720p. Si 720p no está disponible, el descargador elegirá la mejor calidad disponible por debajo de 720p. Puede sobrescribir este comportamiento usando el
contexto: video_qualityparámetro.Puede descargar videos de hasta 12 horas de duración.
El tiempo de descarga está limitado a 1 hora.
Valores de los parámetros de entrada
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.
–
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
IMPORTANTE: Con /batch endpoint, solo puede enviar listas de consultavalores de parámetros. Todos los demás parámetros deben tener valores singulares.
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 enhh:mm:ssformato.end_at– marca de tiempo de fin del clip recortado enhh:mm:ssformato.
end_at el valor de la marca de tiempo debe ser posterior a start_at. Solo hh:mm:ss se admite el formato.
Si start_at o end_at no superan la validación, el error HTTP 400 se devuelve con un message campo.
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
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/ → S3 → Almacenamiento → Nombre del bucket ``(si no tiene uno, cree uno nuevo) → Permisos → Polí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
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?

