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 detentor 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 que visualiza a reivindicação.

timeCreated

string

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

contentType

string

Este 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 é enviada ou não por um parceiro.

timeStatusLastModified

string

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

blockOutsideOwnership

boolean

Indica se o vídeo reivindicado deve ser bloqueado em qualquer lugar que não seja de sua propriedade explícita.

status

string

O status da reivindicação. Ao atualizar uma reivindicação, você pode atualizar o status de active para inactive para liberar a reivindicação efetivamente. No entanto, a API não oferece suporte a outras atualizações do status de uma reivindicação.

appliedPolicy

object (Policy)

A política aplicada para o proprietário que visualiza a reivindicação. Talvez ela não seja igual à política de reivindicação final do vídeo, porque não considera a política de outros parceiros sobre a 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)

Caso essa reivindicação tenha sido 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 com links para páginas relacionadas à reivindicação 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

Faça a correspondência das informações sobre a declaraçã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 da 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 descreve a correspondência de áudio e o outro descreve a correspondência de vídeo.

referenceId

string

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

longestMatch

object (LongestMatch)

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

totalMatch

object (TotalMatch)

Detalhes da quantidade total de conteúdo de referência e de vídeo do usuário que corresponderam entre si. Esses dois valores podem diferir se a referência ou o vídeo do usuário tiver 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 uma string "hh:mm:ss.mmm".

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

string

É o horário de início do segmento, medido em milissegundos a partir do 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

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

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

string

É o horário de início do segmento, medido em milissegundos a partir do 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 a partir do início.

LongestMatch

Correspondência de reivindicação mais longa.

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 no vídeo do usuário em que a maior correspondência começou.

referenceOffset

string

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

TotalMatch

Total de correspondências 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 corresponde 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.