REST Resource: claims

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 (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 Ressourcen vom Typ claim ist dieser Wert youtubePartner#claim.

policy

object (Policy)

Richtlinie, die der aufrufende Rechteinhaber für den Anspruch bereitgestellt hat

timeCreated

string

Der Zeitpunkt, zu dem der Anspruch erhoben wurde.

contentType

string

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

ugcType

string

Art des Anspruchs (Standard, Premium, Song)

isPartnerUploaded

boolean

Gibt an, ob es sich bei dem Anspruch um einen von Partnern hochgeladenen Anspruch handelt.

timeStatusLastModified

string

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

blockOutsideOwnership

boolean

Gibt an, ob das Video mit Ansprüchen überall dort gesperrt werden soll, wo es nicht explizit der Inhaber ist.

status

string

Der Status des Anspruchs. Wenn du einen Anspruch aktualisierst, kannst du seinen Status von active zu inactive ändern, um den Anspruch effektiv zurückzuziehen. Die API unterstützt jedoch keine anderen Aktualisierungen des Anspruchsstatus.

appliedPolicy

object (Policy)

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

string

Die ID, die YouTube zuweist und zur eindeutigen Identifizierung des Anspruchs verwendet.

assetId

string

Die eindeutige YouTube-Inhalts-ID, die den mit dem Anspruch verknüpften Inhalt identifiziert.

videoId

string

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

origin

object (Origin)

matchInfo

object (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

object (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

string

MatchInfo

Übereinstimmungsinformationen zum Anspruch

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

object (MatchSegment)

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

string

Die Referenz-ID, die diese Übereinstimmung generiert hat.

longestMatch

object (LongestMatch)

Details zur längsten Übereinstimmung zwischen der Referenz und dem Nutzervideo

totalMatch

object (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 (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Felder
video_segment

object (Segment)

Das videoSegment-Objekt enthält Informationen über den übereinstimmenden Teil des Videos mit Ansprüchen.

reference_segment

object (Segment)

Das referenceSegment-Objekt enthält Informationen über den übereinstimmenden Teil des Referenzinhalts.

channel

string

Gibt an, wie das Video mit Ansprüchen mit dem Referenzvideo übereinstimmt.

manual_segment

object (Segment2)

Beim Einfügen manueller Ansprüche enthält das manualSegment-Objekt Informationen zu dem bestimmten Teil des Videos, der als übereinstimmend gilt.

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

string

Die Startzeit des Segments, gemessen in Millisekunden ab Beginn

duration

string

Die Dauer des Segments in Millisekunden.

kind

string

Der Typ der API-Ressource. Für Segmentressourcen lautet der Wert youtubePartner#segment.

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

string

Die Startzeit des Segments, gemessen in Millisekunden ab Beginn

kind

string

Der Typ der API-Ressource. Für Segmentressourcen lautet der Wert youtubePartner#segment.

finish

string

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

string

Die Dauer der längsten Übereinstimmung zwischen der Referenz und dem Nutzervideo.

userVideoOffset

string

Der Offset in Sekunden des Nutzervideos, bei dem die längste Übereinstimmung beginnt.

referenceOffset

string

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

string

Die Gesamtmenge des Contents im Nutzervideo, der mit der Referenz übereinstimmte, in Sekunden.

referenceDurationSecs

string

Die Gesamtmenge des Contents in der Referenz, der dem Nutzervideo in Sekunden entspricht.

Methoden

get

Ruft einen bestimmten Anspruch nach 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

Es wird ein vorhandener Anspruch gepatcht, indem entweder seine Richtlinie oder sein Status geändert wird.

update

Er kann einen bestehenden Anspruch aktualisieren, indem er entweder seine Richtlinie oder seinen Status ändert.