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)

單向收益分潤 (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

n 方收益分潤狀態。

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

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