Method: references.insert

Creates a reference in one of the following ways:

  • If your request is uploading a reference file, YouTube creates the reference from the provided content. You can provide either a video/audio file or a pre-generated fingerprint. If you are providing a pre-generated fingerprint, set the reference resource's fpDirect property to true in the request body. In this flow, you can use either the multipart or resumable upload flows to provide the reference content.
  • If you want to create a reference using a claimed video as the reference content, use the claimId parameter to identify the claim.

HTTP request

  • Upload URI, for media upload requests:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • Metadata URI, for metadata-only requests:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
claimId

string

The claimId parameter specifies the YouTube claim ID of an existing claim from which a reference should be created. (The claimed video is used as the reference content.)
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 Reference.

Response body

If successful, the response body contains an instance of Reference.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.