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 ( |
Pola | |
---|---|
kind |
Typ zasobu interfejsu API. Dla |
policy |
Zasada określona przez właściciela filmu w roszczeniu. |
timeCreated |
Godzina utworzenia roszczenia. |
contentType |
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 |
typ treści generowanych przez użytkowników (standardowe, premium, utwór); |
isPartnerUploaded |
Wskazuje, czy roszczenie jest roszczeniem przesłanym przez partnera. |
timeStatusLastModified |
Czas ostatniej modyfikacji stanu roszczenia lub szczegółów stanu. |
blockOutsideOwnership |
Wskazuje, czy film objęty roszczeniem powinien być zablokowany wszędzie tam, gdzie nie jest jednoznacznie własnością. |
status |
Stan roszczenia. Aktualizując roszczenie, możesz zmienić jego stan z |
appliedPolicy |
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 |
Przypisywany przez YouTube identyfikator używany do jednoznacznego identyfikowania roszczenia. |
assetId |
Unikalny identyfikator zasobu YouTube, który identyfikuje zasób powiązany z roszczeniem. |
videoId |
Unikalny identyfikator filmu YouTube, który identyfikuje film powiązany z roszczeniem. |
origin |
|
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 |
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 |
|
MatchInfo
Dopasuj informacje dotyczące roszczenia.
Zapis JSON |
---|
{ "matchSegments": [ { object ( |
Pola | |
---|---|
matchSegments[] |
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 |
Identyfikator pliku referencyjnego, który wygenerował to dopasowanie. |
longestMatch |
Szczegóły najdłuższego dopasowania między plikiem referencyjnym a filmem użytkownika. |
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 ( |
Pola | |
---|---|
video_segment |
Obiekt |
reference_segment |
Obiekt |
channel |
Określa, w jaki sposób film objęty roszczeniem pasuje do filmu referencyjnego. |
manual_segment |
Podczas wstawiania w ramach ręcznego zgłaszania roszczeń obiekt |
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 |
Czas rozpoczęcia segmentu mierzony w milisekundach od jego początku. |
duration |
Czas trwania segmentu w milisekundach. |
kind |
Typ zasobu interfejsu API. Dla zasobów segmentu wartość wynosi |
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 |
Czas rozpoczęcia segmentu mierzony w milisekundach od jego początku. |
kind |
Typ zasobu interfejsu API. Dla zasobów segmentu wartość wynosi |
finish |
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 |
Czas trwania najdłuższego dopasowania między plikiem referencyjnym a filmem użytkownika. |
userVideoOffset |
Opóźnienie (w sekundach) filmu użytkownika, od którego rozpoczęło się najdłuższe dopasowanie. |
referenceOffset |
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 |
Łączna ilość w sekundach treści wideo użytkownika, które pasowały do pliku referencyjnego. |
referenceDurationSecs |
Łączna ilość (w sekundach) treści w pliku referencyjnym, która pasuje do filmu użytkownika. |
Metody |
|
---|---|
|
Pobiera określone roszczenie na podstawie identyfikatora. |
|
Tworzy roszczenie. |
|
Pobiera listę roszczeń, którymi zarządza właściciel treści powiązany z obecnie uwierzytelnionym użytkownikiem. |
|
Poprawia istniejące roszczenie, zmieniając jego zasadę lub stan. |
|
Aktualizuje istniejące roszczenie, zmieniając jego zasadę lub stan. |