Method: assetMatchPolicy.update
Stay organized with collections
Save and categorize content based on your preferences.
Updates 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
PUT 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 documentation outlines how to update an asset's match policy using the YouTube Partner API.\u003c/p\u003e\n"],["\u003cp\u003eThe request involves specifying the asset ID and can be made on behalf of a specific content owner if the user is associated with multiple.\u003c/p\u003e\n"],["\u003cp\u003eBoth the request and response bodies utilize the \u003ccode\u003eAssetMatchPolicy\u003c/code\u003e object for defining and retrieving the match policy information.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details updating an asset's match policy on YouTube, allowing each owner to set individual policies. It uses a `PUT` HTTP request to `https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}/matchPolicy`. Key actions involve specifying the `assetId` as a path parameter, and optionally the `onBehalfOfContentOwner` in query parameters. The request and response bodies use the `AssetMatchPolicy` format. Authorization requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope.\n"],null,["# Method: assetMatchPolicy.update\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\nUpdates 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`PUT 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)."]]
