# FlashData YouTube Trainability API

Kiểm tra một YouTube Bằng lái của video siêu dữ liệu cho một nhãn chung sáng tạo và lấy kết quả từ JSON.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/sources/youtube_trainability
Xem lại: 2026-10-23

Điểm kết thúc: POST https://data.flashdata.dev/v1/queries/realtime
Xác thực: X-API-Key: YOUR_API_KEY
Chế độ: [Realtime](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/vi/docs/reference/bulk-processing/reference.md)

Cần thiết quyền truy cập nguồn: youtube_trainability

Thay thế YOUR_API_KEY với một API Chìa khóa mà có quyền sử dụng nguồn này và tín dụng sẵn có. Chạy yêu cầu trên máy chủ hay máy phục vụ.

[Đang thiết lập xác thực](https://flashdata.dev/vi/docs/guides/headers-and-authentication/reference.md)

[Nhãn chứng nhận giao tiếp](https://flashdata.dev/vi/docs/guides/youtube-data-guide/reference.md#license)

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

## Gửi một yêu cầu

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

## Tham số

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

### Nội dung yêu cầu

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Vâng | — | Thiết lập youtube_trainability.  |
| <a id="parameter-video_id"></a> video_id | string | Vâng | Chưa đặt | Hạt 11- Hồ sơ. YouTube video IDNhư FUfGcZ092b0. Chấp nhận chữ cái, số, điểm nhấn và dấu gạch nối. Chiều dài tối thiểu: 11. Chiều dài tối đa: 11. Mẫu: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Không | Chưa đặt | Async và chỉ một mẻ. Chung HTTPS hoàn tất URL trên cổng 443Đến 2,048 các nhân vật. Không có phân khúc người dùng hay URL. Omit, dùng null hoặc chuỗi rỗng không cho thông báo nào. Trong một mẻ, đặt nó trên mỗi câu hỏi, bên ngoài các tham số.  |

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

## Đọc kết quả

Cứu người thành công JSON trả lời response.json. Lưu cái này vào read-response.py và chạy python read-response.py. Nó chỉ dùng thôi. PythonThư viện thông thường và không có yêu cầu mới.

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

## Phản hồi mẫu

Ví dụ được thu; trường và số phụ thuộc vào nguồn và yêu cầu nhập.
```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"
}
```

## Trường đáp ứng

| Tìm kiếm | Kiểu | Mô tả |
| --- | --- | --- |
| source | string | Nguồn API đã yêu cầu. |
| status | string | hoàn thành khi yêu cầu thời gian thực thành công. |
| created_at | string | Thời gian tạo ra đáp ứng trong ISO 8601 Định dạng. |
| usage.credits | number | Các nguồn tin cho yêu cầu, dựa trên kế hoạch của anh. |
| results[0].videoId | string | Video đã yêu cầu ID. |
| results[0].kind | string | FlashData loại: bạn in#videoTrainability. |
| results[0].etag | string | Ảnh động ID vang lên như thẻ đáp ứng. |
| results[0].permitted | array<string> | ["all"] Khi một nhãn hiệu sáng tạo chung được phát hiện; nếu không ["none"], bao gồm cả khi thiếu bằng lái xe. Những giá trị này không báo cáo tác giả YouTube Thiết lập đào tạo bên thứ ba. |

- Điểm kết thúc này đọc siêu dữ liệu bằng hình ảnh. Không thể nào lấy lại được. YouTube Quyền huấn luyện của bên thứ ba, và không có giá trị cho phép huấn luyện trên video.

## Định dạng phản hồi

Đáp ứng được dùng JSON theo mặc định. Chọn một định dạng khác với những đầu trang tùy chọn này.

- Accept: application/json (mặc định) hay text/plain. Văn bản thường trình bày cùng một lĩnh vực trong một bố trí có thể đọc được, được in lề.
- X-Respond-With: markdown. Hãy để lại chỗ trống cho những cánh đồng nguyên thủy. Markdown hoạt động với định dạng trả lời.

Markdown có sẵn cho các yêu cầu thời gian thực và kết quả hoàn tất.

Các trường bên dưới mô tả giá trị mặc định JSON Trả lời đi.

[Ví dụ định dạng đáp ứng yêu cầu](https://flashdata.dev/vi/docs/guides/response-formats/reference.md#headers)

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

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

## Kiến thức cơ bản về API

Các yêu cầu xây dựng và ví dụ trên sử dụng các tham số của nguồn này. Sử dụng Python và cURL Những ví dụ bên dưới để được chia sẻ sự phục tùng, địa vị và kết quả là bước. A Batch Cơ thể là một JSON Đối tượng chứa các đồ thị; mỗi món đồ trả lại công việc của chính mình ID.

- [Async yêu cầu và biên lai](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async)

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

- [Kiểm tra tình trạng công việc](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#status)

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

- [Lấy kết quả hoàn tất](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON yêu cầu](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)
- [API xử lý Bulk](https://flashdata.dev/vi/docs/reference/bulk-processing/reference.md)
- [Xây dựng a Bulk dòng làm việc cho nguồn này](https://flashdata.dev/vi/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [Trình khách OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Thông báo đầy đủ

- [Nhận và kiểm tra hoàn tất kết nối web](https://flashdata.dev/vi/docs/guides/async-batch/reference.md#webhooks)

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

## Khắc phục sự cố

- [Lỗi và mã trạng thái](https://flashdata.dev/vi/docs/errors/reference.md#status-codes)
- [Khi nào cần thử lại](https://flashdata.dev/vi/docs/errors/reference.md#retries)

## API liên quan

- [YouTube Siêu dữ liệu ảnh động API](https://flashdata.dev/vi/docs/sources/youtube_metadata/reference.md)
- [YouTube Download API](https://flashdata.dev/vi/docs/sources/youtube_download/reference.md)
