# FlashData YouTube Trainability API

Проверьте метаданные лицензии видео YouTube для ярлыка Creative Commons и получите результат JSON.

Каноническая ссылка: https://flashdata.dev/ru/docs/sources/youtube_trainability
Проверено: 2026-10-23

Конечная точка: POST https://data.flashdata.dev/v1/queries/realtime
Аутентификация: X-API-Key: YOUR_API_KEY
Режимы: [Realtime](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ru/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md)

Требуемое разрешение источника: youtube_trainability

Замените YOUR_API_KEY ключом API, который имеет это разрешение источника и доступные кредиты. Запустите запросы на вашем сервере или хосте-агенте.

[Настройка аутентификации](https://flashdata.dev/ru/docs/guides/headers-and-authentication/reference.md)

[Интерпретировать этикетки лицензий](https://flashdata.dev/ru/docs/guides/youtube-data-guide/reference.md#license)

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

## Отправить запрос

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

## Параметры

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

### Тело запроса

| Параметр | Тип | Обязательно | По умолчанию | Описание |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Да | — | Настройка на youtube_trainability.  |
| <a id="parameter-video_id"></a> video_id | string | Да | Не установлен | 11-символ YouTube видео ID, например FUfGcZ092b0. Принимает буквы, цифры, подчеркивания и дефисы. Минь длиной: 11. Длина: 11. Модель: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Нет | Не установлен | Async и пакетные. Публичный HTTPS завершает URL на порте 443, вплоть до символов 2,048. Никаких учетных данных пользователя или фрагмента URL. Omit, используйте null или пустую строку без уведомления. В партии, установите это на каждый запрос, вне парамов.  |

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

## Прочитайте результат

Сохраните успешный ответ JSON как response.json. Сохраните это как read-response.py и запустите python read-response.py. Он использует только стандартную библиотеку Python и не делает никаких новых запросов.

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

## Пример ответа

Записанный пример; поля и счета зависят от источника и запрошенного ввода.
```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"
}
```

## Поля реагирования

| Поле | Тип | Описание |
| --- | --- | --- |
| source | string | Запрошенный источник API. |
| status | string | Делается, когда запрос в режиме реального времени успешен. |
| created_at | string | Время создания ответов в формате ISO 8601. |
| usage.credits | number | Кредиты, взимаемые за запрос, исходя из вашего плана. |
| results[0].videoId | string | Запрошенное видео ID. |
| results[0].kind | string | Тип результата FlashData: youtube#videoTrainability. |
| results[0].etag | string | Видео ID перекликается с тегом ответа. |
| results[0].permitted | array<string> | ["all"] при обнаружении ярлыка Creative Commons; в противном случае ["none"], в том числе при отсутствии метаданных лицензии. Эти значения не сообщают о настройках обучения третьей стороны создателя YouTube. |

- Эта конечная точка считывает метаданные лицензии видео. Он не получает сторонние разрешения на обучение YouTube, и ни одна ценность не дает разрешения на обучение на видео.

## Форматы ответов

Реакции используют JSON по умолчанию. Выберите другой формат с этими дополнительными заголовками.

- Accept: application/json (по умолчанию) или text/plain. Простой текст представляет те же поля в читаемом, изрезанном макете.
- X-Respond-With: markdown. Оставьте незаполненными для оригинальных полей. Markdown работает с любым форматом ответа.

Markdown доступен для запросов в режиме реального времени и завершенных результатов.

В полях ниже описывается ответ JSON по умолчанию.

[Примеры форматов запросов и ответов](https://flashdata.dev/ru/docs/guides/response-formats/reference.md#headers)

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

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

## Основы API

В конструкторе запросов и приведенных выше примерах используются параметры этого источника. Используйте приведенные ниже примеры Python и cURL для общих этапов представления, статуса и результата. Тело Batch представляет собой объект JSON, содержащий запросы; каждый элемент возвращает свою работу ID.

- [Запрос и получение Async](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md#async)

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

- [Проверьте статус работы](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md#status)

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

- [Восстановление завершенных результатов](https://flashdata.dev/ru/docs/reference/realtime-and-async/reference.md#results)
- [Запросы Batch JSON](https://flashdata.dev/ru/docs/reference/batch-and-bulk/reference.md#batch)
- [API обработки Bulk](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md)
- [Создайте рабочий процесс Bulk для этого источника](https://flashdata.dev/ru/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [Клиент OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Уведомления о завершении

- [Получить и проверить завершение веб-хуков](https://flashdata.dev/ru/docs/guides/async-batch/reference.md#webhooks)

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

## устранение неполадок

- [Ошибки и коды состояния](https://flashdata.dev/ru/docs/errors/reference.md#status-codes)
- [Когда повторно](https://flashdata.dev/ru/docs/errors/reference.md#retries)

## Связанные API

- [YouTube Видео Метаданные API](https://flashdata.dev/ru/docs/sources/youtube_metadata/reference.md)
- [YouTube Download API](https://flashdata.dev/ru/docs/sources/youtube_download/reference.md)
