REST Resource: claims

Recurso: Claim

Un claim vincula un video subido por un socio o un usuario a un elemento con el cual el video coincide. 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 desea que YouTube aplique en el 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)

La política que proporcionó el propietario que ve el reclamo.

timeCreated

string

La hora en la que se creó el reclamo.

contentType

string

Este valor indica si el reclamo cubre la porción de audio, video o audiovisual del contenido reclamado.

ugcType

string

Es el tipo de CGU del reclamo (estándar, premium o de canción).

isPartnerUploaded

boolean

Indica si el reclamo es subido por un socio.

timeStatusLastModified

string

La hora en la que se modificó por última vez el estado del reclamo o los detalles del estado.

blockOutsideOwnership

boolean

Indica si el video reclamado se debe bloquear en cualquier lugar en el que no tenga su propiedad explícita.

status

string

El estado del reclamo. Cuando actualizas un reclamo, puedes actualizar su estado de active a inactive para retirarlo de manera efectiva, pero la API no admite otras actualizaciones del estado de un reclamo.

appliedPolicy

object (Policy)

La política que se aplicó al propietario que lo visualiza en el reclamo. Es posible que no sea igual a la política de reclamos final del video, ya que no considera la política de otros socios sobre el mismo reclamo.

id

string

ID que YouTube asigna y usa para identificar el reclamo de manera inequívoca.

assetId

string

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

videoId

string

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

origin

object (Origin)

matchInfo

object (MatchInfo)

Si este reclamo se generó automáticamente según una referencia proporcionada, en esta sección se brindarán detalles sobre la coincidencia que generó el reclamo.

studioInfo

object (StudioInfo)

Contiene URLs que dirigen a páginas relacionadas con 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

MatchInfo

Corresponde a la información de coincidencias del reclamo.

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

object (MatchSegment)

Detalles sobre cada segmento de coincidencia. Cada elemento de la lista contiene información sobre un segmento de coincidencia asociado con el reclamo. Es posible tener varios segmentos coincidentes. 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 del video.

referenceId

string

El ID de referencia que generó esta coincidencia.

longestMatch

object (LongestMatch)

Detalles de la coincidencia más larga entre la referencia y el video del usuario

totalMatch

object (TotalMatch)

Detalles de la cantidad total de referencias y contenido de videos de usuarios que coincidieron entre sí. Ten en cuenta que estos dos valores pueden diferir si la referencia o el video del usuario contienen una repetición.

MatchSegment

Es la información sobre un solo segmento coincidente 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 forma en que el video reclamado coincide con el video de referencia.

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 afirma que coincide.

Segmento

Este recurso representa un segmento simple con horas 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 principio.

duration

string

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

kind

string

Tipo de recurso de la API. En el caso de los recursos de segmentos, el valor es youtubePartner#segment.

Segment2

Este recurso representa otro segmento simple con horas 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 principio.

kind

string

Tipo de recurso de la API. En el caso de los recursos de segmentos, el valor es youtubePartner#segment.

finish

string

Indica la hora de finalización del segmento, medida en milisegundos desde el principio.

LongestMatch

Coincidencia con el reclamo más largo.

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

string

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

userVideoOffset

string

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

referenceOffset

string

El desplazamiento en segundos hacia la referencia en la que comenzó la coincidencia más larga.

TotalMatch

Coincidencia total del reclamo.

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

string

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

referenceDurationSecs

string

Es la cantidad total de contenido en 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.