Explorar documentação
Primeiros passos
Escolha pela tarefa, compare uma resposta de metadados e verifique os custos de autorização e uso da legenda.
Nesta página
Escolha pela tarefa
FlashData é um serviço separado do Google YouTube Data API. As credenciais, campos de resposta e modelos de faturamento são diferentes.
Em um relance
| Tarefa | YouTube Oficial Dados API | FlashData |
|---|---|---|
| Metadados de vídeo | videos.list | youtube_metadata |
| Busca e descoberta | YouTube consultas de recursos e paginação. | Pesquisa padrão/extendida, canais e sugestões. |
| Legendas: | Operações de legenda autorizadas, downloads requerem permissão de edição para o vídeo. | Recupere faixas existentes para o idioma e a fonte de legenda. |
| Mudanças de contas | Carregamentos documentados e outros escritos autorizados. | Recuperação e entrega, sem mutações na conta YouTube. |
| Arquivos de mídia | Uma resposta de vídeo-recurso é metadados. | Antecedentes baixados para o seu armazenamento. |
Compare um pedido de metadados
Use Bash, cURL e jq. Para Google, ativar YouTube Data API v3 em seu projeto e definir GOOGLE_API_KEY. Para FlashData, definir FLASHDATA_API_KEY com permissão youtube_metadata. Cada guia faz um pedido e salva sua resposta; execute o provedor que você quer avaliar.
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 120 \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"source": "youtube_metadata",
"video_id": "jNQXAC9IVRw",
"params": {
"include_formats": false,
"include_chapters": false
}
}' > flashdata-metadata.json
jq -e '.status == "done"' flashdata-metadata.json >/dev/null
jq '.results | map({video_id: .videoId, title, channel, duration_seconds: .duration})' \
flashdata-metadata.json
)(
set -euC
: "${GOOGLE_API_KEY:?Set GOOGLE_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 30 --get \
'https://www.googleapis.com/youtube/v3/videos' \
--data-urlencode "key=$GOOGLE_API_KEY" \
--data-urlencode 'part=snippet,contentDetails' \
--data-urlencode 'id=jNQXAC9IVRw' > official-metadata.json
jq '.items | map({video_id: .id, title: .snippet.title,
channel: .snippet.channelTitle, duration_iso8601: .contentDetails.duration})' \
official-metadata.json
)Mapeie os campos de resultados
Uma resposta bem sucedida contém o vídeo solicitado. Uma matriz items/results vazia significa que nenhum registro correspondente foi retornado. Mantenha a resposta original e mapeie os campos explicitamente em sua aplicação.
| Valor | Resposta oficial | Resposta FlashData |
|---|---|---|
| ID do vídeo | items[0].id | results[0].videoId |
| Título | items[0].snippet.title | results[0].title |
| Nome do canal | items[0].snippet.channelTitle | results[0].channel |
| Duração | contentDetails.duration · ISO 8601 | duração · segundos |
Verifique o acesso da legenda separadamente
Google captions.download requer autorização OAuth para editar o vídeo. FlashData recupera faixas existentes: transcrição padrão para legendas automáticas; Legendas padrão para faixas fornecidas pelo uploader. Especifique linguagem e auto explicitamente ao comparar saídas.
FlashData não gera uma transcrição ou tradução. Sua fonte de licença relata metadados da Creative Commons, não concede direitos de treinamento ou lê a configuração de permissão de treinamento separada de um criador.
Vamos de um vídeo para uma coleção
Escolha o fluxo de trabalho FlashData que combina com sua entrada. Pesquisa Padrão aceita até 20 resultados solicitados; A pesquisa estendida aceita até 700 a uma taxa separada.
| Entrada | Fluxo de trabalho |
|---|---|
| Um tópico ou pesquisa | Pesquisa padrão ou estendida → salvar vídeo IDs → metadados. |
| Uma pequena lista de pedidos | Submissão em lote regular com resultados por trabalho. |
| Um arquivo de vídeo IDs | Metadados Bulk, transcrição, legendas, etiquetas de licença ou downloads. |
Compare quota e créditos
Google aplica cota de projeto e custos específicos do método. FlashData usa contas compartilhadas Créditos e taxas específicas de fonte; o uso de download é baseado em bytes de mídia entregues. Verifique os métodos, a taxa de planejamento e a carga de trabalho que você vai usar.