REST Resource: claims

Recurso: Claim

Um claim vincula um vídeo enviado por um parceiro ou usuário a um recurso correspondente ao vídeo. A reivindicação indica se o vídeo corresponde aos componentes de áudio, vídeo ou audiovisuais (áudio e vídeo) do recurso. A reivindicação também especifica a política que o proprietário dos direitos quer que o YouTube aplique ao vídeo reivindicado.

Representação 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)
  }
}
Campos
kind

string

O tipo do recurso da API. Para recursos claim, esse valor é youtubePartner#claim.
policy

object (Policy)

A política fornecida pelo proprietário da visualização na reivindicação.
timeCreated

string

A hora em que a reivindicação foi criada.
contentType

string

Esse valor indica se a reivindicação abrange a parte de áudio, vídeo ou audiovisual do conteúdo reivindicado.
ugcType

string

Tipo de UGC (Conteúdo gerado pelo usuário) da reivindicação (padrão, premium, música).
isPartnerUploaded

boolean

Indica se a reivindicação é ou não enviada por um parceiro.
timeStatusLastModified

string

A hora em que o status e/ou os detalhes do status da reivindicação foram modificados pela última vez.
blockOutsideOwnership

boolean

Indica se o vídeo reivindicado deve ser bloqueado em qualquer lugar ao qual não pertence explicitamente.
status

string

O status da reivindicação. Ao atualizar uma declaração, é possível atualizar o status dela de active para inactive, a fim de liberar a reivindicação efetivamente. No entanto, a API não oferece suporte a outras atualizações do status de uma declaração.
appliedPolicy

object (Policy)

A política aplicada para o proprietário da visualização na reivindicação. Esta pode não ser igual à política de reivindicação final do vídeo, já que não considera o política da mesma reivindicação.
id

string

O ID que o YouTube atribui e usa para identificar de forma exclusiva a reivindicação.
assetId

string

O ID exclusivo do recurso do YouTube que identifica o recurso associado à reivindicação.
videoId

string

O ID exclusivo do vídeo do YouTube que identifica o vídeo associado à reivindicação.
origin

object (Origin)
matchInfo

object (MatchInfo)

Se esta reivindicação foi gerada automaticamente com base em uma referência fornecida, esta seção fornecerá detalhes da correspondência que gerou a reivindicação.
studioInfo

object (StudioInfo)

Contém URLs que direcionam para páginas relacionadas a reivindicações no Studio.

Origem

Esse objeto contém informações que descrevem a origem dos metadados ou dos dados de propriedade.

Representação JSON 
{
  "source": string
}
Campos
source

string

MatchInfo

Informações de correspondência sobre a reivindicação.

Representação JSON 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Campos
matchSegments[]

object (MatchSegment)

Detalhes sobre cada segmento de correspondência. Cada item na lista contém informações sobre um segmento de correspondência associado à reivindicação. É possível ter vários segmentos de correspondência. Por exemplo, se o conteúdo de áudio e vídeo de um vídeo enviado corresponder ao de um vídeo de referência, haverá dois segmentos de correspondência. Um segmento descreveria a correspondência de áudio e o outro descreveria a correspondência de vídeo.
referenceId

string

O ID de referência que gerou essa correspondência.
longestMatch

object (LongestMatch)

Detalhes da correspondência mais longa entre a referência e o vídeo do usuário.
totalMatch

object (TotalMatch)

Detalhes da quantidade total de referências e conteúdo de vídeo do usuário correspondentes. Esses dois valores poderão ser diferentes se a referência ou o vídeo do usuário tiverem um loop.

MatchSegment

Informações sobre um único segmento de correspondência em uma reivindicação.

Representação JSON 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Campos
video_segment

object (Segment)

O objeto videoSegment contém informações sobre a parte correspondente do vídeo reivindicado.
reference_segment

object (Segment)

O objeto referenceSegment contém informações sobre a parte correspondente do conteúdo de referência.
channel

string

Identifica a maneira como o vídeo reivindicado corresponde ao vídeo de referência.
manual_segment

object (Segment2)

Na operação de inserção de reivindicações manuais, o objeto manualSegment contém informações sobre a parte específica do vídeo que supostamente corresponde.

Segmento

Esse recurso representa um segmento simples com horário de início e término formatado como "hh:mm:ss.mmm" fio.

Representação JSON 
{
  "start": string,
  "duration": string,
  "kind": string
}
Campos
start

string

O horário de início do segmento, medido em milissegundos desde o início.
duration

string

A duração do segmento em milissegundos.
kind

string

O tipo do recurso da API. Para recursos de segmento, o valor é youtubePartner#segment.

Segment2

Este recurso representa outro segmento simples com horário de início e término formatado como "hh:mm:ss.mmm" fio.

Representação JSON 
{
  "start": string,
  "kind": string,
  "finish": string
}
Campos
start

string

O horário de início do segmento, medido em milissegundos desde o início.
kind

string

O tipo do recurso da API. Para recursos de segmento, o valor é youtubePartner#segment.
finish

string

O horário de término do segmento, medido em milissegundos desde o início.

LongestMatch

Maior correspondência de reivindicação.

Representação JSON 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Campos
durationSecs

string

A duração da correspondência mais longa entre a referência e o vídeo do usuário.
userVideoOffset

string

O deslocamento em segundos do vídeo do usuário em que a correspondência mais longa começou.
referenceOffset

string

O deslocamento em segundos na referência em que a correspondência mais longa começou.

TotalMatch

Correspondência total da reivindicação.

Representação JSON 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Campos
userVideoDurationSecs

string

A quantidade total de conteúdo no vídeo do usuário que corresponde à referência em segundos.
referenceDurationSecs

string

A quantidade total de conteúdo na referência que correspondeu ao vídeo do usuário em segundos.

Métodos

get

 Recupera uma reivindicação específica por ID.

insert

 Cria uma reivindicação.

list

 Recupera uma lista de reivindicações administradas pelo proprietário do conteúdo associada com o usuário autenticado no momento.

patch

 Corrige uma reivindicação existente alterando a política ou o status dela.

update

 Atualiza uma reivindicação existente, atualizando sua política ou seu status.