Method: references.insert

สร้างข้อมูลอ้างอิงด้วยวิธีใดวิธีหนึ่งต่อไปนี้

  • หากคำขอของคุณเป็นการอัปโหลดไฟล์อ้างอิง YouTube จะสร้างข้อมูลอ้างอิงจากเนื้อหาที่ให้ไว้ คุณสามารถระบุไฟล์วิดีโอ/เสียงหรือลายนิ้วมือที่สร้างไว้ล่วงหน้าก็ได้ หากระบุลายนิ้วมือที่สร้างไว้ล่วงหน้า ให้ตั้งค่าพร็อพเพอร์ตี้ fpDirect ของทรัพยากร reference เป็น true ในเนื้อความของคำขอ ในโฟลว์นี้ คุณสามารถใช้โฟลว์การอัปโหลดแบบ หลายส่วน หรือ ต่อได้ เพื่อระบุเนื้อหาอ้างอิง
  • หากต้องการสร้างข้อมูลอ้างอิงโดยใช้วิดีโอที่มีการอ้างสิทธิ์เป็นเนื้อหาอ้างอิง ให้ใช้พารามิเตอร์ claimId เพื่อระบุการอ้างสิทธิ์

คำขอ HTTP

  • URI การอัปโหลดสำหรับคำขออัปโหลดสื่อ
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI ข้อมูลเมตาสำหรับคำขอข้อมูลเมตาเท่านั้น
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

URL ใช้ ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
claimId

string

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

string

พารามิเตอร์ onBehalfOfContentOwner จะระบุเจ้าของเนื้อหาที่ผู้ใช้ดำเนินการแทน พารามิเตอร์นี้รองรับผู้ใช้ที่มีบัญชีเชื่อมโยงกับเจ้าของเนื้อหาหลายราย

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

เนื้อความของคำขอมีอินสแตนซ์ของ Reference

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Reference

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/youtubepartner

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview