Page Summary
-
This webpage outlines how to create a claim for a YouTube video via the API, which must be uploaded to a channel associated with the same content owner as the user.
-
Claims can be created by specifying a pre-existing policy ID or by defining a custom set of rules within the
claimresource'spolicyproperty. -
The HTTP request to create a claim is a POST request to
https://youtubepartner.googleapis.com/youtube/partner/v1/claims, utilizing gRPC Transcoding syntax. -
The request requires parameters such as
isManualClaimandonBehalfOfContentOwner, and the body must include an instance of theClaimresource, as detailed in the documentation. -
Successfully creating a claim will result in a response body containing a newly created instance of the
Claimresource, and it also requires thehttps://www.googleapis.com/auth/youtubepartnerauthorization scope.
Creates a claim. The video being claimed must have been uploaded to a channel associated with the same content owner as the API user sending the request. You can set the claim's policy in any of the following ways:
- Use the
claimresource'spolicyproperty to identify a saved policy by its unique ID. - Use the
claimresource'spolicyproperty to specify a custom set of rules.
HTTP request
POST https://youtubepartner.googleapis.com/youtube/partner/v1/claims
The URL uses gRPC Transcoding syntax.
Query parameters
| Parameters | |
|---|---|
isManualClaim
|
restricted |
onBehalfOfContentOwner
|
The |
Request body
The request body contains an instance of Claim
.
Response body
If successful, the response body contains a newly created instance of Claim
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview .
