REST Resource: claims

Recurso: Claim

Un claim vincula un video subido por un socio o un usuario a un activo con el que coincide el video. El reclamo indica si el video coincide con los componentes de audio, video o audiovisuales (audio y video) del activo. El reclamo también especifica la política que el propietario de los derechos quiere que YouTube aplique al video reclamado.

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

Tipo de recurso de la API. Para los recursos claim, este valor es youtubePartner#claim.
policy

object (Policy)

Es la política que proporcionó el propietario del contenido en el reclamo.
timeCreated

string

Es la fecha y hora en que se creó el reclamo.
contentType

string

Este valor indica si el reclamo abarca la parte de audio, video o audiovisual del contenido reclamado.

Los valores aceptables son:

  • audio
  • audiovisual
  • video
ugcType

string

Es el tipo de contenido generado por usuarios del reclamo.

Los valores aceptables son:

  • premium
  • song
  • standard
isPartnerUploaded

boolean

Indica si el reclamo es ocasionado por una carga del socio.
timeStatusLastModified

string

Fecha y hora en que se modificó por última vez el estado del reclamo o el detalle del estado.
blockOutsideOwnership

boolean

Indica si el video reclamado debe bloquearse en cualquier lugar en el que no se posea explícitamente.
status

string

Es el estado del reclamo.

Los valores aceptables son:

  • active: El reclamo está activo y se están aplicando las políticas.
  • appealed: El usuario apeló una impugnación rechazada.
  • disputed: El usuario impugnó el reclamo.
  • inactive: El reclamo está inactivo.
  • manual_review: La política envía el reclamo a revisión manual.
  • pending: El reclamo está pendiente de revisión o procesamiento.
  • potential: El reclamo es una posible coincidencia que está a la espera de confirmación.
  • takedown: Se quitó el video reclamado.

Cuando actualices un reclamo, puedes cambiar su estado de active a inactive para liberarlo de forma efectiva. Si el propietario del contenido tiene los permisos adecuados, la API también admite la actualización del estado a active desde inactive (cuando se restablece un reclamo sin problemas de Studio) o potential (cuando se confirma un reclamo potencial). Los reclamos en disputa no se pueden restablecer a través de la API, sino que requieren una revisión en YouTube Studio.
appliedPolicy

object (Policy)

Es la política aplicada al propietario del contenido que se visualiza en el reclamo. Es posible que no sea la misma que la política de reclamo final del video, ya que no tiene en cuenta la política de otros socios del mismo reclamo.
id

string

Es el ID que YouTube asigna y usa para identificar de forma única el reclamo.
assetId

string

Es el ID único del activo de YouTube que identifica el activo asociado con el reclamo.
videoId

string

Es el ID de video único de YouTube que identifica el video asociado con el reclamo.
origin

object (Origin)
matchInfo

object (MatchInfo)

Si este reclamo se generó automáticamente a partir de una referencia proporcionada, en esta sección se proporcionarán detalles de la coincidencia que generó el reclamo.
studioInfo

object (StudioInfo)

Contiene URLs que vinculan a páginas relacionadas con los reclamos en Studio.

Origen

Este objeto contiene información que describe la fuente de los metadatos o los datos de propiedad.

Representación JSON 
{
  "source": string
}
Campos
source

string

Es la fuente del reclamo. Los valores aceptables son:

  • audioMatch: La pista de audio del video reclamado coincidió con una referencia de Content ID.
  • audioSwap: Se reemplazó una canción del programa AudioSwap en el video reclamado.
  • batchTool: El reclamo se creó a partir de una operación masiva.
  • cmsUpload: El reclamo se creó a través de la carga de SFTP o Studio.
  • contentIdApi: El reclamo se creó con la API de Content ID.
  • cvpSearch: El reclamo se originó a través de la página de búsqueda de la herramienta del Programa de verificación de contenido.
  • descriptiveSearch: El contenido se reclamó a través de la página de reclamos manuales en YouTube Studio.
  • external: El reclamo se creó con herramientas externas.
  • gameId: El sistema de ID de juego encontró una coincidencia con el video.
  • googleDevId: Google creó el reclamo.
  • hashcode: El reclamo se creó a través de la coincidencia de hash MD5.
  • inProductShorts: Es un reclamo de Shorts o de sincronización.
  • inProductStudio: Es un reclamo de licencia declarado manualmente en YouTube Studio.
  • melodyMatch: El reclamo se generó a partir de una coincidencia de melodía.
  • syntheticVocal: El reclamo se originó a partir de un reclamo por coincidencia de activos vocales.
  • videoMatch: La pista de video del video reclamado coincidió con una referencia de Content ID.
  • youTubeAdmin: El reclamo lo creó un administrador de YouTube.

