# FlashData YouTube Trainability API

Verifique os metadados de licença de um vídeo YouTube para uma etiqueta Creative Commons e recupere o resultado como JSON.

Referência canônica: https://flashdata.dev/pt/docs/sources/youtube_trainability
Revisado: 2026-10-23

Ponto final: POST https://data.flashdata.dev/v1/queries/realtime
Autenticação: X-API-Key: YOUR_API_KEY
Modos: [Realtime](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/pt/docs/reference/bulk-processing/reference.md)

Precisou de permissão de origem: youtube_trainability

Substitua YOUR_API_KEY por uma chave API que tem essa permissão de fonte e créditos disponíveis. Execute pedidos no seu servidor ou host de agente.

[Configurar autenticação](https://flashdata.dev/pt/docs/guides/headers-and-authentication/reference.md)

[Intérprete etiquetas de licença](https://flashdata.dev/pt/docs/guides/youtube-data-guide/reference.md#license)

<a id="quickstart"></a>

## Envie um pedido

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_trainability",
    "video_id": "dQw4w9WgXcQ",
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_trainability",
  "video_id": "dQw4w9WgXcQ"
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parâmetros

<a id="parameters-group-0"></a>

### Corpo da requisição

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Sim | — | Preparar para youtube_trainability.  |
| <a id="parameter-video_id"></a> video_id | string | Sim | Não está pronto | O 11-caracter YouTube vídeo ID, como FUfGcZ092b0. Aceita letras, números, sublinhados e hífens. Comprimento mínimo: 11. Comprimento máximo: 11. Padrão: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Não | Não está pronto | Async e apenas lote. HTTPS conclusão URL na porta 443, até caracteres 2,048. Sem credenciais de usuário ou fragmento URL. Omit, use null ou uma string vazia para nenhuma notificação. Em um lote, coloque isso em cada consulta, fora dos parâmetros.  |

<a id="response"></a>

## Leia o resultado

Salve a resposta JSON bem sucedida como response.json. Guarde isso como read-response.py e execute python read-response.py. Ele usa apenas a biblioteca padrão do Python e não faz nenhum novo pedido.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {"videoId": result.get("videoId"), "permitted": result.get("permitted", [])}
# Keep the label values; this is not a training-rights authorization.
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Exemplo de resposta

Exemplo gravado; campos e conta depende da fonte e entrada solicitada.
```json
{
  "source": "youtube_trainability",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "kind": "youtube#videoTrainability",
      "etag": "dQw4w9WgXcQ",
      "permitted": [
        "none"
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:45:48.691Z"
}
```

## Campos de resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| source | string | A fonte API solicitada. |
| status | string | Feito quando o pedido em tempo real for bem sucedido. |
| created_at | string | Tempo de criação de resposta no formato ISO 8601. |
| usage.credits | number | Créditos cobrados pelo pedido, baseado no seu plano. |
| results[0].videoId | string | O vídeo solicitado ID. |
| results[0].kind | string | FlashData tipo de resultado: youtube#videoTrainability. |
| results[0].etag | string | O vídeo ID ecoou como a etiqueta de resposta. |
| results[0].permitted | array<string> | ["all"] quando um rótulo Creative Commons é detectado; caso contrário ["none"], incluindo quando os metadados da licença estão faltando. Esses valores não reportam as configurações de treinamento de terceiros do criador YouTube. |

- Este ponto final lê os metadados da licença de vídeo. Ele não recupera permissão de treinamento de terceiros YouTube, e nenhum valor concede permissão para treinar no vídeo.

## Formatos de resposta

Respostas usam JSON por padrão. Escolha outro formato com esses cabeçalhos opcionais.

- Accept: application/json (padrão) ou text/plain. Texto simples apresenta os mesmos campos em um layout legível e indentado.
- X-Respond-With: markdown. Deixe de lado os campos originais. Markdown funciona com qualquer formato de resposta.

Markdown está disponível para consultas em tempo real e resultados completos.

Os campos abaixo descrevem a resposta padrão JSON.

[Requisito e formatação de resposta exemplos](https://flashdata.dev/pt/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## Conceitos básicos da API

O construtor de pedidos e exemplos acima usam os parâmetros desta fonte. Use os exemplos Python e cURL abaixo para submissão compartilhada, status e passos de resultado. Um corpo Batch é um objeto JSON contendo consultas, cada item retorna seu próprio trabalho ID.

- [Async pedido e recibo](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Verifique o status do trabalho](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Recupere resultados completados](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON pedidos](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md#batch)
- [API de processamento Bulk](https://flashdata.dev/pt/docs/reference/bulk-processing/reference.md)
- [Construir um fluxo de trabalho Bulk para esta fonte](https://flashdata.dev/pt/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [Cliente OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Notificações de conclusão

- [Receba e verifique os hooks de conclusão](https://flashdata.dev/pt/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Solução de problemas

- [Erros e códigos de status](https://flashdata.dev/pt/docs/errors/reference.md#status-codes)
- [Quando tentar novamente](https://flashdata.dev/pt/docs/errors/reference.md#retries)

## APIs relacionadas

- [YouTube Video Metadata API](https://flashdata.dev/pt/docs/sources/youtube_metadata/reference.md)
- [YouTube Download API](https://flashdata.dev/pt/docs/sources/youtube_download/reference.md)
