Method: ownership.get
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves the ownership data provided for the specified asset by the content owner associated with the authenticated user.
HTTP request
GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/ownership
The URL uses gRPC Transcoding
syntax.
Path parameters
| Parameters |
assetId
|
string
The assetId
parameter specifies the YouTube asset ID for which you are retrieving ownership data.
|
Query parameters
| Parameters |
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 RightsOwnership
.
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\u003eThis webpage details how to retrieve ownership data for a specific YouTube asset using the YouTube Partner API.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves sending a GET request to a specified URL, incorporating the asset ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eAn optional query parameter, \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e, can be used to specify the content owner when the user is associated with multiple content owners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful request will return ownership data in a \u003ccode\u003eRightsOwnership\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This documentation details retrieving asset ownership data via a `GET` request to `https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/ownership`. The `assetId` path parameter specifies the target asset. The `onBehalfOfContentOwner` query parameter identifies the acting content owner. The request body must be empty. Successful responses contain `RightsOwnership` data. The operation requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope for authorization.\n"],null,["# Method: ownership.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves the ownership data provided for the specified asset by the content owner associated with the authenticated user.\n\n### HTTP request\n\n`GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/ownership`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|--------------------------------------------------------------------------------------------------------------|\n| `assetId` | `string` The `assetId` parameter specifies the YouTube asset ID for which you are retrieving ownership data. |\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\nIf successful, the response body contains an instance of [RightsOwnership](/youtube/partner/reference/rest/v1/ownership#RightsOwnership).\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)."]]
