REST Resource: assets

แหล่งข้อมูล: เนื้อหา

แหล่งข้อมูล asset หมายถึงทรัพย์สินทางปัญญา เช่น ไฟล์บันทึกเสียงหรือตอนของรายการทีวี

การแสดง JSON 
{
  "kind": string,
  "type": string,
  "status": string,
  "metadata": {
    object (Metadata)
  },
  "ownership": {
    object (RightsOwnership)
  },
  "matchPolicy": {
    object (AssetMatchPolicy)
  },
  "timeCreated": string,
  "metadataMine": {
    object (Metadata)
  },
  "metadataEffective": {
    object (Metadata)
  },
  "ownershipMine": {
    object (RightsOwnership)
  },
  "ownershipEffective": {
    object (RightsOwnership)
  },
  "matchPolicyMine": {
    object (AssetMatchPolicy)
  },
  "matchPolicyEffective": {
    object (AssetMatchPolicy)
  },
  "ownershipConflicts": {
    object (OwnershipConflicts)
  },
  "id": string,
  "aliasId": [
    string
  ],
  "label": [
    string
  ],
  "licensability": {
    object (AssetLicensability)
  },
  "nWayRevenueSharing": {
    object (NWayRevenueSharing)
  }
}
ช่อง
kind

string

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

string

ประเภทเนื้อหา ค่านี้จะระบุช่องข้อมูลเมตาที่คุณจะตั้งค่าสำหรับเนื้อหาได้ นอกจากนี้ ฟังก์ชัน API บางอย่างอาจรองรับเฉพาะชิ้นงานบางประเภทเท่านั้น เช่น เนื้อหาการเรียบเรียงอาจมีข้อมูลการเป็นเจ้าของที่ซับซ้อนกว่าเนื้อหาประเภทอื่นๆ

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web
status

string

สถานะของเนื้อหา
metadata

object (Metadata)

ออบเจ็กต์ metadata มีข้อมูลที่ระบุและอธิบายเนื้อหา ข้อมูลนี้สามารถใช้ในการค้นหาเนื้อหาหรือเพื่อกำจัดความซ้ำซ้อนภายในฐานข้อมูลของ YouTube
ownership

object (RightsOwnership)

ออบเจ็กต์ ownership จะระบุเจ้าของเนื้อหาและให้รายละเอียดเพิ่มเติมเกี่ยวกับการเป็นเจ้าของ เช่น เขตแดนที่เจ้าของเนื้อหาเป็นเจ้าของเนื้อหา
matchPolicy

object (AssetMatchPolicy)

ออบเจ็กต์ matchPolicy มีข้อมูลเกี่ยวกับนโยบายการจับคู่ของเนื้อหา ซึ่ง YouTube จะนำไปใช้กับวิดีโอที่ผู้ใช้อัปโหลดซึ่งตรงกับเนื้อหา
timeCreated

string

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

object (Metadata)
metadataEffective

object (Metadata)
ownershipMine

object (RightsOwnership)
ownershipEffective

object (RightsOwnership)
matchPolicyMine

object (AssetMatchPolicy)
matchPolicyEffective

object (AssetMatchPolicy)
ownershipConflicts

object (OwnershipConflicts)

ออบเจ็กต์ ownershipConflicts มีข้อมูลเกี่ยวกับความขัดแย้งในการเป็นเจ้าของเนื้อหา
id

string

รหัสที่ YouTube กำหนดและใช้เพื่อระบุเนื้อหาแบบไม่ซ้ำ
aliasId[]

string

รายการรหัสเนื้อหาที่สามารถใช้เพื่ออ้างถึงเนื้อหา รายการจะมีค่าต่างๆ หากเนื้อหาแสดงถึงเนื้อหาส่วนประกอบหลายรายการที่ผสานรวมกัน ในกรณีดังกล่าว รหัสเนื้อหาที่กำหนดให้แก่เนื้อหาส่วนประกอบแต่เดิมสามารถใช้เพื่ออัปเดตเนื้อหาหลัก หรือรวมเนื้อหาเข้าด้วยกันได้
label[]

string

รายการป้ายกำกับเนื้อหาในเนื้อหา
licensability

object (AssetLicensability)

ข้อมูลความสามารถในการขอลิขสิทธิ์เนื้อหา
nWayRevenueSharing

object (NWayRevenueSharing)

