Captions: download

ดาวน์โหลดแทร็กคำบรรยายแทนเสียง ระบบจะแสดงผลแทร็กคำบรรยายแทนเสียงในรูปแบบเดิม เว้นแต่คำขอจะระบุค่าสำหรับพารามิเตอร์ tfmt และในภาษาเดิม เว้นแต่คำขอจะระบุค่าสำหรับพารามิเตอร์ tlang

ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีค่าใช้จ่ายโควต้า 200 หน่วย

เมธอดนี้กำหนดให้ผู้ใช้ต้องมีสิทธิ์แก้ไขวิดีโอ

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/youtube/v3/captions/id

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตอย่างน้อย 1 รายการต่อไปนี้ (ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

พารามิเตอร์

ตารางด้านล่างแสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงเป็นพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
id string
พารามิเตอร์ id จะระบุแทร็กคำบรรยายแทนเสียงที่จะดึงข้อมูล ค่านี้คือรหัสแทร็กคำบรรยายแทนเสียงตามที่ระบุโดยพร็อพเพอร์ตี้ id ในทรัพยากร caption
พารามิเตอร์ที่ไม่บังคับ
onBehalfOfContentOwner string
พารามิเตอร์นี้ใช้ได้เฉพาะในคำขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

พารามิเตอร์ onBehalfOfContentOwner บ่งชี้ว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลรับรองการตรวจสอบสิทธิ์สำหรับแต่ละช่อง บัญชี CMS จริงที่ผู้ใช้ตรวจสอบสิทธิ์ต้องลิงก์กับเจ้าของเนื้อหาของ YouTube ที่ระบุ
tfmt string
พารามิเตอร์ tfmt จะระบุว่าควรแสดงผลแทร็กคำบรรยายแทนเสียงในรูปแบบที่เฉพาะเจาะจง หากไม่ได้ระบุพารามิเตอร์ในคำขอ ระบบจะแสดงผลแทร็กในรูปแบบเดิม

ค่าที่รองรับมีดังนี้
  • sbv \- คำบรรยายแทนเสียง SubViewer
  • scc \- รูปแบบคำบรรยายแทนเสียง Scenarist
  • srt \- คำบรรยายแทนเสียง SubRip
  • ttml \- คำบรรยายแทนเสียง Timed Text Markup Language
  • vtt \- คำบรรยายแทนเสียง Web Video Text Tracks
tlang string
พารามิเตอร์ tlang จะระบุว่าการตอบกลับจาก API ควรแสดงผลคำแปลของแทร็กคำบรรยายแทนเสียงที่ระบุ ค่าพารามิเตอร์คือรหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรที่ระบุภาษาคำบรรยายแทนเสียงที่ต้องการ ระบบจะสร้างคำแปลโดยใช้การแปลด้วยคอมพิวเตอร์ เช่น Google แปลภาษา

เนื้อความของคำขอ

อย่าระบุเนื้อความของคำขอเมื่อเรียกใช้เมธอดนี้

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงผลไฟล์ไบนารี ส่วนหัว Content-Type สำหรับการตอบกลับคือ application/octet-stream

ข้อผิดพลาด

ตารางด้านล่างแสดงข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกใช้เมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
forbidden (403) forbidden สิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะดาวน์โหลดแทร็กคำบรรยายแทนเสียง คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง
invalidValue (400) couldNotConvert ไม่สามารถแปลงข้อมูลแทร็กคำบรรยายแทนเสียงเป็นภาษาและ/หรือรูปแบบที่ขอ ตรวจสอบว่าค่า tfmt และ tlang ที่ขอถูกต้อง และ snippet.status ของแทร็กคำบรรยายแทนเสียงที่ขอไม่ใช่ failed
notFound (404) captionNotFound ไม่พบแทร็กคำบรรยายแทนเสียง ตรวจสอบค่าพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

ลองใช้งาน

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคำขอและการตอบกลับของ API