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 指派的 ID，可用於識別資產。
aliasId[]

string

可用來參照資產的資產 ID 清單。如果資產代表多個合併的資產，清單中會包含值。在這種情況下，組成元素資產原本獲派的任何資產 ID，都可用來更新主要資產或合併的資產。
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

相衝突的資產擁有者 ID。

AssetLicensability

資產授權資格資訊。

JSON 表示法 
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
欄位
licensable

boolean

已核對的資產是否可申請授權。
licensabilityState

string

資產的授權狀態。
unlicensableReason[]

string

資產無法授權的原因。

NWayRevenueSharing

資訊資產的 N 向收益分成。

JSON 表示法 
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
欄位
status

string

反向收益分潤狀態。
eligibleTerritories[]

string

每個國家/地區都會以兩個字母的 ISO 國家/地區代碼 (ISO 3166-1 alpha-2) 表示。
ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

資產不符合雙向收益分潤資格的地域資訊。

TerritoriesIneligibleForNWayRevenueSharing

資產無法獲得媒體收益分潤資格的地域相關資訊。

JSON 表示法 
{
  "reason": string,
  "territories": [
    string
  ]
}
欄位
reason

string

下列地域不符合資格的原因。
territories[]

string

每個國家/地區都會以兩個字母的 ISO 國家/地區代碼 (ISO 3166-1 alpha-2) 表示。

方法

get

 擷取指定資產的中繼資料。

insert

 插入含有指定中繼資料的資產。

list

 根據資產中繼資料擷取資產清單。

patch

 修補指定資產的中繼資料。

update

 更新指定資產的中繼資料。