REST Resource: assets

资源:Asset

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-Way 收益分成。

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

string

N 向收益分成的状态。

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

更新指定资产的元数据。