Method: ownership.patch
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
PATCH 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 webpage details how to update ownership information for a specific YouTube asset using a PATCH HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eassetId\u003c/code\u003e path parameter to identify the asset and the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e query parameter to specify the content owner.\u003c/p\u003e\n"],["\u003cp\u003eThe request and response bodies both utilize the \u003ccode\u003eRightsOwnership\u003c/code\u003e resource to represent the asset's ownership data.\u003c/p\u003e\n"],["\u003cp\u003eUpdating asset ownership requires OAuth 2.0 authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details updating an asset's ownership information on YouTube via a PATCH 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 and response bodies both use the `RightsOwnership` format. It requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope for authorization. The platform aggregates data from different owners to create a reliable overview.\n"],null,["# Method: ownership.patch\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`PATCH 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)."]]