Method: ownership.update
Stay organized with collections
Save and categorize content based on your preferences.
Provides new ownership information for the specified asset. Note that YouTube may receive ownership information from multiple sources. For example, if an asset has multiple owners, each owner might send ownership data for the asset. YouTube algorithmically combines the ownership data received from all of those sources to generate the asset's canonical ownership data, which should provide the most comprehensive and accurate representation of the asset's ownership.
HTTP request
PUT 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 of the asset being updated.
|
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 contains an instance of RightsOwnership
.
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 API allows content owners to update ownership information for a specific YouTube asset using the asset ID.\u003c/p\u003e\n"],["\u003cp\u003eYouTube combines ownership data from multiple sources to provide the most comprehensive view of asset ownership.\u003c/p\u003e\n"],["\u003cp\u003eThe request should be a PUT request to the specified endpoint with the asset ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify a content owner on whose behalf the request is being made using the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request and response body both use the \u003ccode\u003eRightsOwnership\u003c/code\u003e object to define ownership details.\u003c/p\u003e\n"]]],["This document outlines the process for updating asset ownership on YouTube via the YouTube Partner API. It uses a `PUT` request to `https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/ownership`, requiring the `assetId` as a path parameter. The `onBehalfOfContentOwner` query parameter specifies the content owner. The request and response bodies utilize the `RightsOwnership` resource. The method requires `https://www.googleapis.com/auth/youtubepartner` OAuth scope for authorization. The try it button allows the user to test the update.\n"],null,["# Method: ownership.update\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\nProvides new ownership information for the specified asset. Note that YouTube may receive ownership information from multiple sources. For example, if an asset has multiple owners, each owner might send ownership data for the asset. YouTube algorithmically combines the ownership data received from all of those sources to generate the asset's canonical ownership data, which should provide the most comprehensive and accurate representation of the asset's ownership.\n\n### HTTP request\n\n`PUT 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 of the asset being updated. |\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 contains an instance of [RightsOwnership](/youtube/partner/reference/rest/v1/ownership#RightsOwnership).\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)."]]
