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 บ่งชี้ว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ 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