REST Resource: claims

Ressource: Anspruch

Durch einen claim wird ein von einem Partner oder Nutzer hochgeladenes Video mit einem Asset verknüpft, mit dem das Video übereinstimmt. Der Anspruch gibt an, ob das Video mit den Audio-, Video- oder audiovisuellen (Audio und Video) Komponenten des Assets übereinstimmt. Der Anspruch gibt auch die Richtlinie an, die der Rechteinhaber auf das Video mit Anspruch anwenden möchte.

JSON-Darstellung 
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
Felder
kind

string

Der Typ der API-Ressource. Für claim-Ressourcen ist dieser Wert youtubePartner#claim.
policy

object (Policy)

Die vom Rechteinhaber für den Anspruch angegebene Richtlinie.
timeCreated

string

Der Zeitpunkt, zu dem der Anspruch erhoben wurde.
contentType

string

Dieser Wert gibt an, ob sich der Anspruch auf die Audio-, Video- oder audiovisuellen Inhalte des beanspruchten Inhalts bezieht.

Akzeptable Werte sind:

  • audio
  • audiovisual
  • video
ugcType

string

Der UGC-Typ des Anspruchs.

Akzeptable Werte sind:

  • premium
  • song
  • standard
isPartnerUploaded

boolean

Gibt an, ob der Anspruch von einem Partner hochgeladen wurde.
timeStatusLastModified

string

Der Zeitpunkt, zu dem der Anspruchsstatus und/oder die Statusdetails zuletzt geändert wurden.
blockOutsideOwnership

boolean

Gibt an, ob das Video, auf das Anspruch erhoben wurde, überall dort blockiert werden soll, wo es nicht explizit gehört.
status

string

Der Status des Anspruchs.

Akzeptable Werte sind:

  • active: Der Anspruch ist aktiv und es werden Richtlinien angewendet.
  • appealed: Der Nutzer hat Einspruch gegen einen abgelehnten Widerspruch eingelegt.
  • disputed: Der Nutzer hat Einspruch gegen den Anspruch erhoben.
  • inactive: Der Anspruch ist inaktiv.
  • manual_review – Der Anspruch wird gemäß der Richtlinie zur manuellen Überprüfung weitergeleitet.
  • pending: Der Anspruch wird noch überprüft oder bearbeitet.
  • potential: Der Anspruch ist ein potenzieller Abgleich, der noch bestätigt werden muss.
  • takedown: Das Video mit Ansprüchen wurde deaktiviert.

Wenn Sie einen Anspruch aktualisieren, können Sie seinen Status von active in inactive ändern, um den Anspruch aufzuheben. Wenn der Rechteinhaber die entsprechenden Berechtigungen hat, unterstützt die API auch die Aktualisierung des Status von inactive (bei der Reaktivierung eines Anspruchs ohne Probleme in YouTube Studio) oder potential (bei der Bestätigung eines potenziellen Anspruchs) auf active. Angefochtene Ansprüche können nicht über die API reaktiviert werden. Sie müssen in YouTube Studio überprüft werden.
appliedPolicy

object (Policy)

Die für den Inhaber des Aufrufs angewandte Richtlinie für den Anspruch. Das ist möglicherweise nicht dieselbe wie die endgültige Anspruchsrichtlinie für das Video, da die Richtlinie anderer Partner für denselben Anspruch nicht berücksichtigt wird.
id

string

Die ID, die YouTube zuweist und verwendet, um den Anspruch eindeutig zu identifizieren.
assetId

string

Die eindeutige YouTube-Asset-ID, die das mit dem Anspruch verknüpfte Asset identifiziert.
videoId

string

Die eindeutige YouTube-Video-ID des Videos, auf das Anspruch erhoben wurde.
origin

object (Origin)
matchInfo

object (MatchInfo)

Wenn dieser Anspruch automatisch auf Grundlage einer bereitgestellten Referenz generiert wurde, finden Sie in diesem Abschnitt Details zu der Übereinstimmung, die den Anspruch ausgelöst hat.
studioInfo

object (StudioInfo)

Enthält URLs, die auf Seiten in Studio verweisen, die mit dem Anspruch zusammenhängen.

Ursprung

Dieses Objekt enthält Informationen zur Quelle der Metadaten oder Eigentümerdaten.

JSON-Darstellung 
{
  "source": string
}
Felder
source

string

Die Quelle der Anforderung. Akzeptable Werte sind:

  • audioMatch: Der Audiotrack des Videos, auf das ein Anspruch erhoben wurde, stimmt mit einer Content ID-Referenz überein.
  • audioSwap – Ein Song aus dem AudioSwap-Programm wurde in das Video mit Ansprüchen eingefügt.
  • batchTool: Der Anspruch wurde durch einen Bulk-Vorgang erstellt.
  • cmsUpload: Der Anspruch wurde über SFTP oder einen Studio-Upload erstellt.
  • contentIdApi: Der Anspruch wurde mit der Content ID API erstellt.
  • cvpSearch: Der Anspruch wurde über die Suchseite im Tool des Programms zur Inhaltsprüfung eingereicht.
  • descriptiveSearch: Die Inhalte wurden über die Seite für manuelle Ansprüche in YouTube Studio beansprucht.
  • external: Der Anspruch wurde mit externen Tools erstellt.
  • gameId: Das Video wurde vom Game-ID-System abgeglichen.
  • googleDevId: Der Anspruch wurde von einem Google-Entwickler erhoben.
  • hashcode: Der Anspruch wurde durch MD5-Hashwert-Abgleich erstellt.
  • inProductShorts – Anspruch auf Shorts oder Synchronisierung
  • inProductStudio – Manuell angemeldeter Anspruch mit Lizenz in YouTube Studio
  • melodyMatch: Der Anspruch wurde durch einen Melodieabgleich generiert.
  • syntheticVocal – Der Anspruch wurde durch einen Anspruch aufgrund von Übereinstimmungen mit Gesangs-Assets ausgelöst.
  • videoMatch: Der Videotrack des Videos, auf das ein Anspruch erhoben wurde, stimmt mit einer Content ID-Referenz überein.
  • youTubeAdmin: Der Anspruch wurde von einem YouTube-Administrator erhoben.

