# FlashData YouTube Trainability API

เช็ค YouTube ใบอนุญาตของวิดีโอสําหรับป้ายงานสร้างสรรค์คอมมอนส์ และรับผลที่ออกมา JSON.

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/sources/youtube_trainability
Recorder: 2026-10-23

จุดสิ้นสุด: POST https://data.flashdata.dev/v1/queries/realtime
การยืนยันตัวตน: X-API-Key: YOUR_API_KEY
โหมด: [Realtime](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/th/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md)

ต้องการสิทธิ์ที่อนุญาตจากแหล่ง: youtube_trainability

แทนที่ YOUR_API_KEY ด้วย API กุญแจที่มีแหล่งที่ได้รับอนุญาตนี้ และหน่วยกิตที่มีอยู่ ประมวลผลการร้องขอบนเซิร์ฟเวอร์หรือโฮสต์ตัวแทนของคุณ

[ตั้งค่าการตรวจสอบสิทธิ์](https://flashdata.dev/th/docs/guides/headers-and-authentication/reference.md)

[ตีความป้ายใบอนุญาต](https://flashdata.dev/th/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 และเรียกไพธอน 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") เมื่อตรวจพบป้ายงานสร้างสรรค์คอมมอนส์ มิฉะนั้น (ค.ศ."none"สืบค้นเมื่อใบอนุญาตหายไป ค่าเหล่านี้ไม่รายงานผู้สร้าง YouTube การตั้งค่าการฝึกซ้อมระดับสาม |

- จุดปลายนี้อ่านข้อมูลใบอนุญาตวิดีโอ มันไม่ได้รับค่า YouTube สิทธิ์ในการฝึกแบบกลุ่มที่สาม และค่าไม่ได้อนุญาตให้ฝึกในวีดีโอ

## รูปแบบคำตอบ

การตอบสนองต่าง ๆ ใช้ JSON โดยปริยายแล้ว เลือกรูปแบบอื่นด้วยส่วนหัวแบบเสริมเหล่านี้

- Accept: application/json (ค่าปริยาย) หรือ text/plain. ข้อความธรรมดาแสดงสนามเดียวกัน ในผังที่อ่านได้ และไม่สามารถเปลี่ยนแปลงได้
- X-Respond-With: markdown. ไม่ต้องตั้งค่าสําหรับสนามเดิม Markdown ทํางานกับรูปแบบการตอบสนองต่าง ๆ

Markdown มีการใช้งานสําหรับลําดับเวลาจริงและผลลัพธ์ที่เสร็จสมบูรณ์

ช่องข้อมูลด้านล่างนี้ ใช้อธิบายค่าปริยาย JSON ตอบสนอง

[ตัวอย่างการร้องขอและรูปแบบการตอบสนอง](https://flashdata.dev/th/docs/guides/response-formats/reference.md#headers)

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

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

## พื้นฐาน API

ตัวสร้างและตัวอย่างที่ต้องการด้านบน ใช้พารามิเตอร์ของแหล่งนี้ ใช้ Python ถึง cURL ตัวอย่างด้านล่างนี้ สําหรับการร่วมยอมจํานน สถานะ และขั้นตอนที่มีผล A Batch ร่างกายคือ JSON ออบเจกต์ที่มีลําดับ; แต่ละรายการจะคืนงานของมันเอง ID.

- [Async ร้องขอและใบเสร็จ](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md#async)

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

- [ตรวจสอบสถานะงานพิมพ์](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md#status)

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

- [ดึงข้อมูลผลลัพธ์ที่เสร็จสมบูรณ์แล้ว](https://flashdata.dev/th/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON ต้องการ](https://flashdata.dev/th/docs/reference/batch-and-bulk/reference.md#batch)
- [API ประมวลผล Bulk](https://flashdata.dev/th/docs/reference/bulk-processing/reference.md)
- [สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้](https://flashdata.dev/th/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/th/docs/guides/async-batch/reference.md#webhooks)

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

## การยิงปัญหา

- [ข้อผิดพลาดและรหัสสถานะ](https://flashdata.dev/th/docs/errors/reference.md#status-codes)
- [เมื่อต้องการลองใหม่](https://flashdata.dev/th/docs/errors/reference.md#retries)

## API ที่เกี่ยวข้อง

- [YouTube ข้อมูลกํากับภาพวิดีโอ API](https://flashdata.dev/th/docs/sources/youtube_metadata/reference.md)
- [YouTube Download API](https://flashdata.dev/th/docs/sources/youtube_download/reference.md)