ข้อมูลส่วนแบ่งรายได้ N ทาง (Pangea)

OwnershipConflicts

ทรัพยากร ownershipConflicts แสดงข้อมูลเกี่ยวกับการเป็นเจ้าของที่ขัดแย้งกันของเนื้อหา

การแสดง JSON 
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
ช่อง
general[]

object (TerritoryConflicts)

รายการที่ระบุความขัดแย้งในการเป็นเจ้าของเนื้อหาและเขตแดนที่มีการแทรกการเป็นเจ้าของที่ขัดแย้งกัน
performance[]

object (TerritoryConflicts)

รายการที่ระบุความขัดแย้งในการเป็นเจ้าของสำหรับสิทธิ์ในการนำเพลงไปใช้ในเนื้อหาการแต่งเพลงและเขตแดนที่มีการแทรกการเป็นเจ้าของที่ขัดแย้งกัน
synchronization[]

object (TerritoryConflicts)

รายการที่ระบุความขัดแย้งในการเป็นเจ้าของของสิทธิ์การซิงค์สำหรับเนื้อหาการแต่งเพลงและเขตแดนที่มีการแทรกการเป็นเจ้าของที่ขัดแย้งกัน
mechanical[]

object (TerritoryConflicts)

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

string

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

TerritoryConflicts

วิธีการค้นหาการก่อการร้ายที่มีความขัดแย้งในการเป็นเจ้าของ

การแสดง JSON 
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
ช่อง
territory

string

เขตแดนที่มีความขัดแย้งในการเป็นเจ้าของ เขตแดนคือรหัสประเทศ ISO 3166 สองตัวอักษร
conflictingOwnership[]

object (ConflictingOwnership)

รายการการเป็นเจ้าของที่ขัดแย้งกัน

ConflictingOwnership

แสดงข้อมูลเกี่ยวกับการเป็นเจ้าของที่ขัดแย้งกัน

การแสดง JSON 
{
  "ratio": number,
  "owner": string
}
ช่อง
ratio

number

เปอร์เซ็นต์ของเนื้อหาที่เจ้าของควบคุมหรือดูแล
owner

string

รหัสเจ้าของเนื้อหาที่มีข้อขัดแย้ง

AssetLicensability

ข้อมูลความสามารถในการขอลิขสิทธิ์เนื้อหา

การแสดง JSON 
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
ช่อง
licensable

boolean

เนื้อหาที่กระทบยอดสามารถขอลิขสิทธิ์ได้หรือไม่
licensabilityState

string

สถานะความสามารถในการขอลิขสิทธิ์ของเนื้อหา
unlicensableReason[]

string

สาเหตุที่ออกใบอนุญาตเนื้อหาไม่ได้

NWayRevenueSharing

ส่วนแบ่งรายได้ n-way ของชิ้นงานข้อมูล

การแสดง JSON 
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
ช่อง
status

string

สถานะของส่วนแบ่งรายได้ n ทางเดียว
eligibleTerritories[]

string

แต่ละประเทศจะแสดงด้วยรหัสประเทศ ISO 2 ตัวอักษร (ISO 3166-1 alpha-2)
ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

ข้อมูลเกี่ยวกับเขตแดนที่เนื้อหาไม่มีสิทธิ์แบ่งรายได้แบบทิศทางเดียว

TerritoriesIneligibleForNWayRevenueSharing

ข้อมูลเกี่ยวกับเขตแดนที่เนื้อหาไม่มีสิทธิ์รับส่วนแบ่งรายได้แบบทิศทางเดียว

การแสดง JSON 
{
  "reason": string,
  "territories": [
    string
  ]
}
ช่อง
reason

string

สาเหตุที่ไม่มีสิทธิ์สำหรับเขตแดนที่ระบุไว้ด้านล่าง
territories[]

string

แต่ละประเทศจะแสดงด้วยรหัสประเทศ ISO 2 ตัวอักษร (ISO 3166-1 alpha-2)

วิธีการ

get

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

insert

 แทรกเนื้อหาที่มีข้อมูลเมตาที่ระบุ

list

 เรียกรายการเนื้อหาตามข้อมูลเมตาของเนื้อหา

patch

 แพตช์ข้อมูลเมตาสำหรับเนื้อหาที่ระบุ

update

 อัปเดตข้อมูลเมตาสำหรับเนื้อหาที่ระบุ