Method: assetMatchPolicy.patch
Stay organized with collections
Save and categorize content based on your preferences.
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
.
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 page explains how to patch an asset's match policy through the YouTube Partner API, allowing asset owners to define their own match policies.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePATCH\u003c/code\u003e HTTP request targets a specific asset using its \u003ccode\u003eassetId\u003c/code\u003e in the URL, following gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e query parameter allows users associated with multiple content owners to act on behalf of a specific owner.\u003c/p\u003e\n"],["\u003cp\u003eBoth the request and response bodies utilize the \u003ccode\u003eAssetMatchPolicy\u003c/code\u003e resource to define and retrieve match policy data.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this functionality requires the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to patch an asset's match policy on YouTube. The core action is using a `PATCH` HTTP request to `https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/matchPolicy`. The `assetId` (path parameter) identifies the asset. `onBehalfOfContentOwner` (query parameter) specifies the content owner. The request and response bodies utilize the `AssetMatchPolicy` instance. Authorization requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope.\n"],null,["# Method: assetMatchPolicy.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\nPatches 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.\n\n### HTTP request\n\n`PATCH https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/matchPolicy`\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 for which you are retrieving the match policy. |\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 [AssetMatchPolicy](/youtube/partner/reference/rest/v1/assetMatchPolicy#AssetMatchPolicy).\n\n### Response body\n\nIf successful, the response body contains an instance of [AssetMatchPolicy](/youtube/partner/reference/rest/v1/assetMatchPolicy#AssetMatchPolicy).\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)."]]
