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

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

  1. Envie via API:

    • Um ou mais IDs de vídeo do YouTube;

    • Detalhes do armazenamento em nuvem.

  2. Receba a resposta da API com a confirmação de que sua solicitação para baixar um vídeo foi aceita com sucesso.

  3. Receba os vídeos no local de armazenamento em nuvem especificado assim que forem processados pelo nosso sistema.

Valores dos parâmetros de entrada

Parâmetro
Descrição
Valor padrão

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.

callback_url

A URL do seu endpoint de callback. Mais informações

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

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 em hh:mm:ss formato.

  • end_at – carimbo de data/hora de fim do clipe recortado em hh:mm:ss formato.

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.

Condição
Mensagem de erro

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

Parâmetro
Descrição
Valores válidos

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/S3ArmazenamentoNome do bucket (se você não tiver um, crie um novo)PermissõesPolí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

Código
Status
Descrição

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?