# FlashData YouTube Trainability API

تحقق من YouTube البيانات الوصفية لرخصة الفيديو لعلامة مشاعات الإبداع واسترجاع النتيجة JSON.

مرجع كانوني: https://flashdata.dev/ar/docs/sources/youtube_trainability
جرى استعراضها: 2026-10-23

نقطة النهاية: POST https://data.flashdata.dev/v1/queries/realtime
المصادقة: X-API-Key: YOUR_API_KEY
Modes: [Realtime](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md)

إذن المصدر المطلوب: youtube_trainability

يستعاض عن YOUR_API_KEY بمفتاح API الذي يملك هذا المصدر من الأذن والائتمانات المتاحة. أجري طلبات على خادمك أو وكيل مضيف.

[إقامة المصادقة](https://flashdata.dev/ar/docs/guides/headers-and-authentication/reference.md)

[بطاقات ترخيص الترجمة الشفوية](https://flashdata.dev/ar/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 | نعم | غير محدد | معرّف فيديو YouTube من 11 محرفًا، مثل FUfGcZ092b0. يقبل الحروف والأرقام والشرطات السفلية والواصلات. صغر المدة: 11. أقصى مدة: 11. Pattern: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | لا | غير محدد | لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.  |

<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 result type: youtube#videoTrainability. |
| results[0].etag | string | Video ID echoed as the response tag. |
| 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/ar/docs/guides/response-formats/reference.md#headers)

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

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

## أساسيات API

يستخدم منشئ الطلبات والأمثلة أعلاه معاملات هذا المصدر. استخدم أمثلة Python وcURL أدناه لخطوات الإرسال والحالة والنتائج المشتركة. جسم Batch هو كائن JSON يحتوي queries؛ ويعيد كل عنصر معرّف مهمة خاصًا به.

- [Async Request and receipt](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#async)

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

- [التحقق من حالة العمل](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#status)

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

- [استرجاع النتائج المنجزة](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md#batch)
- [واجهة API لمعالجة Bulk](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md)
- [بناء تدفق عمل من طراز Bulk لهذا المصدر](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md?source=youtube_trainability#playground)
- [العملاء المفتوحون](https://flashdata.dev/docs/openapi.json)

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

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

## الإخطارات المتعلقة بالإنجاز

- [استلام وثائق الإنجاز على شبكة الإنترنت والتحقق منها](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#webhooks)

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

## اضطرابات

- [الأخطاء ورموز الحالة](https://flashdata.dev/ar/docs/errors/reference.md#status-codes)
- [متى يُعيدُ النظر](https://flashdata.dev/ar/docs/errors/reference.md#retries)

## APIs ذات الصلة

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