Method: references.patch

Aktualisiert eine Referenz. Mit dieser Methode können nur status und excludedIntervals aktualisiert werden. Der Anfragetext muss mindestens eines dieser beiden Felder enthalten. Andere Referenzeigenschaften können nach der Erstellung nicht mehr geändert werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
referenceId

string

Der Parameter referenceId gibt die YouTube-Referenz-ID der zu aktualisierenden Referenz an.

Suchparameter

Parameter
onBehalfOfContentOwner

string

Der Parameter onBehalfOfContentOwner gibt den Rechteinhaber an, in dessen Namen der Nutzer handelt. Dieser Parameter unterstützt Nutzer, deren Konten mit mehreren Rechteinhabern verknüpft sind.

releaseClaims

boolean

Der Parameter releaseClaims gibt an, dass Sie alle Ansprüche aufgrund von Übereinstimmungen, die mit dieser Referenz verknüpft sind, zurückziehen möchten. Dieser Parameter funktioniert nur, wenn der Status des Anspruchs auf „inactive“ aktualisiert wird. Sie können den Wert des Parameters dann auf true festlegen, um alle durch diese Referenz erstellten Ansprüche freizugeben.

Anfragetext

Der Anfragetext enthält eine Instanz von Reference.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Reference.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.