เรียกดูเอกสาร
เอกสารอ้างอิง API
YouTube ข้อมูลกํากับภาพวิดีโอ API
เรียกข้อมูลกํากับวิดีโอโดย YouTube วิดีโอ IDทั้งรายละเอียดทางช่อง, จํานวนการหมั้น, ภาพตัวอย่าง, รูปแบบและบทที่มี
สร้างคำขอ
เดอะ 11- ช่างทําเล็บ ID จากวีดีโอ URLไม่เต็ม URL.
https://data.flashdata.dev/v1/queries/realtimeพารามิเตอร์
ส่ง source ถึง video_id ที่ระดับบนสุด ตัวเลือกของแหล่งอยู่ใน params. ช่องข้อมูลทางเลือกสามารถยกเลิกได้
เนื้อหาคำขอ
sourcestring / จำเป็น- กําหนดเป็น youtube_metadata
video_idstring / จำเป็น- เดอะ 11- ช่างทําเล็บ YouTube วิดีโอ IDเช่น FUFGCZ092b0. รับจดหมาย ตัวเลข อุปทาน และไฮเฟนตรงกับ 11 ตัวอักษรค่าปริยาย:
ยังไม่ได้ตั้งค่ารูปแบบที่ยอมรับได้
^[A-Za-z0-9_-]{11}$ paramsobject / ไม่บังคับ- Settings สําหรับการร้องขอนี้ค่าปริยาย:
{} callback_urlstring · nullable / ไม่บังคับ- Async และชุดเท่านั้น สาธารณะ HTTPS เสร็จสมบูรณ์แล้ว URL บนพอร์ต 443ถึง 2,048 ตัวละคร ไม่มีเอกสารรับรองผู้ใช้หรือส่วน URL Omit, ใช้ null หรือข้อความเปล่าสําหรับไม่ให้แจ้งเตือน ในชุดนี้ กําหนดให้แต่ละคําถาม ภายนอกพม่าค่าปริยาย:
ยังไม่ได้ตั้งค่า
ตัวเลือกการตอบกลับ
params.include_formatsboolean / ไม่บังคับ- รวมรูปแบบของสื่อที่มี และการเข้ารหัส, มติและข้อมูลอัตราส่งถ่ายข้อมูลด้วย
trueหรือfalseค่าปริยาย:true params.include_chaptersboolean / ไม่บังคับ- รวมไปถึงบทที่วิดีโอมี
trueหรือfalseค่าปริยาย:true
คำตอบ
Realtime กลับค่า status: done. อ่านผลลัพธ์ที่ส่งมาจากแหล่ง results[0]; usage.credits บันทึกค่าใช้จ่าย.
ข้อมูลกํากับภาพของวิดีโอหนึ่งรวม videoIdชื่อเพลง รายละเอียดทางช่อง ช่วงเวลาและการหมั้นนับ
อ่านผลที่ออกมา
บันทึกความสําเร็จ 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 = {name: result.get(name) for name in (
"videoId", "title", "channel", "duration", "hasTranscripts", "transcriptLanguages"
)}
print(json.dumps(output, ensure_ascii=False, indent=2))ตัวเลือกการตอบกลับทั้งสองแบบ จะหมายถึง true เมื่อตัดการเชื่อมต่อแล้ว ปิดการใช้งาน include_formats สําหรับการตอบสนองที่มีขนาดเล็ก เมื่อคุณต้องการเฉพาะข้อมูลกํากับ บทต่าง ๆ จะปรากฎก็ต่อเมื่อมีการร้องขอและใช้ได้เท่านั้น จํานวนที่ไม่สามารถวัดได้อาจจะเป็น null
formats จงอธิบายรหัสอักขระที่มีอยู่; มันไม่ได้ดาวน์โหลดวิดีโอ hasTranscripts ถึง transcriptLanguages อธิบายได้แต่ไม่ปรากฏข้อความร่าง ใช้ API ดาวน์โหลด สําหรับสื่อและ ทรานสคริปต์ API สําหรับข้อความ
ช่องข้อมูลทั้งหมด
| ช่องข้อมูล | คําอธิบาย |
|---|---|
sourcestring | สิ่งที่ร้องขอมา API แหล่งข่าว |
statusstring | เสร็จสิ้นเมื่อการร้องขอจริง สําเร็จ |
created_atstring | ช่วงเวลาการสร้างแบบ ISO 8601 |
usage.creditsnumber | บัตรเครดิตตามที่ขอ จากแผนของคุณ |
results[0].videoIdstring | YouTube วิดีโอ ID. |
results[0].titlestring | ชื่อวิดีโอ |
results[0].descriptionstring | รายละเอียดวิดีโอทั้งหมด |
results[0].channelstring | ชื่อทางช่อง |
results[0].channelIdstring | ช่อง ID. |
results[0].channelUrlstring | ช่อง URL. |
results[0].channelSubscriberCountnumber · nullable | นับสมาชิกทางช่อง |
results[0].viewCountnumber · nullable | ดูนับสิ |
results[0].likeCountnumber · nullable | เหมือนนับ |
results[0].commentCountnumber · nullable | นับด้วยความคิดเห็น |
results[0].uploadDatestring · nullable | วันที่อัพโหลด |
results[0].durationnumber · nullable | ระยะเวลาวิดีโอเป็นวินาที |
results[0].durationStringstring · nullable | ช่วงเวลารูปแบบเมื่อมีใช้งาน |
results[0].thumbnailsarray | ภาพตัวอย่าง URLs และขนาด |
results[0].categoriesarray | หมวดหมู่วิดีโอ |
results[0].tagsarray | แท็กวิดีโอ |
results[0].ageLimitinteger | ห้ามอายุ หรือ 0 เมื่อเกิดความไม่สงบ |
results[0].isLiveboolean | จะใช้วีดิทัศน์ปัจจุบันหรือไม่ |
results[0].wasLiveboolean | วีดีโอเป็นกระแสสดหรือเปล่า |
results[0].hasTranscriptsboolean | มีคําบรรยายภาพอยู่หรือไม่ |
results[0].transcriptLanguagesarray | โค้ดภาษาของคําบรรยายภาพที่มีอยู่ |
results[0].formatsarray · optional | รูปแบบสื่อที่มีเมื่อ include_formats คือ true. |
results[0].chaptersarray · optional | ชื่อเพลงบท start_time ถึง end_time ไม่กี่วินาทีเมื่อร้องขอและว่าง |
ช่องข้อมูลด้านบน จะใช้อธิบายค่าปริยาย 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_metadata",
"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_metadata. ตัวเลือกที่ใช้ร่วมกันจะถูกปรับใช้กับทุกแฟ้มคือ ID
ตัวเลือกของแหล่ง: include_formats, include_chapters. เพิ่มตัวเลือกเมื่อสร้างงาน Bulk
รับค่าสะสมที่สมบูรณ์เป็นรายการและบีบอัดข้อมูล gzip NDJSON ชิ้นส่วนผลลัพธ์ แหล่ง ข้อมูล ยัง สามารถ ส่ง ส่วน ต่าง ๆ ที่ ได้ จาก การ เก็บ เมฆ ของ คุณ ได้ ด้วย โดย การ วาง options.result_storage เมื่อสร้าง Bulk งาน เว้นแต่คํากล่าวที่รัดกุมชัดเจนเท่านั้น 24 หนึ่งชั่วโมงหลังจากทั้งหมด Bulk งานเสร็จสมบูรณ์แล้ว
Bulk การประมวลผล API · Python ถึง cURL · Batch JSON ต้องการ
สร้าง Bulk การ ไหล เวียน ของ แหล่ง นี้ · หยุดชั่วคราว และทําต่อและฟื้นตัว
การกู้คืนผิดพลาด
เพิ่มข้อมูล 11- วิดีโอคาหนังคาทอลิก IDไม่เต็ม YouTube URL. ใช้ได้ ID ไม่รับประกันว่าวิดีโอจะเข้าถึงได้: วิดีโอที่เอาออก, ส่วนตัว หรือถูกจํากัดไว้อาจจะล้มเหลวในระหว่างการประมวลผล จํานวนที่ขาดอาจจะ nullการขาดบทหรือรูปแบบไม่ได้ล้มเหลว
สําหรับการตรวจสอบสิทธิ์, ดุลยภาพ, ร้องขอ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 การใช้) รวม |
หนึ่งแผนต่อบัญชี ใช้เครดิตร่วมกันทั้งสามผลิตภัณฑ์ การใช้งานที่ครอบคลุมด้วยเครดิตในแผนจะไม่ถูกคิดค่าบริการซ้ำ
ราคาและแผนจํากัดในปัจจุบัน