- แหล่งข้อมูล: การอ้างสิทธิ์
- ต้นทาง
- MatchInfo
- MatchSegment
- กลุ่ม
- Segment2
- LongestMatch
- TotalMatch
- เมธอด
ทรัพยากร: การอ้างสิทธิ์
claim
จะลิงก์วิดีโอที่พาร์ทเนอร์หรือผู้ใช้อัปโหลดกับเนื้อหาที่ตรงกับวิดีโอ การอ้างสิทธิ์จะระบุว่าวิดีโอตรงกับองค์ประกอบเสียง ภาพ หรือภาพและเสียง (เสียงและวิดีโอ) ของเนื้อหา การอ้างสิทธิ์ยังระบุนโยบายที่เจ้าของสิทธิ์ต้องการให้ YouTube นำไปใช้กับวิดีโอที่อ้างสิทธิ์ด้วย
การแสดง JSON |
---|
{ "kind": string, "policy": { object ( |
ช่อง | |
---|---|
kind |
ประเภทของทรัพยากร API สำหรับ��รัพยากร |
policy |
นโยบายที่ระบุโดยเจ้าของที่กำลังดูการอ้างสิทธิ์ |
timeCreated |
เวลาที่สร้างการอ้างสิทธิ์ |
contentType |
ค่านี้จะระบุว่าการอ้างสิทธิ์ครอบคลุมเสียง วิดีโอ หรือภาพและเสียงของเนื้อหาที่มีการอ้างสิทธิ์หรือไม่ |
ugcType |
ประเภทเนื้อหาที่ผู้ใช้สร้างขึ้นของการอ้างสิทธิ์ (มาตรฐาน พรีเมียม เพลง) |
isPartnerUploaded |
ระบุว่าการอ้างสิทธิ์เป็นการอ้างสิทธิ์ที่พาร์ทเนอร์อัปโหลดหรือไม่ |
timeStatusLastModified |
เวลาที่แก้ไขสถานะการอ้างสิทธิ์และ/หรือรายละเอียดสถานะครั้งล่าสุด |
blockOutsideOwnership |
ระบุว่าควรบล็อกวิดีโอที่อ้างสิทธิ์ในตำแหน่งที่ไม่ได้เป็นเจ้าของอย่างชัดแจ้งหรือไม่ |
status |
สถานะของการอ้างสิทธิ์ เมื่ออัปเดตการอ้างสิทธิ์ คุณสามารถอัปเดตสถานะการอ้างสิทธิ์จาก |
appliedPolicy |
นโยบายที่บังคับใช้สำหรับเจ้าของผู้ดูในการอ้างสิทธิ์ กรณีนี้อาจไม่ใช่นโยบายการอ้างสิทธิ์ขั้นสุดท้ายของวิดีโอ เนื่องจากจะไม่พิจารณานโยบายของพาร์ทเนอร์รายอื่นๆ ในการอ้างสิทธิ์เดียวกัน |
id |
รหัสที่ YouTube กำหนดและใช้เพื่อระบุการอ้างสิทธิ์แบบไม่ซ้ำ |
assetId |
รหัสเนื้อหา YouTube ที่ไม่ซ้ำกันซึ่งระบุเนื้อหาที่เกี่ยวข้องกับการอ้างสิทธิ์ |
videoId |
รหัสวิดีโอ YouTube ที่ไม่ซ้ำกันซึ่งระบุวิดีโอที่เกี่ยวข้องกับการอ้างสิทธิ์ |
origin |
|
matchInfo |
หากการอ้างสิทธิ์นี้สร้างขึ้นโดยอัตโนมัติจากข้อมูลอ้างอิงที่ให้ไว้ ส่วนนี้จะระบุรายละเอียดการจับคู่ที่ทำให้เกิดการอ้างสิทธิ์ |
studioInfo |
มี URL ที่ลิงก์กลับไปยังหน้าที่เกี่ยวข้องกับการอ้างสิทธิ์ใน Studio |
Origin
ออบเจ็กต์นี้มีข้อมูลที่อธิบายแหล่งที่มาของข้อมูลเมตาหรือข้อมูลการเป็นเจ้าของ
การแสดง JSON |
---|
{ "source": string } |
ช่อง | |
---|---|
source |
|
MatchInfo
จับคู่ข้อมูลเกี่ยวกับการอ้างสิทธิ์
การแสดง JSON |
---|
{ "matchSegments": [ { object ( |
ช่อง | |
---|---|
matchSegments[] |
รายละเอียดเกี่ยวกับกลุ่มการจับคู่แต่ละกลุ่ม แต่ละรายการในลิสต์ประกอบด้วยข้อมูลเกี่ยวกับส่วนการจับคู่ 1 ส่วนที่เชื่อมโยงกับการอ้างสิทธิ์ อาจมีกลุ่มเป้าหมายหลายกลุ่มที่ตรงกัน ตัวอย่างเช่น หากเนื้อหาเสียงและวิดีโอของวิดีโอที่อัปโหลดตรงกับวิดีโออ้างอิง จะมีส่วนที่ตรงกัน 2 ส่วน โดยกลุ่มหนึ่งจะอธิบายการจับคู่เสียง ส่วนอีกกลุ่มหนึ่งจะอธิบายการจับคู่วิดีโอ |
referenceId |
รหัสข้อมูลอ้างอิงที่สร้างการจับคู่นี้ |
longestMatch |
รายละเอียดของการจับคู่ที่ยาวที่สุดระหว่างข้อมูลอ้างอิงและวิดีโอของผู้ใช้ |
totalMatch |
รายละเอียดของปริมาณข้อมูลอ้างอิงทั้งหมดและเนื้อหาวิดีโอของผู้ใช้ที่ตรงกัน โปรดทราบว่าค่า 2 ค่านี้อาจต่างกันหากข้อมูลอ้างอิงหรือวิดีโอของผู้ใช้มีการวนซ้ำ |
MatchSegment
ข้อมูลเกี่ยวกับส่วนการจับคู่กลุ่มเดียวในการอ้างสิทธิ์
การแสดง JSON |
---|
{ "video_segment": { object ( |
ช่อง | |
---|---|
video_segment |
ออบเจ็กต์ |
reference_segment |
ออบเจ็กต์ |
channel |
ระบุลักษณะที่วิดีโอที่อ้างสิทธิ์ตรงกับวิดีโออ้างอิง |
manual_segment |
ขณะดำเนินการ���ทรกการอ้างสิทธิ์ด้วยตนเอง ออบเจ็กต์ |
แบ่งส่วน
ทรัพยากรนี้แสดงกลุ่มแบบง่ายที่มีเวลาเริ่มต้นและเวลาสิ้นสุดอยู่ในรูปแบบสตริง "hh:mm:ss.mmm"
การแสดง JSON |
---|
{ "start": string, "duration": string, "kind": string } |
ช่อง | |
---|---|
start |
เวลาเริ่มต้นของกลุ่ม วัดเป็นมิลลิวินาทีจากจุดเริ่มต้น |
duration |
ระยะเวลาของกลุ่มในหน่วยมิลลิวินาที |
kind |
ประเภทของทรัพยากร API สำหรับทรัพยากรของกลุ่ม ค่าจะเป็น |
Segment2
ทรัพยากรนี้แสดงกลุ่มแบบง่ายอีกกลุ่มหนึ่งที่มีเวลาเริ่มต้นและเวลาสิ้นสุดอยู่ในรูปแบบสตริง "hh:mm:ss.mmm"
การแสดง JSON |
---|
{ "start": string, "kind": string, "finish": string } |
ช่อง | |
---|---|
start |
เวลาเริ่มต้นของกลุ่ม วัดเป็นมิลลิวินาทีจากจุดเริ่มต้น |
kind |
ประเภทของทรัพยากร API สำหรับทรัพยากรของกลุ่ม ค่าจะเป็น |
finish |
เวลาสิ้นสุดของกลุ่ม วัดเป็นมิลลิวินาทีตั้งแต่ต้น |
LongestMatch
การจับคู่การอ้างสิทธิ์ที่ยาวที่สุด
การแสดง JSON |
---|
{ "durationSecs": string, "userVideoOffset": string, "referenceOffset": string } |
ช่อง | |
---|---|
durationSecs |
ระยะเวลาของการจับคู่ที่ยาวที่สุดระหว่างข้อมูลอ้างอิงกับวิดีโอของผู้ใช้ |
userVideoOffset |
ออฟเซ็ตเป็นวินาทีในวิดีโอผู้ใช้ที่เริ่มการจับคู่นานที่สุด |
referenceOffset |
ออฟเซ็ตเป็นวินาทีในการอ้างอิงที่การจับคู่ที่ยาวที่สุดเริ่มต้น |
TotalMatch
การจับคู่การอ้างสิทธิ์ทั้งหมด
การแสดง JSON |
---|
{ "userVideoDurationSecs": string, "referenceDurationSecs": string } |
ช่อง | |
---|---|
userVideoDurationSecs |
จำนวนเนื้อหาทั้งหมดในวิดีโอของผู้ใช้ที่ตรงกับข้อมูลอ้างอิงเป็นวินาที |
referenceDurationSecs |
จำนวนเนื้อหาในข้อมูลอ้างอิงทั้งหมดที่ตรงกับวิดีโอของผู้ใช้เป็นวินาที |
วิธีการ |
|
---|---|
|
ดึงข้อมูลการอ้างสิทธิ์ที่เจาะจงตามรหัส |
|
สร้างการอ้างสิทธิ์ |
|
เรียกดูรายการการอ้างสิทธิ์ที่จัดการโดยเจ้าของเนื้อหาที่เชื่อมโยงกับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน |
|
แพตช์การอ้างสิทธิ์ที่มีอยู่โดยการเปลี่ยนนโยบายหรือสถานะของการอ้างสิทธิ์ |
|
อัปเดตการอ้างสิทธิ์ที่มีอยู่โดยการเปลี่ยนแปลงนโยบายหรือสถานะของการอ้างสิทธิ์ |