REST Resource: claims

Zasób: Claim

Element claim łączy film przesłany przez partnera lub użytkownika z zasobem, do którego pasuje ten film. Z roszczeniem wynika, czy film został dopasowany do komponentu audio, wideo czy audiowizualnego (audio i wideo) zasobu. W roszczeniu jest również określone zasady, które właściciel praw ma zastosować do filmu objętego roszczeniem.

Zapis JSON
{
  "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)
  }
}
Pola
kind

string

Typ zasobu interfejsu API. Dla claim zasobów ta wartość wynosi youtubePartner#claim.

policy

object (Policy)

Zasada określona przez właściciela filmu w roszczeniu.

timeCreated

string

Godzina utworzenia roszczenia.

contentType

string

Ta wartość określa, czy roszczenie obejmuje dźwięk, film czy ścieżkę audiowizualną w treści, do której zgłoszono roszczenie.

ugcType

string

typ treści generowanych przez użytkowników (standardowe, premium, utwór);

isPartnerUploaded

boolean

Wskazuje, czy roszczenie jest roszczeniem przesłanym przez partnera.

timeStatusLastModified

string

Czas ostatniej modyfikacji stanu roszczenia lub szczegółów stanu.

blockOutsideOwnership

boolean

Wskazuje, czy film objęty roszczeniem powinien być zablokowany wszędzie tam, gdzie nie jest jednoznacznie własnością.

status

string

Stan roszczenia. Aktualizując roszczenie, możesz zmienić jego stan z active na inactive, aby skutecznie je wycofać. Interfejs API nie obsługuje jednak innych aktualizacji stanu roszczenia.

appliedPolicy

object (Policy)

Zasada zastosowana do właściciela widoku i do roszczenia. Może to być inne niż ostateczna zasada dotycząca roszczenia do tego filmu, ponieważ nie uwzględnia zasad innych partnerów dotyczących tego samego roszczenia.

id

string

Przypisywany przez YouTube identyfikator używany do jednoznacznego identyfikowania roszczenia.

assetId

string

Unikalny identyfikator zasobu YouTube, który identyfikuje zasób powiązany z roszczeniem.

videoId

string

Unikalny identyfikator filmu YouTube, który identyfikuje film powiązany z roszczeniem.

origin

object (Origin)

matchInfo

object (MatchInfo)

Jeśli to roszczenie zostało wygenerowane automatycznie na podstawie podanego pliku referencyjnego, ta sekcja będzie zawierać szczegółowe informacje na temat dopasowania, które doprowadziło do jego wygenerowania.

studioInfo

object (StudioInfo)

Zawiera adresy URL z linkami do stron związanych z roszczeniami w Studio.

Punkt początkowy

Ten obiekt zawiera informacje opisujące źródło metadanych lub danych o własności.

Zapis JSON
{
  "source": string
}
Pola
source

string

MatchInfo

Dopasuj informacje dotyczące roszczenia.

Zapis JSON
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Pola
matchSegments[]

object (MatchSegment)

Szczegółowe informacje o każdym segmencie dopasowania. Każda pozycja na liście zawiera informacje o jednym segmencie dopasowania powiązanym z roszczeniem. Możesz mieć wiele segmentów dopasowania. Jeśli na przykład dźwięk i treść wideo przesłanego filmu odpowiadają treści filmu referencyjnego, zostaną rozróżnione dwa segmenty dopasowania. Jeden segment opisuje dopasowanie audio, a drugi – dopasowanie wideo.

referenceId

string

Identyfikator pliku referencyjnego, który wygenerował to dopasowanie.

longestMatch

object (LongestMatch)

Szczegóły najdłuższego dopasowania między plikiem referencyjnym a filmem użytkownika.

totalMatch

object (TotalMatch)

Szczegółowa ilość dopasowanych treści wideo użytkowników i plików referencyjnych. Pamiętaj, że te 2 wartości mogą się różnić, jeśli plik referencyjny lub film użytkownika zawiera pętlę.

MatchSegment

Informacje o pojedynczym segmencie dopasowania w roszczeniu.

Zapis JSON
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Pola
video_segment

object (Segment)

Obiekt videoSegment zawiera informacje o dopasowanej części filmu objętego roszczeniem.

reference_segment

object (Segment)

Obiekt referenceSegment zawiera informacje o dopasowanej części treści referencyjnej.

channel

string

Określa, w jaki sposób film objęty roszczeniem pasuje do filmu referencyjnego.

manual_segment

object (Segment2)

Podczas wstawiania w ramach ręcznego zgłaszania roszczeń obiekt manualSegment zawiera informacje o konkretnej części filmu, która została objęta roszczeniem.

Podział

Ten zasób reprezentuje prosty segment z czasem rozpoczęcia i zakończenia w formacie ciągu „gg:mm:ss.mmm”.

Zapis JSON
{
  "start": string,
  "duration": string,
  "kind": string
}
Pola
start

string

Czas rozpoczęcia segmentu mierzony w milisekundach od jego początku.

duration

string

Czas trwania segmentu w milisekundach.

kind

string

Typ zasobu interfejsu API. Dla zasobów segmentu wartość wynosi youtubePartner#segment.

Segment2

Ten zasób reprezentuje kolejny prosty segment z czasem rozpoczęcia i zakończenia w formacie ciągu „gg:mm:ss.mmm”.

Zapis JSON
{
  "start": string,
  "kind": string,
  "finish": string
}
Pola
start

string

Czas rozpoczęcia segmentu mierzony w milisekundach od jego początku.

kind

string

Typ zasobu interfejsu API. Dla zasobów segmentu wartość wynosi youtubePartner#segment.

finish

string

Czas zakończenia segmentu (w milisekundach od jego początku).

LongestMatch

Najdłuższe dopasowanie roszczenia.

Zapis JSON
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Pola
durationSecs

string

Czas trwania najdłuższego dopasowania między plikiem referencyjnym a filmem użytkownika.

userVideoOffset

string

Opóźnienie (w sekundach) filmu użytkownika, od którego rozpoczęło się najdłuższe dopasowanie.

referenceOffset

string

Przesunięcie (w sekundach) do pliku referencyjnego, od którego rozpoczęło się najdłuższe dopasowanie.

TotalMatch

Łączna liczba pasujących roszczeń.

Zapis JSON
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Pola
userVideoDurationSecs

string

Łączna ilość w sekundach treści wideo użytkownika, które pasowały do pliku referencyjnego.

referenceDurationSecs

string

Łączna ilość (w sekundach) treści w pliku referencyjnym, która pasuje do filmu użytkownika.

Metody

get

Pobiera określone roszczenie na podstawie identyfikatora.

insert

Tworzy roszczenie.

list

Pobiera listę roszczeń, którymi zarządza właściciel treści powiązany z obecnie uwierzytelnionym użytkownikiem.

patch

Poprawia istniejące roszczenie, zmieniając jego zasadę lub stan.

update

Aktualizuje istniejące roszczenie, zmieniając jego zasadę lub stan.