Method: ownershipHistory.list

Retrieves a list of the ownership data for an asset, regardless of which content owner provided the data. The list only includes the most recent ownership data for each content owner. However, if the content owner has submitted ownership data through multiple data sources (API, content feeds, etc.), the list will contain the most recent data for each content owner and data source.

HTTP request

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

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 an ownership data 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 ownershipHistory resources associated with an asset.

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

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

string

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

object (RightsOwnershipHistory)

A list of ownership history (youtubePartner#ownershipHistory) 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.