REST Resource: references

Recurso: Reference

Una referencia representa el contenido real de un elemento. YouTube compara los videos subidos recientemente con una biblioteca de referencias con el propósito de generar reclamos automáticamente a nombre del propietario de un elemento.

Representación 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

Tipo de recurso de la API. Para los recursos reference, el valor es youtubePartner#reference.
status

string

Es el estado de la referencia. Los valores aceptables son:

  • activating: La referencia está pendiente de activación.
  • active: La referencia está activa y coincide de forma activa.
  • checking: Se compara la referencia con las referencias existentes para identificar conflictos.
  • checking_quota: La referencia está en espera de la verificación de la cuota.
  • computing_fingerprint: Se está calculando la huella digital de la referencia.
  • deactivating: La referencia está en proceso de desactivación.
  • deleted: Se borró la referencia.
  • inactive: La referencia está inactiva.
  • live_streaming_processing: La referencia se está procesando a partir de una transmisión de video en vivo.
statusReason

string

Es una explicación de cómo una referencia llegó a su estado actual. Este valor solo está presente si el estado de la referencia es inactive o deleted. Los valores aceptables son los siguientes:

  • ACTIVATION_QUOTA_EXCEEDED: Se superó la cuota de activación.
  • ALMOST_ENTIRELY_EXCLUDED: La referencia está excluida casi por completo.
  • ASSET_MERGE_FAILED: La referencia se inhabilitó debido a un error en la combinación de activos.
  • BATCH: Se produjo un error durante la transferencia masiva.
  • BULK_UPDATER: El actualizador masivo actualizó el estado.
  • CLAIM_DISABLED_FOR_MATCHING: Se inhabilitó la coincidencia en el reclamo.
  • CLOSED_BY_OWNER: El propietario del activo cerró el caso.
  • DUPLICATE_FOR_OWNERS: La referencia duplica otra referencia del mismo propietario.
  • ERROR_DURING_ACTIVATION: Se produjo un error durante la activación.
  • INSUFFICIENT_LENGTH: La longitud de referencia no es suficiente para la huella digital.
  • NON_PERFORMING: Se desactivó la referencia debido a incumplimiento.
  • PROCESSING_FAILED: Se produjo un error en la transferencia o el procesamiento de la referencia.
  • PROCESSING_QUOTA_EXCEEDED: Se superó la cuota de procesamiento.
  • REFERENCE_WAS_REMOVED: Se quitó el archivo de referencia de la fuente.
  • USER_WAS_REMOVED: Se quitó la cuenta de usuario.
  • VIDEO_WAS_REMOVED: Se quitó el video fuente.
  • VIDEO_WIPED_OUT: Se borró o quitó el video.
length

number

Es la duración de la referencia en segundos.
hashCode

string

Es el código hash MD5 del contenido de referencia. ¡Obsoleto! Este campo ya no se propaga.
urgent

boolean

Establece este valor en true para indicar que YouTube debe priorizar el procesamiento de Content ID para un archivo de video. YouTube procesa los archivos de video urgentes antes que otros archivos que no están marcados como tal. Esta configuración se usa principalmente en videos de eventos en vivo u otros videos que se deben procesar rápidamente. Mientras antes complete YouTube el procesamiento de Content ID para un video, más rápidamente podrá buscar coincidencias en videos subidos por otros usuarios.

Si marcas todos tus archivos como urgentes, es posible que se retrase el procesamiento de esos archivos.
fpDirect

boolean

Cuando subas una referencia, establece este valor en true para indicar que la referencia es una huella digital generada previamente.
contentType

string

Es el tipo de contenido que representa la referencia.

Los valores aceptables son:

  • audio
  • audiovisual
  • video
audioswapEnabled

boolean

Establece el valor de este campo en true para indicar que el contenido de referencia se debe incluir en el programa AudioSwap de YouTube.
ignoreFpMatch

boolean

Establece este valor en true para indicar que no se debe usar la referencia para generar reclamos. Este campo solo se usa en las referencias de AudioSwap.
origination

object (Origination)

El objeto origination contiene información que describe la fuente de referencia.
excludedIntervals[]

object (ExcludedInterval)

Es la lista de intervalos de tiempo de esta referencia que se ignorarán durante el proceso de coincidencia.
id

string

Es un valor que YouTube asigna y usa para identificar de forma única una referencia.
assetId

string

Es el ID que identifica de forma única el activo con el que se asocia la referencia.
duplicateLeader

string

Es el ID que identifica de forma única la referencia que duplica esta referencia. Este campo solo está presente si el estado de la referencia es inactive con el motivo REASON_DUPLICATE_FOR_OWNERS.
claimId

string

Este campo está presente si la referencia se creó asociando un activo a un video existente de YouTube que se subió a un canal de YouTube vinculado a tu cuenta de CMS. En ese caso, este campo contiene el ID del reclamo que representa la asociación resultante entre el activo y el video.
videoId

string

Este campo está presente si la referencia se creó asociando un activo a un video existente de YouTube que se subió a un canal de YouTube vinculado a tu cuenta de CMS. En ese caso, este campo contiene el ID del video fuente.

ExcludedInterval

Define un período dentro de la referencia que se ignorará durante el proceso de coincidencia.

Representación JSON 
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
Campos
low

number

Es la hora de inicio (inclusive) en segundos del período. El valor puede ser cualquiera entre 0 y high. Cada intervalo debe especificar un valor para este campo.
high

number

Es la hora de finalización (inclusive) en segundos del período. El valor puede ser cualquier valor superior a low. Si high es mayor que la longitud de la referencia, se excluirá el intervalo entre low y el final de la referencia. Cada intervalo debe especificar un valor para este campo.
origin

string

Es la fuente de la solicitud para excluir el intervalo de la búsqueda de coincidencias de Content ID. Los valores aceptables son:

  • content_id_api: El intervalo excluido se creó de forma manual con la API de Content ID.
  • content_manager: El intervalo excluido se creó en YouTube Studio o en el Administrador de contenido.
  • ingestion: El intervalo excluido se especificó en un feed de contenido subido.
  • invalid_segment: El segmento de la referencia no es válido para la correlación.
  • permanent_exclusion: YouTube identificó que el segmento no es válido para la correlación.
  • reference_conflict: El intervalo excluido se originó a partir de un conflicto de referencia.
  • unknown: Se desconoce la fuente de exclusión.
timeCreated

string

Fecha y hora en que se creó la exclusión. El valor se especifica en formato RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

Métodos

get

 Recupera información sobre la referencia especificada.

insert

Crea una referencia de una de las siguientes formas:

  • Si tu solicitud implica subir un archivo de referencia, YouTube crea la referencia a partir del contenido proporcionado.

list

 Recupera una lista de referencias según su ID o la lista de referencias del elemento especificado.

patch

 Aplica parches a una referencia.

update

 Actualiza una referencia.