REST Resource: assets

资源：Asset

asset 资源表示一项知识产权，例如录音或电视剧集。

如果某项资产已归其他内容所有者所有，您必须先为该资产添加所有权（使用 ownership.update 或 ownership.patch 方法），然后才能更新其元数据（使用 assets.update 或 assets.patch）或匹配政策（使用 assetMatchPolicy.update 或 assetMatchPolicy.patch）。

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

无法使用 API 创建或修改音乐曲目资源 (art_track_video)。通过 DDEX 或 CSV Feed 提交 Art Track 元数据和媒体文件。
status

string

相应素材资源的状态。

可接受的值包括：

  • active
  • inactive
  • pending
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

素材资源的可获取许可状态。

可接受的值包括：

  • action_required
  • active
  • eligible
  • not_active
  • not_eligible
  • objection
  • partially_active
unlicensableReason[]

string

相应资产无法获得许可的原因。

可接受的值包括：

  • asset_opted_out
  • composition_non_conformant_policy
  • conflicting_composition_ownership
  • conflicting_sound_recording_ownership
  • contract_not_started_yet
  • future_release_date
  • insufficient_composition_ownership
  • insufficient_sound_recording_ownership
  • no_active_reference
  • non_conformant_policy
  • other
  • reference_inconsistent
  • reference_not_exclusive_enough
  • undermerged

NWayRevenueSharing

信息资产的 n 向收入分成。

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

string

n 方收益分成的状态。

可接受的值包括：

  • ineligible_in_all_owned_territories
  • restricted_in_all_owned_territories
  • restricted_in_some_owned_territories
  • unrestricted_in_all_owned_territories
  • unrestricted_in_some_owned_territories
eligibleTerritories[]

string

每个国家/地区都由其双字母 ISO 国家/地区代码 (ISO 3166-1 alpha-2) 表示。
ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

有关资产在哪些地区不符合 n 方收益分成条件的信息。

TerritoriesIneligibleForNWayRevenueSharing

有关资产不符合多方收入分成条件的地区的信息。

JSON 表示法 
{
  "reason": string,
  "territories": [
    string
  ]
}
字段
reason

string

相应资源中列出的地区的不符合条件的原因。

可接受的值包括：

  • composition insufficient ownership
  • composition insufficient policy
  • contract not started yet
  • opted out
  • other
  • sound recording insufficient policy
  • sound recording ownership conflict
territories[]

string

每个国家/地区都由其双字母 ISO 国家/地区代码 (ISO 3166-1 alpha-2) 表示。

方法

get

 检索指定资产的元数据。

insert

 插入具有指定元数据的资产。

list

 根据资产元数据检索资源列表。

patch

 修补指定资产的元数据。

update

 更新指定素材资源的元数据。