MatchInfo

Información de coincidencia sobre el reclamo

Representación JSON 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Campos
matchSegments[]

object (MatchSegment)

Son los detalles de cada segmento de la correlación. Cada elemento de la lista contiene información sobre un segmento de coincidencia asociado con el reclamo. Es posible tener varios segmentos de coincidencia. Por ejemplo, si el contenido de audio y video de un video subido coincide con el de un video de referencia, habrá dos segmentos coincidentes. Un segmento describiría la coincidencia de audio y el otro describiría la coincidencia de video.
referenceId

string

Es el ID de la referencia que generó esta coincidencia.
longestMatch

object (LongestMatch)

Son los detalles de la coincidencia más larga entre la referencia y el video del usuario.
totalMatch

object (TotalMatch)

Detalles de la cantidad total de contenido de referencia y de video del usuario que coincidieron entre sí. Ten en cuenta que estos dos valores pueden diferir si el video de referencia o el del usuario contienen un bucle.

MatchSegment

Es la información sobre un segmento de coincidencia único en un reclamo.

Representación JSON 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Campos
video_segment

object (Segment)

El objeto videoSegment contiene información sobre la parte coincidente del video reclamado.
reference_segment

object (Segment)

El objeto referenceSegment contiene información sobre la parte coincidente del contenido de referencia.
channel

string

Identifica la manera en que el video reclamado coincide con el video de referencia.

Los valores aceptables son:

  • Audio
  • Melody
  • Video
manual_segment

object (Segment2)

En la operación de inserción de reclamos manuales, el objeto manualSegment contiene información sobre la parte específica del video que se reclama como coincidente.

Segmentar

Este recurso representa un segmento simple con la hora de inicio y finalización con el formato de una cadena "hh:mm:ss.mmm".

Representación JSON 
{
  "start": string,
  "duration": string,
  "kind": string
}
Campos
start

string

Es la hora de inicio del segmento, medida en milisegundos desde el comienzo.
duration

string

Es la duración del segmento, expresada en milisegundos.
kind

string

Tipo de recurso de la API. Para los recursos de segmento, el valor es youtubePartner#segment.

Segment2

Este recurso representa otro segmento simple con la hora de inicio y finalización con el formato de una cadena "hh:mm:ss.mmm".

Representación JSON 
{
  "start": string,
  "kind": string,
  "finish": string
}
Campos
start

string

Es la hora de inicio del segmento, medida en milisegundos desde el comienzo.
kind

string

Tipo de recurso de la API. Para los recursos de segmento, el valor es youtubePartner#segment.
finish

string

Hora de finalización del segmento, medida en milisegundos desde el inicio.

LongestMatch

Es la coincidencia de reclamo más larga.

Representación JSON 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Campos
durationSecs

string

Es la duración de la coincidencia más larga entre la referencia y el video del usuario.
userVideoOffset

string

Es el desplazamiento en segundos del video del usuario en el que comenzó la coincidencia más larga.
referenceOffset

string

Es el desplazamiento en segundos dentro de la referencia en el que comenzó la coincidencia más larga.

TotalMatch

Es la coincidencia total del reclamo.

Representación JSON 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Campos
userVideoDurationSecs

string

Es la cantidad total de contenido del video del usuario que coincidió con la referencia en segundos.
referenceDurationSecs

string

Es la cantidad total de contenido de la referencia que coincidió con el video del usuario en segundos.

Métodos

get

 Recupera un reclamo específico a partir de su ID.

insert

 Crea un reclamo.

list

 Recupera una lista de reclamos administrados por el propietario del contenido asociado con el usuario autenticado actualmente.

patch

 Aplica parches a un reclamo existente cambiando su política o su estado.

update

 Actualiza un reclamo existente cambiando su política o su estado.