Method: references.insert

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

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