Method: validator.validate
Stay organized with collections
Save and categorize content based on your preferences.
validator.validate a metadata file.
HTTP request
POST https://youtubepartner.googleapis.com/youtube/partner/v1/validator
The URL uses gRPC Transcoding
syntax.
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 ValidateRequest
.
Response body
Response from validation request.
If successful, the response body contains data with the following structure:
| Fields |
status
|
string
The validation status.
|
errors[]
|
object ( ValidateError
)
The list of errors and/or warnings.
|
kind
|
string
The type of the API resource. For this operation, the value is youtubePartner#validateResponse
.
|
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview
.
ValidateRequest
Request to validate content.
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 webpage documents how to use the YouTube Partner API's \u003ccode\u003evalidator\u003c/code\u003e to validate a metadata file through a \u003ccode\u003ePOST\u003c/code\u003e request to \u003ccode\u003ehttps://youtubepartner.googleapis.com/youtube/partner/v1/validator\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e query parameter to specify the content owner, particularly for users managing multiple content owners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be a \u003ccode\u003eValidateRequest\u003c/code\u003e object, including the uploader name, the metadata file contents, the locale for error messages, and the resource \u003ccode\u003ekind\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will include a \u003ccode\u003estatus\u003c/code\u003e string indicating the validation results, an array of \u003ccode\u003eerrors\u003c/code\u003e and/or \u003ccode\u003ewarnings\u003c/code\u003e objects, and a \u003ccode\u003ekind\u003c/code\u003e string confirming the response type.\u003c/p\u003e\n"],["\u003cp\u003eTo use this endpoint, the request must be authorized with the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details the process for validating a metadata file via the YouTube Partner API. A `POST` request is sent to the specified URL, with the `onBehalfOfContentOwner` parameter identifying the acting content owner. The request body, defined as `ValidateRequest`, includes the uploader name, metadata file content, and desired locale. The response contains a `status`, `errors` (a list of validation issues), and `kind`, with required OAuth scope.\n"],null,["# Method: validator.validate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ValidateResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ValidateRequest](#ValidateRequest)\n - [JSON representation](#ValidateRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nvalidator.validate a metadata file.\n\n### HTTP request\n\n`POST https://youtubepartner.googleapis.com/youtube/partner/v1/validator`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\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 [ValidateRequest](/youtube/partner/reference/rest/v1/validator/validate#ValidateRequest).\n\n### Response body\n\nResponse from validation request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"status\": string, \"errors\": [ { object (/youtube/partner/reference/rest/v1/validator#ValidateError) } ], \"kind\": string } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------------------|\n| `status` | `string` The validation status. |\n| `errors[]` | `object (`[ValidateError](/youtube/partner/reference/rest/v1/validator#ValidateError)`)` The list of errors and/or warnings. |\n| `kind` | `string` The type of the API resource. For this operation, the value is `youtubePartner#validateResponse`. |\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).\n\nValidateRequest\n---------------\n\nRequest to validate content.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"uploaderName\": string, \"content\": string, \"locale\": string, \"kind\": string } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uploaderName` | `string` The uploader name. |\n| `content` | `string` The metadata file contents. |\n| `locale` | `string` The desired locale of the error messages as defined in BCP 47 (http: //tools.ietf.org/html/bcp47). For example, \"en-US\" or \"de\". If not // specified we will return the error messages in English (\"en\"). |\n| `kind` | `string` The type of the API resource. For this operation, the value is `youtubePartner#validateRequest`. |"]]
