Ressource: Claim
Ein claim
verknüpft ein von Partnern oder Nutzern hochgeladenes Video mit einem Asset, mit dem das Video übereinstimmt. Der Anspruch gibt an, ob das Video mit den Audio-, Video- oder audiovisuellen Komponenten des Inhalts übereinstimmt. Der Anspruch gibt außerdem die Richtlinie an, die YouTube gemäß dem Wunsch des Rechteinhabers auf das Video mit Ansprüchen anwenden soll.
JSON-Darstellung |
---|
{ "kind": string, "policy": { object ( |
Felder | |
---|---|
kind |
Der Typ der API-Ressource. Für Ressourcen vom Typ |
policy |
Richtlinie, die der aufrufende Rechteinhaber für den Anspruch bereitgestellt hat |
timeCreated |
Der Zeitpunkt, zu dem der Anspruch erhoben wurde. |
contentType |
Dieser Wert gibt an, ob der Anspruch die Audio-, Video- oder audiovisuellen Inhalte des beanspruchten Inhalts abdeckt. |
ugcType |
Art des Anspruchs (Standard, Premium, Song) |
isPartnerUploaded |
Gibt an, ob es sich bei dem Anspruch um einen von Partnern hochgeladenen Anspruch handelt. |
timeStatusLastModified |
Der Zeitpunkt, zu dem der Anspruchsstatus und/oder die Statusdetails zuletzt geändert wurden. |
blockOutsideOwnership |
Gibt an, ob das Video mit Ansprüchen überall dort gesperrt werden soll, wo es nicht explizit der Inhaber ist. |
status |
Der Status des Anspruchs. Wenn du einen Anspruch aktualisierst, kannst du seinen Status von |
appliedPolicy |
Die auf den Anspruch angewendete Richtlinie für den aufrufenden Rechteinhaber. Sie stimmt möglicherweise nicht mit der Richtlinie für den endgültigen Anspruch auf das Video überein, da die Richtlinie anderer Partner für denselben Anspruch nicht berücksichtigt wird. |
id |
Die ID, die YouTube zuweist und zur eindeutigen Identifizierung des Anspruchs verwendet. |
assetId |
Die eindeutige YouTube-Inhalts-ID, die den mit dem Anspruch verknüpften Inhalt identifiziert. |
videoId |
Die eindeutige YouTube-Video-ID, die das mit dem Anspruch verknüpfte Video identifiziert. |
origin |
|
matchInfo |
Wenn dieser Anspruch anhand einer angegebenen Referenz automatisch generiert wurde, enthält dieser Abschnitt Details zu der Übereinstimmung, die den Anspruch generiert hat. |
studioInfo |
Enthält URLs, die auf Seiten mit Bezug zu Ansprüchen in Studio verweisen. |
Ursprung
Dieses Objekt enthält Informationen, die die Quelle der Metadaten oder Daten zu Eigentumsrechten beschreiben.
JSON-Darstellung |
---|
{ "source": string } |
Felder | |
---|---|
source |
|
MatchInfo
Übereinstimmungsinformationen zum Anspruch
JSON-Darstellung |
---|
{ "matchSegments": [ { object ( |
Felder | |
---|---|
matchSegments[] |
Details zu den einzelnen übereinstimmenden Segmenten. Jedes Element in der Liste enthält Informationen zu einem übereinstimmenden Segment, das mit dem Anspruch verknüpft ist. Es ist möglich, mehrere Übereinstimmungssegmente zu verwenden. Wenn beispielsweise der Audio- und Videoinhalt eines hochgeladenen Videos mit dem eines Referenzvideos übereinstimmt, gibt es zwei übereinstimmende Segmente. Ein Segment beschreibt die Audioübereinstimmung und das andere die Videoübereinstimmung. |
referenceId |
Die Referenz-ID, die diese Übereinstimmung generiert hat. |
longestMatch |
Details zur längsten Übereinstimmung zwischen der Referenz und dem Nutzervideo |
totalMatch |
Details zum Gesamtumfang der Referenz- und Nutzervideoinhalte, die zueinander passen. Diese beiden Werte können sich unterscheiden, wenn entweder die Referenz oder das Nutzervideo eine Schleife enthält. |
MatchSegment
Informationen zu einem einzelnen übereinstimmenden Segment bei einem Anspruch.
JSON-Darstellung |
---|
{ "video_segment": { object ( |
Felder | |
---|---|
video_segment |
Das |
reference_segment |
Das |
channel |
Gibt an, wie das Video mit Ansprüchen mit dem Referenzvideo übereinstimmt. |
manual_segment |
Beim Einfügen manueller Ansprüche enthält das |
Segment
Diese Ressource stellt ein einfaches Segment dar, bei dem Start- und Endzeit im String „hh:mm:ss.mmm“ formatiert sind.
JSON-Darstellung |
---|
{ "start": string, "duration": string, "kind": string } |
Felder | |
---|---|
start |
Die Startzeit des Segments, gemessen in Millisekunden ab Beginn |
duration |
Die Dauer des Segments in Millisekunden. |
kind |
Der Typ der API-Ressource. Für Segmentressourcen lautet der Wert |
Segment2
Diese Ressource stellt ein weiteres einfaches Segment dar, bei dem Start- und Endzeit im String „hh:mm:ss.mmm“ formatiert sind.
JSON-Darstellung |
---|
{ "start": string, "kind": string, "finish": string } |
Felder | |
---|---|
start |
Die Startzeit des Segments, gemessen in Millisekunden ab Beginn |
kind |
Der Typ der API-Ressource. Für Segmentressourcen lautet der Wert |
finish |
Die Endzeit des Segments, gemessen in Millisekunden ab Beginn. |
LongestMatch
Längste Übereinstimmung mit Ansprüchen.
JSON-Darstellung |
---|
{ "durationSecs": string, "userVideoOffset": string, "referenceOffset": string } |
Felder | |
---|---|
durationSecs |
Die Dauer der längsten Übereinstimmung zwischen der Referenz und dem Nutzervideo. |
userVideoOffset |
Der Offset in Sekunden des Nutzervideos, bei dem die längste Übereinstimmung beginnt. |
referenceOffset |
Der Versatz in Sekunden in der Referenz, an dem die längste Übereinstimmung begonnen hat. |
TotalMatch
Gesamte Übereinstimmung des Anspruchs.
JSON-Darstellung |
---|
{ "userVideoDurationSecs": string, "referenceDurationSecs": string } |
Felder | |
---|---|
userVideoDurationSecs |
Die Gesamtmenge des Contents im Nutzervideo, der mit der Referenz übereinstimmte, in Sekunden. |
referenceDurationSecs |
Die Gesamtmenge des Contents in der Referenz, der dem Nutzervideo in Sekunden entspricht. |
Methoden |
|
---|---|
|
Ruft einen bestimmten Anspruch nach ID ab. |
|
Erstellt einen Anspruch. |
|
Ruft eine Liste der Ansprüche ab, die vom Rechteinhaber verwaltet werden, der mit dem aktuell authentifizierten Nutzer verknüpft ist. |
|
Es wird ein vorhandener Anspruch gepatcht, indem entweder seine Richtlinie oder sein Status geändert wird. |
|
Er kann einen bestehenden Anspruch aktualisieren, indem er entweder seine Richtlinie oder seinen Status ändert. |