Method: assets.get

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

string

The assetId parameter specifies the YouTube asset ID of the asset being retrieved.

Query parameters

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.
fetchMetadata

string

The fetchMetadata parameter specifies the version of the asset's metadata that should be returned in the API response. In some cases, YouTube receives metadata for an asset from multiple sources, such as when different partners own the asset in different territories.
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. See effective.
  • 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.