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)

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

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

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