ดำเนินการในนามของเจ้าของเนื้อหา

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

เรียกดูรหัสของเจ้าของเนื้อหา

หากต้องการเรียกข้อมูลรหัสของเจ้าของเนื้อหา ให้เรียกใช้เมธอด contentOwners.list ของ API สำหรับ Content ID ของ YouTube การตอบกลับของ API ประกอบด้วยรายการทรัพยากร contentOwner รายการที่เชื่อมโยงกับผู้ใช้ที่ให้สิทธิ์คำขอ ในทรัพยากรแต่ละรายการ พร็อพเพอร์ตี้ id จะระบุรหัสของเจ้าของเนื้อหา

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

เรียกใช้ API ของ YouTube ในนามของเจ้าของเนื้อหา

API ของ Content ID บน YouTube

เนื่องจากผู้ใช้ส่วนใหญ่มีสิทธิ์เข้าถึงบัญชีเจ้าของเนื้อหาเพียงบัญชีเดียว API ของ Content ID จึงระบุเจ้าของเนื้อหาที่ผู้ใช้ดำเนินการได้โดยปริยาย ด้วยเหตุนี้ พารามิเตอร์ onBehalfOfContentOwner จึงเป็นตัวเลือกที่ไม่บังคับสำหรับการเรียก Content ID API

อย่างไรก็ตาม ผู้ใช้บางคนอาจมีสิทธิ์เข้าถึงบัญชีเจ้าของเนื้อหาหลายบัญชี สำหรับผู้ใช้เหล่านี้ คำขอ API แต่ละรายการต้องมีพารามิเตอร์ onBehalfOfContentOwner เพื่อระบุบัญชีเจ้าของเนื้อหาที่จะใช้อย่างชัดเจน

YouTube Data API (v3)

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

เมื่อใช้การมอบสิทธิ์ใน YouTube Data API คุณต้องระบุพารามิเตอร์ onBehalfOfContentOwner เสมอ ค่าของพารามิเตอร์คือรหัสที่ระบุเจ้าของเนื้อหาโดยไม่ซ้ำกัน คุณเรียกข้อมูลรหัสโดยใช้โปรแกรมได้ด้วยการเรียกใช้เมธอด contentOwners.list ของ API สำหรับ Content ID ของ YouTube

การเรียก API บางรายการต้องมีพารามิเตอร์การมอบสิทธิ์เพิ่มเติม รายการด้านล่างจะอธิบายถึงตัวอย่าง 2 ตัวอย่าง

• เมธอด videos.insert() กำหนดให้ต้องตั้งค่าพารามิเตอร์ onBehalfOfContentOwner และ onBehalfOfContentOwnerChannel เมื่อผู้ใช้กำลังดำเนินการในช่องในฐานะเจ้าของเนื้อหา ระบบจะอัปโหลดวิดีโอใหม่ไปยังช่องที่ระบุโดยค่าพารามิเตอร์ onBehalfOfContentOwnerChannel
• เมธอด search.list() จำเป็นต้องมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner และ forContentOwner ในกรณีนี้ พารามิเตอร์ forContentOwner ช่วยให้ผู้ใช้สั่งให้ API แสดงผลเฉพาะทรัพยากรที่เป็นของเจ้าของเนื้อหาซึ่งพารามิเตอร์ onBehalfOfContentOwner ระบุไว้เท่านั้น

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

API ของ YouTube Analytics

หากต้องการเรียกดูรายงานเจ้าของเนื้อหาโดยใช้ API ของ YouTube Analytics คุณจะต้องตั้งค่าพารามิเตอร์ ids ในคำขอ API เป็น contentOwner==OWNER_ID โดยที่ OWNER_ID จะระบุรหัสของเจ้าของเนื้อหา