LiveStreams: insert

สร้างสตรีมวิดีโอ สตรีมช่วยให้คุณส่งวิดีโอไปยัง YouTube ได้ ซึ่งจึงสามารถเผยแพร่วิดีโอไปยังผู้ชมได้

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

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/liveStreams

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

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

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

พารามิเตอร์

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

พารามิเตอร์
พารามิเตอร์ที่จําเป็น
part string
พารามิเตอร์ part มีจุดประสงค์ 2 ประการในการดําเนินการนี้ ตัวระบุนี้จะระบุพร็อพเพอร์ตี้ที่การตั้งค่าการเขียนเขียน รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับ API จะรวมไว้

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

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

พารามิเตอร์ onBehalfOfContentOwnerChannel ระบุรหัสช่อง YouTube ของช่องที่กําลังเพิ่มวิดีโอ ต้องใช้พารามิเตอร์นี้เมื่อคําขอระบุค่าของพารามิเตอร์ onBehalfOfContentOwner และจะใช้ร่วมกับพารามิเตอร์นั้นได้เท่านั้น นอกจากนี้ คําขอต้องได้รับอนุญาตโดยใช้บัญชี CMS ที่ลิงก์กับเจ้าของเนื้อหาซึ่งพารามิเตอร์ onBehalfOfContentOwner ระบุ สุดท้าย แชแนลที่ค่าพารามิเตอร์ onBehalfOfContentOwnerChannel ระบุไว้จะต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุไว้

พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหา YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จํานวนมาก ช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์ได้ 1 ครั้งและดําเนินการในนามของช่องที่ระบุไว้ในค่าพารามิเตอร์ โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบของแต่ละช่อง

เนื้อหาของคำขอ

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

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

    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • คุณตั้งค่าพร็อพเพอร์ตี้เหล่านี้ได้

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

คำตอบ

หากใช้วิธีนี้ วิธีนี้จะแสดงทรัพยากรสตรีมแบบสดในส่วนเนื้อหาของการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
insufficientPermissions insufficientLivePermissions ไม่ได้รับอนุญาตให้สร้างสตรีมแบบสดที่ระบุ
insufficientPermissions livePermissionBlocked ผู้ใช้ที่ให้สิทธิ์คําขอไม่สามารถสตรีมวิดีโอสดบน YouTube ได้ในขณะนี้ ดูรายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้ในการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/features
insufficientPermissions liveStreamingNotEnabled ผู้ใช้ที่ให้สิทธิ์คําขอไม่ได้เปิดใช้สตรีมวิดีโอสดบน YouTube ผู้ใช้จะดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features
invalidValue (400) invalidDescription ค่าของพร็อพเพอร์ตี้ snippet.description ในทรัพยากร liveStream มีอักขระได้สูงสุด 10,000 ตัว
invalidValue (400) invalidFormat ค่าพร็อพเพอร์ตี้ cdn.format ในทรัพยากร liveStream ไม่ถูกต้อง
invalidValue (400) invalidFrameRate ค่าของพร็อพเพอร์ตี้ cdn.frameRate ในทรัพยากร liveStream ไม่ถูกต้อง
invalidValue (400) invalidIngestionType ค่าของพร็อพเพอร์ตี้ cdn.ingestionType ในทรัพยากร liveStream ไม่ถูกต้อง
invalidValue (400) invalidResolution ค่าของพร็อพเพอร์ตี้ cdn.resolution ในทรัพยากร liveStream ไม่ถูกต้อง
invalidValue (400) invalidTitle ค่าของพร็อพเพอร์ตี้ snippet.title ในทรัพยากร liveStream ต้องมีความยาวระหว่าง 1 ถึง 128 อักขระ
rateLimitExceeded userRequestsExceedRateLimit ผู้ใช้ส่งคําขอมากเกินไปในกรอบเวลาที่กําหนด
required (400) cdnRequired ทรัพยากร liveStream ต้องมีออบเจ็กต์ cdn
required (400) frameRateRequired API จะแสดงผลข้อผิดพลาดนี้หากคุณระบุค่าสําหรับพร็อพเพอร์ตี้ cdn.resolution แต่ไม่ระบุสําหรับพร็อพเพอร์ตี้ cdn.frameRate
required (400) ingestionTypeRequired ทรัพยากร liveStream ต้องระบุค่าสําหรับพร็อพเพอร์ตี้ cdn.ingestionType>
required (400) resolutionRequired API จะแสดงผลข้อผิดพลาดนี้หากคุณระบุค่าสําหรับพร็อพเพอร์ตี้ cdn.frameRate แต่ไม่ระบุสําหรับพร็อพเพอร์ตี้ cdn.resolution
required (400) titleRequired ทรัพยากร liveStream ต้องระบุค่าสําหรับพร็อพเพอร์ตี้ snippet.title

ลองใช้เลย

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