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 .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: