Download
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 no seu armazenamento em nuvem.
A youtube_download 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 Push-Pull integration e o Cloud Storage recurso.
Como o YouTube Downloader funciona
Envie via API:
Um ou mais IDs de vídeo do YouTube;
Detalhes do armazenamento em nuvem.
Receba a resposta da API com a confirmação de que sua solicitação para baixar um vídeo foi aceita com sucesso.
Receba os vídeos no local de armazenamento em nuvem especificado assim que forem processados pelo nosso sistema.
Observação:
O downloader usa a resolução de vídeo 720p por padrão. 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 outro armazenamento compatível com S3) do local de armazenamento em nuvem para o qual você gostaria que o resultado fosse enviado.
–
context:
download_type
Especifica se deve baixar áudio, vídeo, ou ambos - audio_video.
audio_video
context:
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:
start_at
Carimbo de data/hora para o início do download parcial do vídeo (clipe) em hh:mm:ss formato. Saiba mais.
–
context:
end_at
Carimbo de data/hora para o fim 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 único job
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 singulares.
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 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 serviço de callback, você pode verificar o status do job manualmente. Recupere a URL do href campo na rel:self 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 contexto vetor:
start_at– carimbo de data/hora de início do clipe recortado emhh:mm:ssformato.end_at– carimbo de data/hora de fim do clipe recortado emhh:mm:ssformato.
end_at o valor do carimbo de data/hora deve ser posterior a start_at. Apenas hh:mm:ss o formato é suportado.
Se ambos os parâmetros forem omitidos, a requisição se comporta como um download padrão do vídeo completo.
Se start_at ou end_at falharem na validação, o HTTP 400 erro é retornado com um message campo.
start_at não está em hh:mm:ss formato
Valor de start_at inválido no contexto. Formato suportado: hh:mm:ss.
end_at não está em hh:mm:ss formato
Valor de end_at inválido no contexto. Formato suportado: hh:mm:ss.
end_at não é posterior a start_at
Valor de end_at inválido no contexto. Deve ser posterior a start_at.
Armazenamento em nuvem
Você pode ter seus vídeos do YouTube enviados para Google Cloud Storage, Amazon S3, Alibaba Cloud OSS, ou outro armazenamento em nuvem compatível com S3.
Os arquivos de conteúdo aparecerão no local de armazenamento em nuvem e serão nomeados de acordo com um dos seguintes esquemas de nomeação:
{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 (outras soluções de armazenamento compatíveis com S3).
storage_url
Sua URL de armazenamento em nuvem
Qualquer s3 ou gcs nome do 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 o nosso serviço conforme mostrado em 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 o nosso serviço. Para fazer isso, acesse 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 em nossa documentação em nuvem do Amazon S3.
Use a política do 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, conceder 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 em nossa documentação do Alibaba Cloud OSS .
Configuração de armazenamento compatível com S3
Se você quiser que seus resultados sejam entregues em outro armazenamento compatível com S3 localização, você terá que incluir o ACCESS_KEY:SECRET string de autenticação no 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 possui restrição de idade.
11207
VIDEO_MEMBER_ONLY
O vídeo é exclusivo para membros do canal, e os espectadores precisam pagar a taxa mensal de assinatura.
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 baixar.
11210
VIDEO_TOO_LONG
O vídeo é longo demais para baixar.
11211
VIDEO_SIGN_IN_REQUIRED
É necessário fazer login.
Atualizado
Isto foi útil?

