Method: references.insert

Erstellt eine Referenz auf eine der folgenden Arten:

  • Wenn Sie mit Ihrer Anfrage eine Referenzdatei hochladen, erstellt YouTube die Referenz aus den bereitgestellten Inhalten. Sie können entweder eine Video-/Audiodatei oder einen vorab generierten Fingerabdruck angeben. Wenn Sie einen vorab generierten Fingerabdruck angeben, legen Sie die Eigenschaft fpDirect der Ressource reference im Anfragetext auf true fest. In diesem Ablauf können Sie entweder den Multipart oder den fortsetzbaren Upload verwenden, um die Referenzinhalte bereitzustellen.
  • Wenn Sie eine Referenz mit einem Video erstellen möchten, auf das Anspruch erhoben wurde, verwenden Sie den Parameter claimId, um den Anspruch zu identifizieren.

HTTP-Anfrage

  • Upload-URI für Anfragen zum Hochladen von Medien:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • Metadaten-URI für Anfragen mit ausschließlich Metadaten:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
claimId

string

Mit dem Parameter claimId wird die YouTube-Anspruchs-ID eines vorhandenen Anspruchs angegeben, aus dem eine Referenz erstellt werden soll. Das Video, auf das Anspruch erhoben wurde, wird als Referenzinhalt verwendet.

onBehalfOfContentOwner

string

Mit dem Parameter onBehalfOfContentOwner wird der Rechteinhaber angegeben, in dessen Namen der Nutzer handelt. Dieser Parameter unterstützt Nutzer, deren Konten mit mehreren Rechteinhabern verknüpft sind.

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.