Method: ownershipHistory.list
Stay organized with collections
Save and categorize content based on your preferences.
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:
| 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
.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eRetrieves a list of the most recent ownership data for an asset, including data from multiple sources if applicable.\u003c/p\u003e\n"],["\u003cp\u003eRequest the ownership history using the \u003ccode\u003eGET\u003c/code\u003e method and providing the \u003ccode\u003eassetId\u003c/code\u003e as a query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of \u003ccode\u003eownershipHistory\u003c/code\u003e resources containing details about the asset's ownership.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details retrieving asset ownership history via the YouTube Partner API. A `GET` request to `https://youtubepartner.googleapis.com/youtube/partner/v1/ownershipHistory` is used, with an empty request body. Required query parameters include `assetId` to specify the asset and `onBehalfOfContentOwner` to identify the relevant content owner. The successful response contains a JSON object with a `kind` field, and an `items` array of `ownershipHistory` resources. Authorization requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope.\n"],null,["# Method: ownershipHistory.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.OwnershipHistoryListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves 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.\n\n### HTTP request\n\n`GET https://youtubepartner.googleapis.com/youtube/partner/v1/ownershipHistory`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `assetId` | `string` The `assetId` parameter specifies the YouTube asset ID of the asset for which you are retrieving an ownership data history. |\n| `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. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of `ownershipHistory` resources associated with an asset.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"items\": [ { object (/youtube/partner/reference/rest/v1/ownershipHistory#RightsOwnershipHistory) } ] } ``` |\n\n| Fields ||\n|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API response. For this operation, the value is `youtubePartner#ownershipHistoryList`. |\n| `items[]` | `object (`[RightsOwnershipHistory](/youtube/partner/reference/rest/v1/ownershipHistory#RightsOwnershipHistory)`)` A list of ownership history (`youtubePartner#ownershipHistory`) resources that match the request criteria. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/youtubepartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
