เรียกดูเอกสาร
เอกสารอ้างอิง API
YouTube Trainability API
เช็ค YouTube ใบอนุญาตของวิดีโอสําหรับป้ายงานสร้างสรรค์คอมมอนส์ และรับผลที่ออกมา JSON.
สร้างคำขอ
เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.
https://data.flashdata.dev/v1/queries/realtimeพารามิเตอร์
ส่ง source ถึง video_id ที่ระดับบนสุด แหล่งที่มานี้ไม่มี พารัมที่ระบุแหล่ง ช่องข้อมูลทางเลือกสามารถยกเลิกได้
เนื้อหาคำขอ
sourcestring / จำเป็น- กําหนดเป็น youtube_trainability
video_idstring / จำเป็น- เดอะ 11- ช่างทําเล็บ YouTube วิดีโอ IDเช่น FUFGCZ092b0. รับจดหมาย ตัวเลข อุปทาน และไฮเฟนตรงกับ 11 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่ารูปแบบที่ยอมรับได้
^[A-Za-z0-9_-]{11}$ callback_urlstring · nullable / ไม่บังคับ- Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่าค่าปริยาย:
ยังไม่ได้ตั้งค่า
คำตอบ
Realtime กลับค่า status: done. อ่านผลลัพธ์ที่ส่งมาจากแหล่ง results[0].permitted; usage.credits บันทึกค่าใช้จ่าย.
ผล ที่ ตาม มา videoId และรายงานด้วย อนุมัติและอนุญาต [ผู้ทํางานตรวจสอบป้ายใบอนุญาตของวิดีโอ: ["all"สําหรับการตรวจสอบป้ายงานสร้างสรรค์คอมมอนส์ ไม่งั้น"none"] รวมถึงข้อมูลใบอนุญาตหายด้วย
อ่านผลที่ออกมา
บันทึกความสําเร็จ JSON ตอบกลับเป็น response.json. บันทึกนี้เป็น read-response.py และเรียกไพธอน 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))แหล่งที่มานี้ไม่มีทางเลือกที่ระบุแหล่ง ส่ง video_id ที่ระดับบนสุด; param เลื่อน
จุดปลายนี้ไม่ได้รับข้อมูลผู้สร้าง YouTube การตั้งค่าการฝึกซ้อมระดับสาม ไม่อนุญาตสิทธิ์ในการอบรม ช่องข้อมูลนี้เป็นเพียงผลลัพธ์ของการตรวจสอบใบรับรองเท่านั้น
ช่องข้อมูลทั้งหมด
| ช่องข้อมูล | คําอธิบาย |
|---|---|
sourcestring | สิ่งที่ร้องขอมา API แหล่งข่าว |
statusstring | เสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ |
created_atstring | ช่วงเวลาการสร้างแบบ ISO 8601 |
usage.creditsnumber | บัตรเครดิตตามที่ขอ จากแผนของคุณ |
results[0].videoIdstring | รายการที่ขอมาคือ ID |
results[0].kindstring | FlashData ชนิดของผลลัพธ์: Youtube#videoTrainability. |
results[0].etagstring | วิดีโอ ID สะท้อนเป็นแท็กตอบรับ |
results[0].permittedarray<string> | ["all") เมื่อตรวจพบป้ายงานสร้างสรรค์คอมมอนส์ มิฉะนั้น (ค.ศ."none"สืบค้นเมื่อใบอนุญาตหายไป ค่าเหล่านี้ไม่รายงานผู้สร้าง YouTube การตั้งค่าการฝึกซ้อมระดับสาม |
ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย JSON ตอบสนอง JSONข้อความธรรมดาและ Markdown รูปแบบ.
Async คืนค่าเป็นใบเสร็จงานหนึ่งตัว; จํานวนครั้งจะคืนค่ากลับมาเป็นหนึ่งตัว วิดีโอ ID. โปรดตรวจสอบสถานะงานพิมพ์แต่ละงาน และรับผลของมันโดยใช้ที่อยู่เชื่อมโยงที่ส่งกลับ
Async วงจรชีวิตแบบชุด
การรับช่วงนําใบเสร็จกลับมา ไม่ใช่ผลลัพธ์ Async สร้างงานหนึ่งงาน; กลุ่มต่าง ๆ จะคืนค่ากลับมาเป็นงานที่แยกไว้ queries[] สําหรับทุก ๆ คนที่สอบถามเจ้า ติดตามและรับงานแต่ละงานเป็นอิสระ
ส่งข้อมูลไปยัง data.flashdata.dev; สืบค้นสถานะงานและผลลัพธ์จาก api.flashdata.dev กับ X-API-Key แบบเดียวกัน ความ เกี่ยว พัน API ตัวอย่างพื้นฐานที่ใช้ Python ถึง cURL.
1. บันทึกงาน IDs
เก็บรายการที่ต้องการของแหล่งนี้เมื่อสลับไปยัง Async สําหรับ Batchใส่การร้องขอแต่ละในลําดับของ JSON วัตถุ บันทึกงานที่ส่งกลับทั้งหมด ID
2. ตรวจสอบสถานะ
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: โพลด้วยความล่าช้าและความเคารพRetry-Afterเมื่อถึงวันนี้completed: รับผลfailed: สืบค้นเมื่อjob.error.อ่าน job.status ไม่ใช่สถานะใบเสร็จรับส่ง
ตรวจสอบสถานะที่: Python ถึง cURL
สถานะงาน API อ้างอิง3. ดึงข้อมูลผลลัพธ์
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsหลังจากเติมให้สมบูรณ์แล้ว ให้ยืนยันการอ่านผลที่อ่านแล้ว 302 คลังสื่อ URL # หากไม่มีเธอ # API กุญแจ บันทึก JSON ภายใน 24 ชั่วโมงของการเติมให้สมบูรณ์
ดึงข้อมูลผลลัพธ์ที่ออกมา Python ถึง cURL · รูปแบบคำตอบ
ดาวน์โหลดผลลัพธ์ API อ้างอิง
การ สํารวจ และ ได้ ผล ที่ มี อยู่ แล้ว ไม่ ได้ ใช้ เงิน เครดิต ที่ สอบ ถาม. จับเวลาแบบสํารวจไม่ได้ยกเลิกงาน: ให้ ID แทนการส่งงานที่ซ้ํากัน % 1 ไม่ถูกต้อง!.
Webhook เมื่อเสร็จสิ้น
บอกรับต่อคําค้น
ตั้งค่า callback_url ที่ระดับบนสุดของการร้องขอ Asinc หรือ ภายในแต่ละคําถาม ในชุดที่อยู่นอก params. ไม่มีความต้องการการแยกเว็บฮุค- regressing Realtime ร้องขอไม่ให้ส่งการเรียกกลับ
ใช้สาธารณะชน HTTPS URL บนพอร์ต 443. FlashDataPOSTS แจ้งเตือนสําหรับแต่ละงานพิมพ์ที่ไปถึง completed หรือ failed; เหตุการณ์ที่บรรจุลิงก์ ไม่ใช่ผลลัพธ์เอง
การยอมรับและตรวจสอบ
กลับค่า 2xx หลังจากยอมรับเหตุการณ์นั้น บิดเบี้ยวโดย delivery_id, ยังถูกส่งมาเป็น X-Delivery-Id. ไม่ ปฏิบัติ ตาม การ ชี้ นํา.
การส่งล้มเหลว การลองใหม่ด้วยการกลับแบบเอกซ์โปเนนเชียลขึ้นไป 8 พยายามรวมทั้งหมด และที่มากที่สุด 24 ชั่วโมงหลังจากเติมให้สมบูรณ์แล้ว. ให้การวินิจฉัยเป็น การผิดพลาด
การเรียกตัวยังไม่แน่ชัด ยืนยันงาน IDแหล่งที่มาและสถานะปลายทางผ่าน สถานะที่ยืนยันแล้ว ก่อนที่จะประมวลผลการแจ้งเตือน การส่งมอบ ID สําหรับ deduction, ไม่ใช่ข้อพิสูจน์ของความเป็นจริง
ตัวอย่าง Hook เหตุการณ์และช่องข้อมูล
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_trainability",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| ช่องข้อมูล | คําอธิบาย |
|---|---|
delivery_idstring | เครื่องระบุการจัดส่งที่ทนทาน การแจ้งให้ทราบแบบย่อโดยใช้ค่านี้; มันถูกส่งมาใน X-Delivery-Id ส่วนหัว |
idstring | Joob ID. |
sourcestring | ต้องการแหล่งข้อมูล |
statusstring | เสร็จสมบูรณ์หรือล้มเหลว |
linksarray | สถานะและการเชื่อมโยงผลลัพธ์ การแจ้งให้ทราบไม่รวมเนื้อหาหรือรายการที่มีผล API กุญแจ |
links[].relstring | ตัวตนหรือผลลัพธ์ |
links[].hrefstring | การจัดการสัมบูรณ์ API URL2; ยืนยันตัวด้วย API กุญแจ |
links[].methodstring | GET. |
ประมวลผลไฟล์แบบ Bulk
อัปโหลดหนึ่งวิดีโอ ID ต่อบรรทัดและสร้าง Bulk ทํางานกับแหล่ง: youtube_trainability. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID
แหล่งนี้ไม่มีตัวเลือกที่ระบุแหล่ง; ตั้งค่าแหล่งและอัปโหลดแฟ้ม ID
รับค่าสะสมที่สมบูรณ์เป็นรายการและบีบอัดข้อมูล gzip NDJSON ชิ้นส่วนผลลัพธ์ แหล่ง ข้อมูล ยัง สามารถ ส่ง ส่วน ต่าง ๆ ที่ ได้ จาก การ เก็บ เมฆ ของ คุณ ได้ ด้วย โดย การ วาง options.result_storage เมื่อสร้าง Bulk งาน เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว
Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ
สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว
การกู้คืนผิดพลาด
A ["none"ผลก็คือเช็คใบขับขี่เสร็จแล้ว ไม่ใช่งานล้มเหลว อาจหมายถึงไม่มีป้ายใบอนุญาติ วิดีโอที่ถูกลบออกหรือเข้าไม่ได้ อาจล้มเหลวในระหว่างการคลายข้อมูล
สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอunit-format และอัตราการสิ้นสุดของอัตรา - การอ้างอิงข้อผิดพลาดร่วมกัน เวลา ที่ ใช้ ไป แล้ว อาจ ยัง คง สร้าง งาน อยู่; ตรวจ สอบ งาน ที่ มี อยู่ ก่อน จะ ลอง ทํา ใหม่.
ข้อผิดพลาดและรหัสสถานะ · เมื่อต้องการลองใหม่ · ข้อจํากัดของอัตรา
ไกด์ทีละขั้น: ตีความป้ายใบอนุญาต
ราคา
| แผน | อัตราการใช้ต่อ 1,000 คำขอมาตรฐาน | สมาชิก | รวมการให้เครดิตต่อช่วงเวลาเรียกเก็บเงิน |
|---|---|---|---|
| จ่ายตามการใช้งาน | US$0.50 | ไม่มีค่าบริการรายเดือน | เติมเครดิตเมื่อจำเป็น |
| Micro | US$0.40 | US$49.00 / เดือน | 1,000 เครดิต (Chonder)US$50.00 ของ API การใช้) รวม |
| Starter | US$0.35 | US$199.00 / เดือน | 4,000 เครดิต (Chonder)US$200.00 ของ API การใช้) รวม |
| Pro | US$0.30 | US$499.00 / เดือน | 10,000 เครดิต (Chonder)US$500.00 ของ API การใช้) รวม |
| Scale | US$0.25 | US$999.00 / เดือน | 20,000 เครดิต (Chonder)US$1,000.00 ของ API การใช้) รวม |
| Business | US$0.20 | US$1,999.00 / เดือน | 40,000 เครดิต (Chonder)US$2,000.00 ของ API การใช้) รวม |
หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ
ราคาและแผนจํากัดในปัจจุบัน