REST Resource: assets
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Asset
An
asset
resource represents a piece of intellectual property, such as a sound recording or television episode.
JSON representation
|
{
"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
)
}
}
|
Fields
|
kind
|
string
The type of the API resource. For
asset
resources, the value is
youtubePartner#asset
.
|
type
|
string
The asset's type. This value determines the metadata fields that you can set for the asset. In addition, certain API functions may only be supported for specific types of assets. For example, composition assets may have more complex ownership data than other types of assets.
Valid values for this property are:
-
art_track_video
composition
episode
general
movie
music_video
season
show
sound_recording
video_game
web
|
status
|
string
The asset's status.
|
metadata
|
object (
Metadata
)
The
metadata
object contains information that identifies and describes the asset. This information could be used to search for the asset or to eliminate duplication within YouTube's database.
|
ownership
|
object (
RightsOwnership
)
The
ownership
object identifies an asset's owners and provides additional details about their ownership, such as the territories where they own the asset.
|
matchPolicy
|
object (
AssetMatchPolicy
)
The
matchPolicy
object contains information about the asset's match policy, which YouTube applies to user-uploaded videos that match the asset.
|
timeCreated
|
string
The date and time the asset was created. The value is specified in
RFC 3339
(
YYYY-MM-DDThh:mm:ss.000Z
) format.
|
metadataMine
|
object (
Metadata
)
|
metadataEffective
|
object (
Metadata
)
|
ownershipMine
|
object (
RightsOwnership
)
|
ownershipEffective
|
object (
RightsOwnership
)
|
matchPolicyMine
|
object (
AssetMatchPolicy
)
|
matchPolicyEffective
|
object (
AssetMatchPolicy
)
|
ownershipConflicts
|
object (
OwnershipConflicts
)
The
ownershipConflicts
object contains information about the asset's ownership conflicts.
|
id
|
string
An ID that YouTube assigns and uses to uniquely identify the asset.
|
aliasId[]
|
string
A list of asset IDs that can be used to refer to the asset. The list contains values if the asset represents multiple constituent assets that have been merged. In that case, any of the asset IDs originally assigned to the constituent assets could be used to update the master, or synthesized, asset.
|
label[]
|
string
A list of asset labels on the asset.
|
licensability
|
object (
AssetLicensability
)
Asset licensability information.
|
nWayRevenueSharing
|
object (
NWayRevenueSharing
)
N way revenue sharing (Pangea) information.
|
OwnershipConflicts
The
ownershipConflicts
resource represents information about asset's conflicting ownership.
Fields
|
general[]
|
object (
TerritoryConflicts
)
A list that identifies ownership conflicts of an asset and the territories where conflicting ownership is inserted.
|
performance[]
|
object (
TerritoryConflicts
)
A list that identifies ownership conflicts of the performance rights for a composition asset and the territories where conflicting ownership is inserted.
|
synchronization[]
|
object (
TerritoryConflicts
)
A list that identifies ownership conflicts of the synchronization rights for a composition asset and the territories where conflicting ownership is inserted.
|
mechanical[]
|
object (
TerritoryConflicts
)
A list that identifies ownership conflicts of the mechanical rights for a composition asset and the territories where conflicting ownership is inserted.
|
kind
|
string
The type of the API resource. For
ownershipConflicts
resources, the value is
youtubePartner#ownershipConflicts
.
|
TerritoryConflicts
Method to look up terrories with ownership conflicts.
JSON representation
|
{
"territory"
:
string
,
"conflictingOwnership"
:
[
{
object (
ConflictingOwnership
)
}
]
}
|
ConflictingOwnership
Represents information about one of conflicting ownerships.
JSON representation
|
{
"ratio"
:
number
,
"owner"
:
string
}
|
Fields
|
ratio
|
number
The percentage of the asset that the owner controls or administers.
|
owner
|
string
The ID of the conflicting asset's owner.
|
AssetLicensability
Asset licensability information.
JSON representation
|
{
"licensable"
:
boolean
,
"licensabilityState"
:
string
,
"unlicensableReason"
:
[
string
]
}
|
Fields
|
licensable
|
boolean
Whether the reconciled asset is licensable.
|
licensabilityState
|
string
The licensability state of the asset.
|
unlicensableReason[]
|
string
The reason for why the asset is not licensable.
|
NWayRevenueSharing
Information asset's n-way revshare.
Fields
|
status
|
string
Status of n-way revenue sharing.
|
eligibleTerritories[]
|
string
Each country is represented by its two-letter ISO country code (ISO 3166-1 alpha-2).
|
ineligibleTerritories[]
|
object (
TerritoriesIneligibleForNWayRevenueSharing
)
Information about teritorries in which an asset is ineligible for n-way revenue sharing.
|
TerritoriesIneligibleForNWayRevenueSharing
Information about territories where an asset is not eligible for n-way revshare.
JSON representation
|
{
"reason"
:
string
,
"territories"
:
[
string
]
}
|
Fields
|
reason
|
string
Ineligibility reason for teritorries listed below.
|
territories[]
|
string
Each country is represented by its two-letter ISO country code (ISO 3166-1 alpha-2).
|
Methods
|
|
Retrieves the metadata for the specified asset.
|
|
Inserts an asset with the specified metadata.
|
|
Retrieves a list of assets based on asset metadata.
|
|
Patches the metadata for the specified asset.
|
|
Updates the metadata for the specified asset.
|
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-12-01 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]