REST Resource: claims

แหล่งข้อมูล: การอ้างสิทธิ์

claim ลิงก์วิดีโอที่พาร์ทเนอร์หรือผู้ใช้อัปโหลดกับเนื้อหาที่ตรงกับวิดีโอ การอ้างสิทธิ์จะระบุว่าวิดีโอตรงกับองค์ประกอบเสียง วิดีโอ หรือภาพและเสียง (เสียงและวิดีโอ) ของเนื้อหา การอ้างสิทธิ์ยังระบุนโยบายที่เจ้าของสิทธิ์ต้องการให้ YouTube นำไปใช้กับวิดีโอที่อ้างสิทธิ์

การแสดง JSON 
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
ช่อง
kind

string

ประเภทของทรัพยากร API สำหรับทรัพยากร claim ค่านี้คือ youtubePartner#claim
policy

object (Policy)

นโยบายจากเจ้าของการดูในการอ้างสิทธิ์
timeCreated

string

เวลาที่สร้างการอ้างสิทธิ์
contentType

string

ค่านี้จะระบุว่าการอ้างสิทธิ์ครอบคลุมเสียง วิดีโอ หรือภาพและเสียงของเนื้อหาที่อ้างสิทธิ์หรือไม่
ugcType

string

ประเภทการอ้างสิทธิ์ที่ผู้ใช้สร้างขึ้น (มาตรฐาน พรีเมียม เพลง)
isPartnerUploaded

boolean

ระบุว่าการอ้างสิทธิ์นั้นเป็นการอ้างสิทธิ์ที่พาร์ทเนอร์อัปโหลดหรือไม่
timeStatusLastModified

string

เวลาที่สถานะการอ้างสิทธิ์และ/หรือรายละเอียดสถานะได้รับการแก้ไขครั้งล่าสุด
blockOutsideOwnership

boolean

ระบุว่าควรบล็อกวิดีโอที่อ้างสิทธิ์ในที่ใดก็ตามที่ไม่ได้มีเจ้าของอย่างชัดเจนหรือไม่
status

string

สถานะของการอ้างสิทธิ์ เมื่ออัปเดตการอ้างสิทธิ์ คุณจะอัปเดตสถานะการอ้างสิทธิ์จาก active เป็น inactive เพื่อถอนการอ้างสิทธิ์ได้อย่างมีประสิทธิภาพ แต่ API ไม่รองรับการอัปเดตอื่นๆ สำหรับสถานะของการอ้างสิทธิ์
appliedPolicy

object (Policy)

นโยบายที่บังคับใช้สำหรับเจ้าของการดูในการอ้างสิทธิ์ ซึ่งอาจไม่ตรงกับนโยบายการอ้างสิทธิ์สุดท้ายในวิดีโอเนื่องจากไม่ได้พิจารณาถึงพาร์ทเนอร์รายอื่นๆ ของการอ้างสิทธิ์เดียวกัน
id

string

รหัสที่ YouTube กำหนดและใช้เพื่อระบุการอ้างสิทธิ์โดยไม่ซ้ำกัน
assetId

string

รหัสเนื้อหา YouTube ที่ไม่ซ้ำกันซึ่งระบุเนื้อหาที่เชื่อมโยงกับการอ้างสิทธิ์
videoId

string

รหัสวิดีโอ YouTube ที่ไม่ซ้ำกันซึ่งระบุวิดีโอที่เกี่ยวข้องกับการอ้างสิทธิ์
origin

object (Origin)
matchInfo

object (MatchInfo)

หากการอ้างสิทธิ์นี้สร้างขึ้นโดยอัตโนมัติจากข้อมูลอ้างอิงที่ให้ไว้ ส่วนนี้จะมีรายละเอียดของการจับคู่ที่ตรงกันที่ทำให้เกิดการอ้างสิทธิ์
studioInfo

object (StudioInfo)

มี URL ที่ลิงก์กลับไปยังหน้าที่เกี่ยวข้องกับการอ้างสิทธิ์ใน Studio

Origin

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

การแสดง JSON 
{
  "source": string
}
ช่อง
source

string

MatchInfo

ข้อมูลการจับคู่เกี่ยวกับการอ้างสิทธิ์

การแสดง JSON 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
ช่อง
matchSegments[]

object (MatchSegment)

รายละเอียดเกี่ยวกับกลุ่มการจับคู่แต่ละกลุ่ม แต่ละรายการในลิสต์มีข้อมูลเกี่ยวกับกลุ่มการจับคู่ 1 กลุ่มที่เชื่อมโยงกับการอ้างสิทธิ์ สามารถมีกลุ่มที่ตรงกันได้หลายกลุ่ม ตัวอย่างเช่น หากเนื้อหาเสียงและวิดีโอของวิดีโอที่อัปโหลดตรงกับเนื้อหาของวิดีโออ้างอิง จะมีส่วนที่ตรงกัน 2 ส่วน ส่วนหนึ่งจะอธิบายการจับคู่เสียงและอีกส่วนหนึ่งจะอธิบายการจับคู่วิดีโอ
referenceId

