REST Resource: assetShares

리소스: AssetShare

음악작품 저작물과만 관련이 있는 assetShare 리소스는 저작물 리소스의 두 표현 간의 관계를 식별합니다.

  • viewId, 즉 음악작품 보기는 특정 음원에 삽입된 음악작품 저작물을 나타냅니다. 음악작품 보기는 YouTube가 특정 음원의 음악작품 권한에 대해 표시하는 표준 정보 집합이며 여러 데이터 제공업체의 정보를 합성할 수 있습니다. .
    • 각 음원 저작물은 정확히 하나의 viewId에 매핑됩니다.
    • 각 viewId는 하나 이상의 shareIds에 매핑됩니다. 하지만 viewId는 음악작품에 여러 소유자가 있는 경우에만 여러 shareIds에 매핑됩니다. 단일 콘텐츠 소유자의 관점에서 viewId는 단일 shareId와 연결됩니다. 콘텐츠 소유자는 콘텐츠 소유자가 제공한 데이터를 나타내는 shareIds만 검색할 수 있기 때문입니다.

      API를 사용하는 단일 콘텐츠 소유자가 음악작품의 여러 소유자를 대표하여 음악작품의 여러 공유를 소유할 수 있습니다. 예를 들어 디지털 권리 애그리게이터는 여러 지역의 여러 당사자로부터 동일한 음악작품에 대한 권리를 취득할 수 있습니다. 애그리게이터에는 이러한 권리를 나타내는 개별 항목이 있으며 이는 YouTube 모델에서 다른 음악작품 공유에 매핑됩니다. 다른 음악작품 공유가 동일한 음악작품 보기에 연결될 수 있습니다.

  • shareId 또는 음악작품 공유는 특정 게시자가 음악작품 저작물에 제공한 정보를 나타냅니다. shareId은(는) 여러 음원과 연결될 수 있습니다.
많은 API 메서드를 사용하여 저작물에 대한 정보를 검색하거나 업데이트할 수 있습니다. 음악작품 저작물 관리 가이드에서는 제공된 저작물 ID가 shareIds인지 viewIds인지에 따라 이러한 메서드가 요청을 처리하는 방법을 설명합니다.

JSON 표현 
{
  "kind": string,
  "viewId": string,
  "shareId": string
}
필드
kind

string

API 리소스의 유형입니다. 이 리소스의 값은 youtubePartner#assetShare입니다.
viewId

string

YouTube가 저작물 보기를 고유하게 식별하기 위해 할당하고 사용하는 값입니다.
shareId

string

YouTube가 저작물 공유를 고유하게 식별하기 위해 할당하고 사용하는 값입니다.

메서드

list

 이 메서드는 파트너가 소유한 저작물 공유 목록을 가져와 지정된 저작물 보기 ID에 매핑하거나 파트너가 소유한 지정된 저작물 공유 ID와 연결된 저작물 보기 목록을 검색합니다.