Captions: update

อัปเดตแทร็กคำบรรยายแทนเสียง เมื่ออัปเดตแทร็กคำบรรยายแทนเสียง คุณสามารถเปลี่ยนสถานะฉบับร่างของแทร็ก อัปโหลดไฟล์คำบรรยายแทนเสียงใหม่สำหรับแทร็ก หรือทั้ง 2 อย่าง

เมธอดนี้รองรับการอัปโหลดสื่อ ไฟล์ที่อัปโหลดต้องเป็นไปตามข้อจำกัดต่อไปนี้

  • ขนาดไฟล์สูงสุด: 100 MB
  • ประเภท MIME ของสื่อที่ยอมรับ: text/xml, application/octet-stream, */*

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

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

ส่งคำขอ

คำขอ HTTP

PUT https://www.googleapis.com/upload/youtube/v3/captions

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

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

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

พารามิเตอร์

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

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string
พารามิเตอร์ part มีไว้เพื่อวัตถุประสงค์ 2 อย่างในการดำเนินการนี้ โดยจะระบุพร็อพเพอร์ตี้ที่การดำเนินการเขียนจะตั้งค่า รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับจาก API จะรวมไว้ด้วย ตั้งค่าพร็อพเพอร์ตี้เป็น snippet หากคุณกำลังอัปเดตสถานะฉบับร่างของแทร็ก หรือตั้งค่าพร็อพเพอร์ตี้เป็น id.

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

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

พารามิเตอร์ sync บ่งชี้ว่า YouTube ควรซิงค์ไฟล์คำบรรยายแทนเสียงกับแทร็กเสียงของวิดีโอโดยอัตโนมัติหรือไม่ หากตั้งค่าเป็น true YouTube จะซิงค์แทร็กคำบรรยายแทนเสียงกับแทร็กเสียงโดยอัตโนมัติ

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

ระบุแหล่งข้อมูลคำบรรยายแทนเสียงในเนื้อความของคำขอ โดยแหล่งข้อมูลดังกล่าวต้องมีลักษณะดังนี้

  • คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

    • id

  • คุณสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

    • snippet.isDraft

    หากคุณส่งคำขออัปเดตและคำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ที่มีค่าอยู่แล้ว ระบบจะลบค่าที่มีอยู่ออก

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงผลแหล่งข้อมูลคำบรรยายแทนเสียงในเนื้อความของการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) contentRequired คำขอไม่ได้อัปโหลดไฟล์คำบรรยายแทนเสียงที่อัปเดต ระบบต้องใช้เนื้อหาแทร็กจริงหากตั้งค่าพารามิเตอร์ sync เป็น true
forbidden (403) forbidden สิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะอัปเดตแทร็กคำบรรยายแทนเสียง คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง
notFound (404) captionNotFound ไม่พบแทร็กคำบรรยายแทนเสียงที่ระบุ ตรวจสอบค่าของพร็อพเพอร์ตี้ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

ลองใช้งาน

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