Method: assetMatchPolicy.get
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves the match policy assigned to the specified asset by the content owner associated with the authenticated user. This information is only accessible to an owner of the asset.
HTTP request
GET 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 must be empty.
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."],[],["This document details retrieving an asset's match policy via an API. Key actions include sending a `GET` request to a specific URL, including the `assetId` as a path parameter. An optional `onBehalfOfContentOwner` query parameter allows specifying the content owner. The request body must be empty. A successful request returns the `AssetMatchPolicy`. Access requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope, and only asset owners can retrieve this information. The document also mentions gRPC Transcoding.\n"],null,["# Method: assetMatchPolicy.get\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\nRetrieves the match policy assigned to the specified asset by the content owner associated with the authenticated user. This information is only accessible to an owner of the asset.\n\n### HTTP request\n\n`GET 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 must be empty.\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)."]]
