- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Retrieves the metadata for the specified asset. Note that if the request identifies an asset that has been merged with another asset, meaning that YouTube identified the requested asset as a duplicate, then the request retrieves the merged, or synthesized, asset.
HTTP request
GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
assetId
|
The |
Query parameters
fetchMatchPolicy
string
The fetchMatchPolicy
parameter specifies the version of the asset's match policy that should be returned in the API response.
The fetchMatchPolicy
parameter specifies a comma-separated list of versions of the asset's match policy that should be returned in the API response. The deprecated field matchPolicy
is only set if exactly one value of fetchMatchPolicy
is specified. Acceptable values are:
-
effective– Retrieve the match policy that YouTube applies for the asset. -
mine– Retrieve the match policy set by the default content owner for the currently authenticated user. -
none– Do not retrieve the asset's match policy. This is the default value.
fetchOwnership
string
The fetchOwnership
parameter specifies the version of the asset's ownership data that should be returned in the API response. As with asset metadata, YouTube can receive asset ownership data from multiple sources.
The fetchOwnership
parameter specifies a comma-separated list of versions of the asset's ownership data that should be returned in the API response. As with asset metadata, YouTube can receive asset ownership data from multiple sources.
The deprecated field ownership
is only set if exactly one value of fetchOwnership
is specified.
Acceptable values are:
-
canonical– This parameter has been deprecated . Seeeffective. -
effective– Retrieve the ownership data that YouTube has algorithmically determined is the most accurate for the asset. -
mine– Retrieve the ownership data provided by the default content owner associated with the currently authenticated user. -
none– Do not retrieve any ownership data. This is the default value.
fetchOwnershipConflicts
boolean
The fetchOwnershipConflicts
parameter allows you to retrieve information about ownership conflicts.
onBehalfOfContentOwner
string
The onBehalfOfContentOwner
parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Asset
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview .
