Method: assetMatchPolicy.patch

  • This page explains how to patch an asset's match policy through the YouTube Partner API, allowing asset owners to define their own match policies.

  • The PATCH HTTP request targets a specific asset using its assetId in the URL, following gRPC Transcoding syntax.

  • The onBehalfOfContentOwner query parameter allows users associated with multiple content owners to act on behalf of a specific owner.

  • Both the request and response bodies utilize the AssetMatchPolicy resource to define and retrieve match policy data.

  • Accessing this functionality requires the https://www.googleapis.com/auth/youtubepartner OAuth scope.

Patches the asset's match policy. If an asset has multiple owners, each owner may set its own match policy for the asset. YouTube then computes the match policy that is actually applied for the asset based on the territories where each owner owns the asset.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
assetId

string

The assetId parameter specifies the YouTube asset ID of the asset for which you are retrieving the match policy.

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

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview .

Design a Mobile Site
View Site in Mobile | Classic
Share by: