Method: metadataHistory.list

  • This API endpoint retrieves a comprehensive list of all metadata associated with a specific YouTube asset, regardless of the content owner who provided it.

  • The request requires the asset's ID via the assetId query parameter and optionally supports specifying a content owner using the onBehalfOfContentOwner parameter.

  • The request body must be empty, and the request type is a GET request sent to the endpoint https://youtubepartner.googleapis.com/youtube/partner/v1/metadataHistory.

  • Successful requests return a JSON response containing an array of MetadataHistory resources, each detailing a metadata entry for the specified asset.

  • Authenticating this request requires the https://www.googleapis.com/auth/youtubepartner OAuth scope.

Retrieves a list of all metadata provided for an asset, regardless of which content owner provided the data.

HTTP request

GET https://youtubepartner.googleapis.com/youtube/partner/v1/metadataHistory

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
assetId

string

The assetId parameter specifies the YouTube asset ID of the asset for which you are retrieving a metadata history.
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

A list of metadata history resources associated with an asset.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "kind": string,
  "items": [
    {
      object (MetadataHistory)
    }
  ]
}
Fields
kind

string

The type of the API response. For this operation, the value is youtubePartner#metadataHistoryList.
items[]

object (MetadataHistory)

A list of metadata history (youtubePartner#metadataHistory) resources that match the request criteria.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.