REST Resource: assets

리소스: Asset

asset 리소스는 음원 또는 TV 에피소드와 같은 지적 재산을 나타냅니다.

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

지정된 저작물의 메타데이터를 업데이트합니다.