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 オブジェクトには、アセットの一致ポリシーに関する情報が含まれます。このポリシーは、ユーザーがアップロードした動画のうちアセットに一致するものに適用されます。

timeCreated

string

アセットの作成日時。値は RFC 3339YYYY-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 で規定されている 2 文字の国コードです。

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

各国は、2 文字の ISO 国コード(ISO 3166-1 alpha-2)で表されます。

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

あるアセットが n 方向の収益分配の対象とならない地域に関する情報。

TerritoriesIneligibleForNWayRevenueSharing

アセットを N 方向の収益分配の対象とならない地域に関する情報。

JSON 表現
{
  "reason": string,
  "territories": [
    string
  ]
}
フィールド
reason

string

以下の国または地域で不適格となった理由。

territories[]

string

各国は、2 文字の ISO 国コード(ISO 3166-1 alpha-2)で表されます。

Methods

get

指定したアセットのメタデータを取得します。

insert

指定されたメタデータを持つアセットを挿入します。

list

アセットのメタデータに基づいてアセットのリストを取得します。

patch

指定したアセットのメタデータにパッチを適用します。

update

指定したアセットのメタデータを更新します。