Method: assets.update

  • This webpage details how to update metadata for a specific YouTube asset using a PUT request to the YouTube Partner API.

  • The request requires the asset's assetId as a path parameter to specify which asset to update.

  • An optional onBehalfOfContentOwner query parameter can be used to identify the content owner when acting on behalf of multiple owners.

  • The request body must contain an instance of the Asset resource to define the new metadata, and the response body also returns an instance of Asset on successful update.

  • Authorization for this action requires the https://www.googleapis.com/auth/youtubepartner OAuth scope.

Updates the metadata for the specified asset.

If the asset is already owned by another content owner, you must add your ownership to the asset (using the ownership.update or ownership.patch method) before you can update its metadata. Otherwise, the request returns a PERMISSION_DENIED error.

HTTP request

PUT https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}

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 Asset.

Response body

If successful, the response body contains an instance of Asset.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.