REST Resource: references

Recurso: Reference

A referência representa o conteúdo real de um recurso. O YouTube compara vídeos recém-enviados a uma biblioteca de referências com a finalidade de gerar automaticamente reivindicações para o(s) proprietário(s) do recurso.

Representação JSON 
{
  "kind": string,
  "status": string,
  "statusReason": string,
  "length": number,
  "hashCode": string,
  "urgent": boolean,
  "fpDirect": boolean,
  "contentType": string,
  "audioswapEnabled": boolean,
  "ignoreFpMatch": boolean,
  "origination": {
    object (Origination)
  },
  "excludedIntervals": [
    {
      object (ExcludedInterval)
    }
  ],
  "id": string,
  "assetId": string,
  "duplicateLeader": string,
  "claimId": string,
  "videoId": string
}
Campos
kind

string

O tipo do recurso da API. Para recursos reference, o valor é youtubePartner#reference.
status

string

O status da referência. Os valores aceitáveis são:

  • activating: a referência está com ativação pendente.
  • active: a referência está ativa e correspondendo ativamente.
  • checking: a referência está sendo comparada com as referências atuais para identificar conflitos.
  • checking_quota: a referência está aguardando a verificação da cota.
  • computing_fingerprint: a impressão digital da referência está sendo calculada.
  • deactivating: a referência está em processo de desativação.
  • deleted: a referência foi excluída.
  • inactive: a referência está inativa.
  • live_streaming_processing: a referência está sendo processada de uma transmissão de vídeo ao vivo.
statusReason

string

Uma explicação de como uma referência entrou no estado atual. Esse valor só vai estar presente se o status da referência for inactive ou deleted. Os valores aceitáveis são:

  • ACTIVATION_QUOTA_EXCEEDED - A cota de ativação foi excedida.
  • ALMOST_ENTIRELY_EXCLUDED: a referência é quase totalmente excluída.
  • ASSET_MERGE_FAILED: a referência ficou inativa devido a uma falha na combinação de recursos.
  • BATCH: falha no processamento durante a ingestão em lote.
  • BULK_UPDATER: o status foi atualizado pelo atualizador em massa.
  • CLAIM_DISABLED_FOR_MATCHING: a correspondência foi desativada na reivindicação.
  • CLOSED_BY_OWNER: fechado pelo proprietário do recurso.
  • DUPLICATE_FOR_OWNERS: a referência duplica outra referência do mesmo proprietário.
  • ERROR_DURING_ACTIVATION: ocorreu um erro durante a ativação.
  • INSUFFICIENT_LENGTH: o comprimento da referência é insuficiente para a criação de impressões digitais.
  • NON_PERFORMING: a referência foi desativada devido ao não-cumprimento.
  • PROCESSING_FAILED: falha na ingestão ou no processamento da referência.
  • PROCESSING_QUOTA_EXCEEDED - A cota de processamento foi excedida.
  • REFERENCE_WAS_REMOVED: o arquivo de referência da fonte foi removido.
  • USER_WAS_REMOVED: a conta de usuário foi removida.
  • VIDEO_WAS_REMOVED: o vídeo de origem foi removido.
  • VIDEO_WIPED_OUT - O vídeo foi excluído ou apagado.
length

number

A duração da referência em segundos.
hashCode

string

O hashcode MD5 do conteúdo de referência. Descontinuado. Esse campo não é mais preenchido.
urgent

boolean

Defina esse valor como true para indicar que o YouTube deve priorizar o processamento do Content ID para um arquivo de vídeo. O YouTube processa arquivos de vídeo urgentes antes de outros arquivos não marcados como urgentes. Essa configuração é usada principalmente para vídeos de eventos ao vivo ou outros vídeos que demandam processamento rápido. O quanto antes o YouTube concluir o processamento de Content ID de um vídeo, mais antecipadamente o YouTube poderá corresponder vídeos enviados por um usuário a esse vídeo.

Marcar todos os arquivos como urgentes pode atrasar o processamento deles.
fpDirect

boolean

Ao fazer upload de uma referência, defina esse valor como true para indicar que ela é uma impressão digital pré-gerada.
contentType

string

O tipo de conteúdo que a referência representa.

Os valores aceitáveis são:

  • audio
  • audiovisual
  • video
audioswapEnabled

boolean

Defina o valor desse campo como true para indicar que o conteúdo de referência deve ser incluído no programa AudioSwap do YouTube.
ignoreFpMatch

boolean

Defina esse valor como true para indicar que a referência não deve ser usada para gerar declarações. Esse campo é usado apenas em referências do AudioSwap.
origination

object (Origination)

O objeto origination contém informações que descrevem a fonte de referência.
excludedIntervals[]

object (ExcludedInterval)

A lista de intervalos de tempo dessa referência que serão ignorados durante o processo de correspondência.
id

string

Um valor que o YouTube atribui e usa para identificar uma referência de forma exclusiva.
assetId

string

O ID que identifica exclusivamente o recurso associado à referência.
duplicateLeader

string

O ID que identifica exclusivamente a referência duplicada. Esse campo só está presente se o status da referência for inactive com o motivo REASON_DUPLICATE_FOR_OWNERS.
claimId

string

Esse campo aparece se a referência foi criada associando um recurso a um vídeo do YouTube enviado a um canal do YouTube vinculado à sua conta do CMS. Nesse caso, esse campo contém o ID da reivindicação que representa a associação resultante entre o recurso e o vídeo.
videoId

string

Esse campo aparece se a referência foi criada associando um recurso a um vídeo do YouTube enviado a um canal do YouTube vinculado à sua conta do CMS. Nesse caso, esse campo contém o ID do vídeo de origem.

ExcludedInterval

Define um período na referência que será ignorado durante o processo de correspondência.

Representação JSON 
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
Campos
low

number

O horário de início (inclusivo) em segundos do período. O valor pode ser qualquer valor entre 0 e high. Todo intervalo precisa especificar um valor para esse campo.
high

number

O horário de término (inclusivo) em segundos do período. O valor pode ser qualquer valor maior que low. Se high for maior que o comprimento da referência, o intervalo entre low e o final da referência será excluído. Todo intervalo precisa especificar um valor para esse campo.
origin

string

A origem da solicitação para excluir o intervalo da correspondência do Content ID. Os valores aceitáveis são:

  • content_id_api: o intervalo excluído foi criado manualmente usando a API Content ID.
  • content_manager: o intervalo excluído foi criado no YouTube Studio ou no Gerenciador de conteúdo.
  • ingestion: o intervalo excluído foi especificado em um feed de conteúdo enviado.
  • invalid_segment: o segmento na referência é inválido para correspondência.
  • permanent_exclusion: o segmento foi identificado pelo YouTube como inválido para correspondência.
  • reference_conflict: o intervalo excluído surgiu de um conflito de referência.
  • unknown: a origem da exclusão é desconhecida.
timeCreated

string

A data e a hora em que a exclusão foi criada. O valor é especificado no formato RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

Métodos

get

 Recupera informações sobre a referência especificada.

insert

Cria uma referência por meio de uma das seguintes maneiras:

  • Se sua solicitação estiver enviando um arquivo de referência, o YouTube criará a referência a partir do conteúdo fornecido.

list

 Recupera uma lista de referências por ID ou a lista de referências para o recurso especificado.

patch

 Adiciona patches a uma referência.

update

 Atualiza uma referência.