MatchInfo

Stimme die Informationen mit dem Anspruch ab.

JSON-Darstellung 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Felder
matchSegments[]

object (MatchSegment)

Details zu jedem Abgleichssegment. Jedes Element in der Liste enthält Informationen zu einem mit dem Anspruch verknüpften Segment. Es ist möglich, mehrere Abgleichssegmente zu haben. Wenn die Audio- und Videoinhalte eines hochgeladenen Videos beispielsweise mit denen eines Referenzvideos übereinstimmen, gibt es zwei Übereinstimmungssegmente. Ein Segment würde die Audio-Übereinstimmung und das andere die Video-Übereinstimmung beschreiben.
referenceId

string

Die Referenz-ID, die diesen Abgleich ausgelöst hat.
longestMatch

object (LongestMatch)

Details zur längsten Übereinstimmung zwischen der Referenz und dem Nutzer-Video.
totalMatch

object (TotalMatch)

Details zur Gesamtmenge an Referenz- und Nutzerinhalten, die übereinstimmen. Diese beiden Werte können sich unterscheiden, wenn entweder das Referenzvideo oder das Nutzer-Video eine Schleife enthält.

MatchSegment

Informationen zu einem einzelnen übereinstimmenden Segment in einem Anspruch.

JSON-Darstellung 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Felder
video_segment

object (Segment)

Das videoSegment-Objekt enthält Informationen zum übereinstimmenden Teil des Videos, auf das Anspruch erhoben wurde.
reference_segment

object (Segment)

Das referenceSegment-Objekt enthält Informationen zum abgeglichenen Teil des Referenzinhalts.
channel

string

Gibt an, in welcher Form das Video mit Ansprüchen mit dem Referenzvideo übereinstimmt.

Akzeptable Werte sind:

  • Audio
  • Melody
  • Video
manual_segment

object (Segment2)

Beim Einfügen manueller Ansprüche enthält das manualSegment-Objekt Informationen zum spezifischen Teil des Videos, der angeblich übereinstimmt.

Segment

Diese Ressource stellt ein einfaches Segment mit Start- und Endzeit dar, die als „hh:mm:ss.mmm“-String formatiert sind.

JSON-Darstellung 
{
  "start": string,
  "duration": string,
  "kind": string
}
Felder
start

string

Die Startzeit des Segments, gemessen in Millisekunden ab dem Anfang.
duration

string

Die Dauer des Segments in Millisekunden.
kind

string

Der Typ der API-Ressource. Bei Segmentressourcen ist der Wert youtubePartner#segment.

Segment2

Diese Ressource stellt ein weiteres einfaches Segment mit Start- und Endzeit dar, die als „hh:mm:ss.mmm“-String formatiert sind.

JSON-Darstellung 
{
  "start": string,
  "kind": string,
  "finish": string
}
Felder
start

string

Die Startzeit des Segments, gemessen in Millisekunden ab dem Anfang.
kind

string

Der Typ der API-Ressource. Bei Segmentressourcen ist der Wert youtubePartner#segment.
finish

string

Die Endzeit des Segments, gemessen in Millisekunden ab dem Beginn.

LongestMatch

Längste Übereinstimmung mit einem Anspruch.

JSON-Darstellung 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Felder
durationSecs

string

Die Dauer der längsten Übereinstimmung zwischen der Referenz und dem Nutzer-Video.
userVideoOffset

string

Der Offset in Sekunden im Nutzervideo, an dem die längste Übereinstimmung begann.
referenceOffset

string

Der Offset in Sekunden in der Referenz, an dem die längste Übereinstimmung begann.

TotalMatch

Gesamte Übereinstimmung des Anspruchs.

JSON-Darstellung 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Felder
userVideoDurationSecs

string

Die Gesamtmenge an Inhalten im Nutzervideo, die mit der Referenz übereinstimmen, in Sekunden.
referenceDurationSecs

string

Die Gesamtmenge an Inhalten in der Referenz, die mit dem Nutzervideo übereinstimmen, in Sekunden.

Methoden

get

 Ruft eine bestimmte Forderung anhand der ID ab.

insert

 Erstellt einen Anspruch.

list

 Ruft eine Liste der Ansprüche ab, die vom Rechteinhaber verwaltet werden, der mit dem aktuell authentifizierten Nutzer verknüpft ist.

patch

 Aktualisiert einen vorhandenen Anspruch, indem die zugehörige Richtlinie oder der Status geändert wird.

update

 Aktualisiert einen vorhandenen Anspruch, indem die Richtlinie oder der Status geändert wird.