Method: references.insert

Erstellt eine Referenz auf eine der folgenden Arten:

  • Wenn in deinem Antrag eine Referenzdatei hochgeladen wird, erstellt YouTube die Referenz aus den bereitgestellten Inhalten. Sie können entweder eine Video-/Audiodatei oder einen vorgenerierten Fingerabdruck bereitstellen. Wenn du einen vorgenerierten Fingerabdruck angibst, setze das Attribut fpDirect der reference-Ressource im Anfragetext auf true. In diesem Ablauf kannst du entweder den mehrteiligen oder den resumable Uploadvorgang verwenden, um den Referenzinhalt bereitzustellen.
  • Wenn du eine Referenz erstellen möchtest, bei der ein Video mit Ansprüchen als Referenzinhalt verwendet wird, verwende den Parameter claimId zur Identifizierung des Anspruchs.

HTTP-Anfrage

  • Upload-URI für Medien-Uploadanfragen:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • Metadaten-URI, für Anfragen, die nur Metadaten enthalten:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
claimId

string

Der claimId-Parameter gibt die YouTube-Anspruchs-ID eines vorhandenen Anspruchs an, über den eine Referenz erstellt werden soll. Das Video mit Ansprüchen wird als Referenzinhalt verwendet.
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.

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 in der Übersicht über OAuth 2.0.