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

N-Way 收益分成状态。

eligibleTerritories[]

string

每个国家/地区均由两个字母的 ISO 国家/地区代码 (ISO 3166-1 alpha-2) 表示。

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

资产不符合 N-Way 收益分成条件的地区的相关信息。

TerritoriesIneligibleForNWayRevenueSharing

资产不符合 N-Way 收益分成条件的地区的相关信息。

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

string

不符合条件的地区(如下所示)。

territories[]

string

每个国家/地区均由两个字母的 ISO 国家/地区代码 (ISO 3166-1 alpha-2) 表示。

方法

get

检索指定资产的元数据。

insert

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

list

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

patch

修补指定资产的元数据。

update

更新指定资产的元数据。