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

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