Baixador
Baixe conteúdo de áudio e vídeo do YouTube pelo ID do vídeo, com qualidade de vídeo configurável até 8K, entregue diretamente ao seu armazenamento em nuvem.
O youtube_download a fonte fornece o conteúdo de áudio/vídeo de um vídeo do YouTube de sua escolha. Observe que, devido ao potencialmente grande volume de dados, essa fonte está disponível apenas por meio da integração assíncrona integração Push-Pull e o armazenamento em nuvem recurso.
Como funciona o YouTube Downloader
Enviar via API:
Um ou mais IDs de vídeo do YouTube;
Detalhes do armazenamento em nuvem.
Obtenha a resposta da API com a confirmação de que sua solicitação para baixar um vídeo foi aceita com sucesso.
Obtenha os vídeos no local de armazenamento em nuvem especificado assim que forem processados pelo nosso sistema.
Observação:
O downloader usa por padrão a resolução de vídeo 720p. Se 720p não estiver disponível, o downloader escolherá a melhor qualidade disponível abaixo de 720p. Você pode substituir esse comportamento usando o
context: video_qualityparâmetro.Você pode baixar vídeos de até 12 horas de duração.
O tempo de download é limitado a 1 hora.
Valores dos parâmetros de entrada
source
Define o scraper. Use youtube_download.
–
query
ID do vídeo do YouTube.
–
storage_type
Tipo de armazenamento do serviço em nuvem (gcs, s3 ou s3_compatible)
–
storage_url
O nome do bucket (para AWS S3) ou a URL (para outros armazenamentos compatíveis com S3) do local de armazenamento em nuvem para o qual você gostaria que o resultado fosse enviado.
–
contexto:
download_type
Especifica se deve baixar audio, video, ou ambos - audio_video.
audio_video
contexto:
video_quality
Define a qualidade do vídeo: best, worst, ou uma resolução: 144, 360, 480, 720, 1080, 1440, 2160(4K), 4320(8K).
720
context: audio_language
Especifica qual faixa de áudio baixar. Aceita default ou original (a faixa de áudio original do vídeo).
default
contexto:
start_at
Carimbo de data/hora para o início do download parcial do vídeo (clipe) em hh:mm:ss formato. Saiba mais.
–
contexto:
end_at
Carimbo de data/hora para o término do download parcial do vídeo (clipe) em hh:mm:ss formato. Deve ser posterior a start_at. Saiba mais.
–
– parâmetro obrigatório
Enviando um job único
Endpoint
Entrada
Forneça os parâmetros do job em um payload JSON, como mostrado no exemplo abaixo:
Job em lote
Você pode enviar até 5.000 IDs de vídeo em uma única solicitação em lote.
Endpoint
IMPORTANTE: Com /batch endpoint, você só pode enviar listas de queryvalores de parâmetros. Todos os outros parâmetros devem ter valores individuais.
Entrada
A API responderá com um objeto JSON, contendo as informações do job para cada job criado. O status do job será pendente até que o download seja concluído.
Verificando o status do job
Se você forneceu uma URL de callback válida ao enviar seu job, nós o notificaremos quando ele for concluído enviando um JSON payload para a URL de callback especificada.
No entanto, se você enviou um job sem usar o serviço de callback, você pode verificar o status do job manualmente. Recupere a URL do href campo rel:self na seção da mensagem de resposta recebida após o envio do job. A URL para verificar o status do job será semelhante à seguinte: http://data.oxylabs.io/v1/queries/12345678900987654321. Consultar essa URL retornará as informações do job, incluindo seu status.
Endpoint
Download parcial (recorte)
Para baixar um segmento ou clipe específico em vez do vídeo completo, adicione 2 parâmetros adicionais ao seu context array:
start_at– timestamp inicial do clipe recortado emhh:mm:ssformato.end_at– timestamp final do clipe recortado emhh:mm:ssformato.
end_at o valor do timestamp deve ser posterior a start_at. Apenas hh:mm:ss o formato é suportado.
Se start_at ou end_at falharem na validação, o HTTP 400 erro é retornado com um campo .
start_at não está em hh:mm:ss formato
Valor inválido de start_at no contexto. Formato suportado: hh:mm:ss.
end_at não está em hh:mm:ss formato
Valor inválido de end_at no contexto. Formato suportado: hh:mm:ss.
end_at não é posterior a start_at
Valor inválido de end_at no contexto. Deve ser posterior a start_at.
Armazenamento em nuvem
Você pode fazer com que seus vídeos do YouTube sejam entregues em Google Cloud Storage, Amazon S3, Alibaba OSS, ou outro armazenamento em nuvem compatível com S3.
Os arquivos de conteúdo aparecerão no local de armazenamento em nuvem e receberão nomes de acordo com um dos seguintes esquemas de nomenclatura:
{video_id}_{job_id}.mp4– para vídeo{video_id}_{job_id}.m4a– para áudio
Parâmetros de armazenamento
storage_type
Seu tipo de armazenamento em nuvem.
gcs (Google Cloud Storage);
s3 (AWS S3);
s3_compatible (soluções de armazenamento compatíveis com S3).
storage_url
A URL do seu armazenamento em nuvem
Qualquer s3 ou gcs nome de bucket;
Qualquer compatível com S3 URL de armazenamento.
Configuração do Google Cloud Storage
Para que os resultados do seu job sejam enviados para o seu bucket do Google Cloud Storage, por favor configure permissões especiais para nosso serviço conforme mostrado na nossa documentação do Google Cloud Storage.
Configuração do Amazon S3
Para que os resultados do seu job sejam enviados para o seu bucket do Amazon S3, configure permissões de acesso para nosso serviço. Para isso, vá para https://s3.console.aws.amazon.com/ → S3 → Armazenamento → Nome do bucket ``(se você não tiver um, crie um novo) → Permissões → Política do bucket. Você pode encontrar todas as etapas necessárias na nossa documentação em nuvem do Amazon S3.
Use a política de bucket abaixo (não se esqueça de alterar o nome do bucket em YOUR_BUCKET_NAME):
Esta política nos permite gravar no seu bucket, dar a você acesso aos arquivos enviados e saber a localização do bucket.
Configuração do Alibaba Cloud OSS
Para salvar os resultados no seu Alibaba Cloud Object Storage Service (OSS), você deve criar o ACCESS_KEY_ID e ACCESS_KEY_SECRET e usá-las para formar a URL de armazenamento. Siga as instruções descritas na nossa documentação do Alibaba Cloud OSS .
Configuração de armazenamento compatível com S3
Se você gostaria de ter seus resultados entregues em outro local de armazenamento compatível com S3 você precisará incluir a string de autenticação ACCESS_KEY:SECRET do seu bucket na storage_url valor no payload:
Códigos de erro
11201
VIDEO_DELETED
O vídeo foi excluído.
11202
VIDEO_UNAVAILABLE
O vídeo não está disponível.
11203
VIDEO_PRIVATE
O vídeo foi definido como privado pelo uploader e somente ele e as pessoas explicitamente convidadas podem vê-lo.
11204
VIDEO_GEO_RESTRICTED
O vídeo tem restrição geográfica.
11205
VIDEO_LIVE
O vídeo está ao vivo agora.
11206
VIDEO_AGE_RESTRICTED
O vídeo tem restrição de idade.
11207
VIDEO_MEMBER_ONLY
O vídeo é apenas para membros do canal, e os espectadores precisam pagar a taxa de assinatura mensal.
11208
VIDEO_PREMIUM_ONLY
O vídeo requer a assinatura do YouTube Premium.
11209
VIDEO_LIVE_OR_TOO_LONG
O vídeo está ao vivo ou é longo demais para ser baixado.
11210
VIDEO_TOO_LONG
O vídeo é longo demais para ser baixado.
11211
VIDEO_SIGN_IN_REQUIRED
É necessário fazer login.
Atualizado
Isto foi útil?

