# FlashData ou a YouTube Data API oficial

Escolha pela tarefa, compare uma resposta de metadados e verifique os custos de autorização e uso da legenda.

Referência canônica: https://flashdata.dev/pt/docs/guides/flashdata-vs-youtube-data-api
2026-11-04 por FlashData

<a id="choose"></a>

## 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.


<a id="comparison"></a>

### 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. |

- [Google Visão geral de API](https://developers.google.com/youtube/data/getting-started)

<a id="metadata"></a>

## 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.

### FlashData

#### Bash · flashdata-metadata.json

```bash
(
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
)
```


### Oficial. YouTube API

#### Bash · official-metadata.json

```bash
(
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
)
```


- [Defina sua chave FlashData](https://flashdata.dev/pt/docs/guides/http-quickstart/reference.md#prepare)
- [videos.list](https://developers.google.com/youtube/data/reference/rest/v3/videos/list)
- [FlashData esquema de metadados](https://flashdata.dev/pt/docs/sources/youtube_metadata/reference.md#response)

<a id="fields"></a>

### 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 |


<a id="captions"></a>

## 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.

- [Google requisitos de legenda](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)
- [Escolha uma língua e faixa](https://flashdata.dev/pt/docs/guides/youtube-data-guide/reference.md#captions)
- [Campos de etiqueta de licença](https://flashdata.dev/pt/docs/sources/youtube_trainability/reference.md)

<a id="workflows"></a>

## 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. |

- [Enriqueça uma lista de vídeos](https://flashdata.dev/pt/docs/guides/enrich-youtube-videos/reference.md)
- [Bulk receita de metadados](https://flashdata.dev/pt/docs/guides/bulk-metadata-recipe/reference.md)

<a id="billing"></a>

## 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.

- [Google cota custos](https://developers.google.com/youtube/data/determine_quota_cost)
- [FlashData Créditos e preços](https://flashdata.dev/pt/docs/guides/credits-and-billing/reference.md)
