LiveStreams: insert

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

Use Case ทั่วไป

ส่งคำขอ

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

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

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

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

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

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

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

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

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

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงทรัพยากร LiveStream ในเนื้อหาการตอบสนอง

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ 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