REST Resource: claims

Risorsa: rivendicazione

Un claim collega un video caricato da un partner o da un utente a una risorsa corrispondente al video. La rivendicazione indica se il video corrisponde ai componenti audio, video o audiovisivi (audio e video) della risorsa. La rivendicazione specifica anche la norma che il titolare dei diritti vuole che YouTube applichi al video rivendicato.

Rappresentazione 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)
  }
}
Campi
kind

string

Il tipo di risorsa API. Per claim risorse, questo valore è youtubePartner#claim.

policy

object (Policy)

La norma fornita dal proprietario che ha visualizzato la rivendicazione.

timeCreated

string

L'ora in cui è stata creata la rivendicazione.

contentType

string

Questo valore indica se la rivendicazione riguarda la parte audio, video o audiovisiva dei contenuti rivendicati.

ugcType

string

Il tipo di contenuti generati dagli utenti della rivendicazione (standard, premium, brano).

isPartnerUploaded

boolean

Indica se la rivendicazione è un reclamo caricato da un partner.

timeStatusLastModified

string

L'ultima modifica dello stato e/o dello stato della rivendicazione.

blockOutsideOwnership

boolean

Indica se il video rivendicato deve essere bloccato ovunque non sia di sua proprietà esplicita.

status

string

Lo stato della rivendicazione. Quando aggiorni una rivendicazione, puoi aggiornarne lo stato da active a inactive per ritirarla in modo efficace, ma l'API non supporta altri aggiornamenti dello stato della rivendicazione.

appliedPolicy

object (Policy)

La norma applicata per il proprietario che ha visualizzato la rivendicazione. Questa norma potrebbe non essere uguale alla norma per la rivendicazione finale del video, in quanto non tiene conto della stessa norma di altri partner relativa alla rivendicazione.

id

string

L'ID assegnato e utilizzato da YouTube per identificare in modo univoco la rivendicazione.

assetId

string

L'ID risorsa di YouTube univoco che identifica la risorsa associata alla rivendicazione.

videoId

string

L'ID video univoco di YouTube che identifica il video associato alla rivendicazione.

origin

object (Origin)

matchInfo

object (MatchInfo)

Se questa rivendicazione è stata generata automaticamente sulla base di un riferimento fornito, questa sezione fornirà i dettagli della corrispondenza che ha generato la rivendicazione.

studioInfo

object (StudioInfo)

Contiene URL che rimandano a pagine correlate alle rivendicazioni in Studio.

Origin

Questo oggetto contiene informazioni che descrivono l'origine dei metadati o dei dati di proprietà.

Rappresentazione JSON
{
  "source": string
}
Campi
source

string

MatchInfo

Informazioni sulla corrispondenza della rivendicazione.

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

object (MatchSegment)

Dettagli su ciascun segmento di corrispondenza. Ogni voce dell'elenco contiene informazioni su un segmento di corrispondenza associato alla rivendicazione. È possibile avere più segmenti con corrispondenza. Ad esempio, se i contenuti audio e video di un video caricato corrispondono a quelli di un video di riferimento, vengono generati due segmenti con corrispondenza. Un segmento descrive la corrispondenza audio e l'altro la corrispondenza video.

referenceId

string

L'ID riferimento che ha generato questa corrispondenza.

longestMatch

object (LongestMatch)

Dettagli della corrispondenza più lunga tra il riferimento e il video dell'utente.

totalMatch

object (TotalMatch)

Dettagli della quantità totale di contenuti video di riferimento e di contenuti video degli utenti corrispondenti. Tieni presente che questi due valori possono variare se il riferimento o il video dell'utente contiene un loop.

MatchSegment

Informazioni su un singolo segmento di corrispondenza in una rivendicazione.

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

object (Segment)

L'oggetto videoSegment contiene informazioni sulla parte corrispondente del video rivendicato.

reference_segment

object (Segment)

L'oggetto referenceSegment contiene informazioni sulla parte corrispondente dei contenuti di riferimento.

channel

string

Identifica il modo in cui il video rivendicato corrisponde al video di riferimento.

manual_segment

object (Segment2)

Durante l'inserimento delle rivendicazioni manuali, l'oggetto manualSegment contiene informazioni sulla parte specifica del video che si ritiene corrisponda.

Segmento

Questa risorsa rappresenta un segmento semplice le cui ore di inizio e fine sono formattate come stringa "hh:mm:ss.mmm".

Rappresentazione JSON
{
  "start": string,
  "duration": string,
  "kind": string
}
Campi
start

string

L'ora di inizio del segmento, misurata in millisecondi dall'inizio.

duration

string

La durata del segmento in millisecondi.

kind

string

Il tipo di risorsa API. Per le risorse del segmento, il valore è youtubePartner#segment.

Segment2

Questa risorsa rappresenta un altro segmento semplice le cui ore di inizio e fine sono formattate come stringa "hh:mm:ss.mmm".

Rappresentazione JSON
{
  "start": string,
  "kind": string,
  "finish": string
}
Campi
start

string

L'ora di inizio del segmento, misurata in millisecondi dall'inizio.

kind

string

Il tipo di risorsa API. Per le risorse del segmento, il valore è youtubePartner#segment.

finish

string

L'ora di fine del segmento, misurata in millisecondi dall'inizio.

LongestMatch

Corrispondenza della rivendicazione più lunga.

Rappresentazione JSON
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Campi
durationSecs

string

La durata della corrispondenza più lunga tra il riferimento e il video dell'utente.

userVideoOffset

string

Lo scarto in secondi nel video dell'utente in cui è iniziata la corrispondenza più lunga.

referenceOffset

string

L'offset in secondi nel riferimento da cui è iniziata la corrispondenza più lunga.

TotalMatch

Corrispondenza totale rivendicazione.

Rappresentazione JSON
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Campi
userVideoDurationSecs

string

La quantità totale di contenuti nel video dell'utente corrispondenti al riferimento, in secondi.

referenceDurationSecs

string

La quantità totale di contenuti nel riferimento corrispondenti al video dell'utente, espressa in secondi.

Metodi

get

Recupera una rivendicazione specifica in base all'ID.

insert

Crea una rivendicazione.

list

Recupera un elenco di rivendicazioni gestite dal proprietario dei contenuti associati all'utente attualmente autenticato.

patch

Corregge una rivendicazione esistente modificando la norma o lo stato.

update

Consente di aggiornare una rivendicazione esistente modificando la norma o lo stato.