Method: references.insert

    • References can be created by uploading a video/audio file or a pre-generated fingerprint, or by using a claimed video's content via the claimId parameter.

    • HTTP requests for uploading media content use the POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references URI, while metadata-only requests use POST https://youtubepartner.googleapis.com/youtube/partner/v1/references .

    • The onBehalfOfContentOwner query parameter specifies the content owner the user is acting on behalf of, supporting users associated with multiple content owners.

    • The request body is an instance of the Reference , and if the request is successful, the response body will also contain an instance of Reference .

    • The https://www.googleapis.com/auth/youtubepartner OAuth scope is required for authorization.

    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 .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: