Method: references.patch

Page Summary

• This endpoint allows you to update an existing YouTube reference using a PATCH request to the specified URL, with the reference ID provided as a path parameter.

• The onBehalfOfContentOwner query parameter lets users manage content on behalf of multiple content owners, and releaseClaims query parameter allows for the release of claims associated with the reference being updated.

• The request and response bodies both contain an instance of the Reference resource, and can be found in the Reference definition.

• Updating a reference requires authorization with the https://www.googleapis.com/auth/youtubepartner OAuth scope.

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Patches a reference.

HTTP request

PATCH https://youtubepartner.googleapis.com/youtube/partner/v1/references/{referenceId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
referenceId	string The referenceId parameter specifies the YouTube reference ID of the reference being updated.

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.
releaseClaims	boolean The releaseClaims parameter indicates that you want to release all match claims associated with this reference. This parameter only works when the claim's status is being updated to 'inactive' - you can then set the parameter's value to true to release all match claims produced by this reference.

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.