string

รหัสข้อมูลอ้างอิงที่สร้างการจับคู่นี้
longestMatch

object (LongestMatch)

รายละเอียดของการจับคู่ที่ตรงกันที่ยาวที่สุดระหว่างข้อมูลอ้างอิงและวิดีโอของผู้ใช้
totalMatch

object (TotalMatch)

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

MatchSegment

ข้อมูลเกี่ยวกับกลุ่มที่ตรงกันกลุ่มเดียวในการอ้างสิทธิ์

การแสดง JSON 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
ช่อง
video_segment

object (Segment)

ออบเจ็กต์ videoSegment มีข้อมูลเกี่ยวกับส่วนที่ตรงกันของวิดีโอที่อ้างสิทธิ์
reference_segment

object (Segment)

ออบเจ็กต์ referenceSegment มีข้อมูลเกี่ยวกับส่วนที่ตรงกันของเนื้อหาอ้างอิง
channel

string

ระบุลักษณะที่วิดีโอที่อ้างสิทธิ์ตรงกับวิดีโออ้างอิง
manual_segment

object (Segment2)

เมื่อดำเนินการแทรกการอ้างสิทธิ์ด้วยตนเอง ออบเจ็กต์ manualSegment จะมีข้อมูลเกี่ยวกับส่วนที่เฉพาะเจาะจงของวิดีโอที่มีการอ้างว่าตรงกัน

กลุ่ม

ทรัพยากรนี้แสดงกลุ่มแบบง่ายที่มีเวลาเริ่มต้นและเวลาสิ้นสุดในรูปแบบ "hh:mm:ss.mmm" สตริง

การแสดง JSON 
{
  "start": string,
  "duration": string,
  "kind": string
}
ช่อง
start

string

เวลาเริ่มต้นของกลุ่มซึ่งวัดเป็นมิลลิวินาทีจากจุดเริ่มต้น
duration

string

ระยะเวลาของกลุ่มเป็นมิลลิวินาที
kind

string

ประเภทของทรัพยากร API สำหรับทรัพยากรของกลุ่ม ค่าคือ youtubePartner#segment

Segment2

ทรัพยากรนี้แสดงกลุ่มง่ายๆ อีกกลุ่มหนึ่งที่มีเวลาเริ่มต้นและเวลาสิ้นสุดในรูปแบบ "hh:mm:ss.mmm" สตริง

การแสดง JSON 
{
  "start": string,
  "kind": string,
  "finish": string
}
ช่อง
start

string

เวลาเริ่มต้นของกลุ่มซึ่งวัดเป็นมิลลิวินาทีจากจุดเริ่มต้น
kind

string

ประเภทของทรัพยากร API สำหรับทรัพยากรของกลุ่ม ค่าคือ youtubePartner#segment
finish

string

เวลาสิ้นสุดของกลุ่มซึ่งวัดเป็นมิลลิวินาทีจากจุดเริ่มต้น

LongestMatch

การจับคู่การอ้างสิทธิ์ที่ยาวนานที่สุด

การแสดง JSON 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
ช่อง
durationSecs

string

ระยะเวลาของการจับคู่ที่ตรงกันที่ยาวที่สุดระหว่างข้อมูลอ้างอิงและวิดีโอของผู้ใช้
userVideoOffset

string

การชดเชยเวลาเป็นวินาทีในวิดีโอของผู้ใช้ที่การจับคู่ยาวนานที่สุดเริ่มต้นขึ้น
referenceOffset

string

ออฟเซ็ตเป็นวินาทีในข้อมูลอ้างอิงที่เริ่มการจับคู่นานที่สุด

TotalMatch

การจับคู่การอ้างสิทธิ์ทั้งหมดตรงกัน

การแสดง JSON 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
ช่อง
userVideoDurationSecs

string

จำนวนเนื้อหาทั้งหมดในวิดีโอของผู้ใช้ซึ่งตรงกับข้อมูลอ้างอิงในหน่วยวินาที
referenceDurationSecs

string

จำนวนเนื้อหาทั้งหมดในข้อมูลอ้างอิงซึ่งตรงกับวิดีโอของผู้ใช้ในหน่วยวินาที

เมธอด

get

 ดึงการอ้างสิทธิ์ที่เฉพาะเจาะจงตามรหัส

insert

 สร้างการอ้างสิทธิ์

list

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

patch

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

update

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