Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Referência da API

Batch e volume

Escolha Batch para consultas independentes com diferentes entradas. Escolha Bulk para um arquivo de vídeo IDs que todos precisam da mesma operação.

Nesta página

Escolha pelo trabalho que precisa fazer

A escolha depende da forma de sua entrada, não de um número fixo de itens. Ambos os modos são executados ao fundo. Para uma consulta, use em tempo real ou assincronia diretamente.

Sua tarefaEscolha
Procure vários tópicos para uma reunião diáriaBatch: Cada consulta tem seus próprios termos de busca, localização ou idioma.
Combine resultados Google e metadados YouTube em um trabalho de pesquisaBatch: Misture fontes e colete um resultado separado para cada consulta.
Atualizar metadados ou coletar transcrições para um catálogo de vídeoBulk: Um arquivo de vídeo-ID, uma fonte e as mesmas opções para cada vídeo.
Entregue uma lista de vídeos em um balde no mesmo formato.Bulk: Use youtube_download com configurações de mídia compartilhada e armazenamento de destino.
Use diferentes configurações de saída para cada vídeoBatch: Os parâmetros por consulta podem diferir. Bulk aplica um conjunto para todo o arquivo.

Batch: consultas independentes

Envie um objeto JSON contendo consultas. Cada item tem sua própria fonte, entrada e parâmetros. Use Batch para buscas Google, buscas YouTube, fontes mistas ou vídeos que precisam de opções diferentes.

Batch entrada · duas tarefas diferentes
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: uma operação sobre um arquivo

Envie um arquivo UTF-8 com um vídeo YouTube ID por linha. Selecione uma fonte suportada e um conjunto de opções para o arquivo inteiro. Bulk escaneia o arquivo, envia trabalho dentro da capacidade da conta e os resultados dos pacotes em partes para download.

  1. Escolha metadados, transcrição, legendas, classificação de licença ou download. Bulk pega vídeo IDs, usa Batch para busca de palavras-chave.
  2. Use um trabalho separado quando a fonte ou as opções mudarem. Por exemplo, metadados e transcrições para o mesmo arquivo são dois trabalhos Bulk.
  3. Para downloads, fornecer armazenamento de destino e acesso do proprietário com permissão youtube_download. As linhas de resultados descrevem mídia entregue, arquivos de mídia são armazenados em seu balde.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Planeje como você vai coletar resultados

ResponsabilidadeBatchBulk
Salve após a submissãoCada queries[].id, ligado à sua entrada original. Não há nenhum trabalho Batch ID.Um trabalho Bulk ID e o arquivo de entrada inalterado.
Completo da trilhaCada trabalho termina independentemente, uma falha não descreve o lote inteiro.Um trabalho expõe a contagem de progresso. Concluído significa que os resultados são embalados, não que todos os vídeos tenham sucesso.
Recolha a saídaConsiga o resultado de cada trabalho concluído e mantenha seu mapeamento de entrada para ID.Traga o manifesto e toda parte compacta do NDJSON. Junte-se pelo índice e video_id, não ordem de linha.
Retomar após a interrupçãoLeia o trabalho salvo IDs antes de considerar novas submissões.Verifique o Bulk salvo ID. Resolva pauseReason e retome o trabalho se parar.

Verifique a capacidade e o custo antes de começar

verificaçãoO que explicar?
BatchSeu plano é maxBatchSize limita as consultas por submissão. Dividir conjuntos maiores em grupos menores e respeitar a capacidade de trabalho pendente.
BulkAté 2 GiB por arquivo ID. O trabalho é submetido gradualmente dentro da capacidade da conta compartilhada, remover duplicatas antes do upload.
CréditosAgrupar não é uma carga simples. Consultas usam preços por fonte, downloads são medidos pelo tamanho dos dados entregues.
AcessoA chave deve permitir todas as fontes solicitadas. Verifique os limites da conta ativa, um teste não é uma conta de capacidade total.