Method: ownership.update

  • This API allows content owners to update ownership information for a specific YouTube asset using the asset ID.

  • YouTube combines ownership data from multiple sources to provide the most comprehensive view of asset ownership.

  • The request should be a PUT request to the specified endpoint with the asset ID as a path parameter.

  • You can specify a content owner on whose behalf the request is being made using the onBehalfOfContentOwner query parameter.

  • The request and response body both use the RightsOwnership object to define ownership details.

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.

If you want to update an asset that is currently owned by another content owner, you must add your ownership to the asset using this method before you can update its metadata (using assets.update or assets.patch) or its match policy (using assetMatchPolicy.update or assetMatchPolicy.patch).

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.