REST Resource: references

แหล่งข้อมูล: ข้อมูลอ้างอิง

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

การแสดง JSON
{
  "kind": string,
  "status": string,
  "statusReason": string,
  "length": number,
  "hashCode": string,
  "urgent": boolean,
  "fpDirect": boolean,
  "contentType": string,
  "audioswapEnabled": boolean,
  "ignoreFpMatch": boolean,
  "origination": {
    object (Origination)
  },
  "excludedIntervals": [
    {
      object (ExcludedInterval)
    }
  ],
  "id": string,
  "assetId": string,
  "duplicateLeader": string,
  "claimId": string,
  "videoId": string
}
ช่อง
kind

string

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

status

string

สถานะของข้อมูลอ้างอิง

statusReason

string

คำอธิบายว่าการอ้างอิงเข้าสู่สถานะปัจจุบันได้อย่างไร ค่านี้จะปรากฏเมื่อสถานะของข้อมูลอ้างอิงเป็น inactive หรือ deleted เท่านั้น

length

number

ความยาวของวิดีโอเป็นวินาที

hashCode

string

แฮชโค้ด MD5 ของเนื้อหาอ้างอิง เลิกใช้งานแล้ว! ข้อมูลนี้ไม่แสดงอีกต่อไป

urgent

boolean

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

โปรดทราบว่าการทำเครื่องหมายไฟล์ทั้งหมดเป็นแบบเร่งด่วนอาจทำให้การประมวลผลไฟล์เหล่านั้นล่าช้า

fpDirect

boolean

เมื่ออัปโหลดข้อมูลอ้างอิง ให้ตั้งค่านี้เป็น true เพื่อระบุว่าข้อมูลอ้างอิงเป็นลายนิ้วมือที่สร้างไว้ล่วงหน้า

contentType

string

ประเภทของเนื้อหาที่มีการอ้างอิง

audioswapEnabled

boolean

ตั้งค่าของช่องนี้เป็น true เพื่อระบุว่าเนื้อหาอ้างอิงควรรวมอยู่ในโปรแกรมสลับแทร็กเสียงของ YouTube

ignoreFpMatch

boolean

ตั้งค่านี้เป็น true เพื่อระบุว่าไม่ควรใช้ข้อมูลอ้างอิงในการสร้างการอ้างสิทธิ์ ฟิลด์นี้ใช้กับการอ้างอิงการสลับแทร็กเสียงเท่านั้น

origination

object (Origination)

ออบเจ็กต์ origination มีข้อมูลที่อธิบายแหล่งอ้างอิง

excludedIntervals[]

object (ExcludedInterval)

รายการช่วงเวลาจากข้อมูลอ้างอิงนี้ที่จะถูกละเว้นในระหว่างขั้นตอนการจับคู่

id

string

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

assetId

string

รหัสที่ระบุเนื้อหาที่เชื่อมโยงกับข้อมูลอ้างอิงโดยไม่ซ้ำกัน

duplicateLeader

string

รหัสที่ระบุข้อมูลอ้างอิงที่ไม่ซ้ำกันซึ่งข้อมูลอ้างอิงนี้ซ้ำกัน ช่องนี้จะปรากฏเมื่อสถานะของข้อมูลอ้างอิงเป็น inactive ด้วยเหตุผลREASON_DUPLICATE_FOR_OWNERSเท่านั้น

claimId

string

ฟิลด์นี้จะแสดงหากข้อมูลอ้างอิงสร้างขึ้นโดยการเชื่อมโยงเนื้อหากับวิดีโอ YouTube ที่มีอยู่ ซึ่งอัปโหลดไปยังช่อง YouTube ที่ลิงก์กับบัญชี CMS ของคุณ ในกรณีดังกล่าว ช่องนี้จะมีรหัสของการอ้างสิทธิ์ที่แสดงถึงการเชื่อมโยงที่เกิดขึ้นระหว่างเนื้อหาและวิดีโอ

videoId

string

ฟิลด์นี้จะแสดงหากข้อมูลอ้างอิงสร้างขึ้นโดยการเชื่อมโยงเนื้อหากับวิดีโอ YouTube ที่มีอยู่ ซึ่งอัปโหลดไปยังช่อง YouTube ที่ลิงก์กับบัญชี CMS ของคุณ ในกรณีนี้ ช่องนี้จะมีรหัสของวิดีโอต้นฉบับ

ExcludedInterval

กำหนดกรอบเวลาภายในข้อมูลอ้างอิงที่จะถูกเพิกเฉยในกระบวนการจับคู่

การแสดง JSON
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
ช่อง
low

number

เวลาเริ่มต้น (รวม) ในหน่วยวินาทีของกรอบเวลา ค่านี้อาจเป็นค่าใดก็ได้ระหว่าง 0 ถึง high ทุกช่วงเวลาต้องระบุค่าสำหรับช่องนี้

high

number

เวลาสิ้นสุด (รวม) ในหน่วยวินาทีของกรอบเวลา ค่าอาจเป็นค่าใดก็ได้ที่มากกว่า low หาก high มากกว่าความยาวของข้อมูลอ้างอิง ระบบจะยกเว้นช่วงเวลาระหว่าง low ถึงจุดสิ้นสุดของข้อมูลอ้างอิง ทุกช่วงเวลาต้องระบุค่าสำหรับช่องนี้

origin

string

แหล่งที่มาของคำขอยกเว้นช่วงเวลาจากการจับคู่ Content ID

timeCreated

string

วันที่และเวลาที่สร้างการยกเว้น ค่านี้ระบุในรูปแบบ RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z)

เมธอด

get

เรียกดูข้อมูลเกี่ยวกับข้อมูลอ้างอิงที่ระบุ

insert

สร้างข้อมูลอ้างอิงด้วยวิธีใดวิธีหนึ่งต่อไปนี้
  • หากคำขอของคุณอัปโหลดไฟล์อ้างอิง YouTube จะสร้างข้อมูลอ้างอิงจากเนื้อหาที่ให้ไว้

list

ดึงรายการข้อมูลอ้างอิงตามรหัสหรือรายการข้อมูลอ้างอิงสำหรับเนื้อหาที่ระบุ

patch

แพตช์ข้อมูลอ้างอิง

update

อัปเดตข้อมูลอ้างอิง