REST Resource: ownership
Stay organized with collections
Save and categorize content based on your preferences.
Resource: RightsOwnership
The rightsOwnership
resource represents the ownership data for an asset. It identifies an asset's owners and provides additional details about their ownership, such as the territories where they own the asset.
TerritoryOwners
Represents ownership conflict in a single territory.
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\u003eThe \u003ccode\u003erightsOwnership\u003c/code\u003e resource details ownership data for an asset, including its owners and the territories where they hold ownership.\u003c/p\u003e\n"],["\u003cp\u003eAsset ownership can be specified as general, or categorized as mechanical, performance, or synchronization rights, with general being applicable to all asset types except compositions.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTerritoryOwners\u003c/code\u003e specifies ownership within specific territories, detailing the type of ownership, affected territories, the ownership ratio, the owner's name, and the publisher's name for composition assets.\u003c/p\u003e\n"],["\u003cp\u003eOwnership in a specific territory can either be specified to apply to or not apply to the listed territories.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers methods to retrieve (\u003ccode\u003eget\u003c/code\u003e), update (\u003ccode\u003eupdate\u003c/code\u003e), or provide new ownership information (\u003ccode\u003epatch\u003c/code\u003e) for an asset.\u003c/p\u003e\n"]]],["The `rightsOwnership` resource details asset ownership, including owners and territories. Ownership can be general or specific to mechanical, performance, or synchronization rights for compositions. `TerritoryOwners` specifies ownership in territories, including `type`, `territories`, `ratio`, `owner`, and `publisher`. Actions include retrieving ownership data (`get`), providing new information (`patch`), and updating ownership details (`update`) for an asset. Ownership is managed through fields like general, performance, synchronization and mechanical, each containing information of the owner in specific territories.\n"],null,["# REST Resource: ownership\n\n- [Resource: RightsOwnership](#RightsOwnership)\n - [JSON representation](#RightsOwnership.SCHEMA_REPRESENTATION)\n - [TerritoryOwners](#RightsOwnership.TerritoryOwners)\n - [JSON representation](#RightsOwnership.TerritoryOwners.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: RightsOwnership\n-------------------------\n\nThe `rightsOwnership` resource represents the ownership data for an asset. It identifies an asset's owners and provides additional details about their ownership, such as the territories where they own the asset.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"general\": [ { object (/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners) } ], \"performance\": [ { object (/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners) } ], \"synchronization\": [ { object (/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners) } ], \"mechanical\": [ { object (/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners) } ], \"kind\": string } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `general[]` | `object (`[TerritoryOwners](/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners)`)` A list that identifies the owners of an asset and the territories where each owner has ownership. General asset ownership is used for all types of assets and is the only type of ownership data that can be provided for assets that are not compositions. **Note:** You cannot specify general ownership rights and also specify either mechanical, performance, or synchronization rights. |\n| `performance[]` | `object (`[TerritoryOwners](/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners)`)` A list that identifies owners of the performance rights for a composition asset. |\n| `synchronization[]` | `object (`[TerritoryOwners](/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners)`)` A list that identifies owners of the synchronization rights for a composition asset. |\n| `mechanical[]` | `object (`[TerritoryOwners](/youtube/partner/reference/rest/v1/ownership#RightsOwnership.TerritoryOwners)`)` A list that identifies owners of the mechanical rights for a composition asset. |\n| `kind` | `string` The type of the API resource. For `rightsOwnership` resources, the value is `youtubePartner#rightsOwnership`. |\n\n### TerritoryOwners\n\nRepresents ownership conflict in a single territory.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"territories\": [ string ], \"ratio\": number, \"owner\": string, \"publisher\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` This field indicates whether the ownership data applies or does not apply in the specified territories. |\n| `territories[]` | `string` A list of territories where the owner owns (or does not own) the asset. Each territory is an [ISO 3166 two-letter country code.](http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm). |\n| `ratio` | `number` The percentage of the asset that the owner controls or administers. For composition assets, the value can be any value between `0` and `100` inclusive. For all other assets, the only valid values are `100`, which indicates that the owner completely owns the asset in the specified territories, and `0`, which indicates that you are removing ownership of the asset in the specified territories. |\n| `owner` | `string` The name of the asset's owner or rights administrator. |\n| `publisher` | `string` The name of the asset's publisher. This field is only used for composition assets, and it is used when the asset owner is not known to have a formal relationship established with YouTube. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| ### [get](/youtube/partner/reference/rest/v1/ownership/get) | Retrieves the ownership data provided for the specified asset by the content owner associated with the authenticated user. |\n| ### [patch](/youtube/partner/reference/rest/v1/ownership/patch) | Provides new ownership information for the specified asset. |\n| ### [update](/youtube/partner/reference/rest/v1/ownership/update) | Provides new ownership information for the specified asset. |"]]
