API de Content ID de YouTube - Historial de revisión

Nota: La API de YouTube Content ID está diseñada para que la usen los socios de contenido de YouTube, y no todos los desarrolladores ni usuarios de YouTube pueden acceder a ella. Si no ves la API de Content ID de YouTube como uno de los servicios que aparecen en la Consola de API de Google, visita el Centro de ayuda de YouTube para obtener más información sobre el Programa de socios de YouTube.

En esta página, se enumeran los cambios en la API de YouTube Content ID y las actualizaciones de la documentación.

26 de marzo de 2025

A partir del 31 de marzo de 2025, YouTube cambiará la forma en que se registran las vistas de Shorts. Antes, en Shorts, se registraba una vista después de que un Short se reproducía durante una cantidad determinada de segundos. Ahora, las vistas contarán la cantidad de veces que un Short comienza o vuelve a reproducirse, sin requisitos de tiempo de reproducción mínimo. Más información

A partir del 30 de junio de 2025, la API de Content ID se actualizará de las siguientes maneras de acuerdo con este cambio:

  • claimSearch.list.sort tendrá sus órdenes de clasificación actualizados:
    • Se agregará DAILY_ENGAGED_VIEWS para las cantidades diarias de vistas según la metodología de recuento de vistas anterior.
    • LIFETIME_ENGAGED_VIEWS se agregará a los registros de vistas totales según la metodología de recuento de vistas anterior.
  • assetSearch.list.sort tendrá sus órdenes de clasificación actualizados:
    • Se agregará DAILY_ENGAGED_VIEWS para las cantidades diarias de vistas según la metodología de recuento de vistas anterior.

A partir del 30 de septiembre de 2025, la API de Content ID se actualizará de las siguientes maneras de acuerdo con este cambio:

  • El orden de clasificación assetSearch.list.sort VIEWS dejará de estar disponible.
  • El orden de clasificación claimSearch.list.sort VIEW_COUNT dejará de estar disponible.
  • claimSearch.claimSnippet.videoViews se actualizará para reflejar la metodología actualizada del registro de vistas de Shorts.
  • Se agregará claimSearch.claimSnippet.engagedViews para los recuentos de vistas según la metodología de recuento de vistas anterior.

14 de enero de 2025

Se actualizó el campo autoGeneratedBreaks[] del recurso videoAdvertisingOption, ya que ahora permitimos que se proporcionen ad_breaks y autoGeneratedBreaks al mismo tiempo. Si autoGeneratedBreaks se establece como verdadero en un video con adBreaks definido, nuestros sistemas identificarán lugares para mostrar anuncios, además de los espacios publicitarios que hayas ubicado de forma manual. Consulta el artículo de asistencia para obtener más detalles.

10 de noviembre de 2023

Se actualizó el campo adFormats[] del recurso videoAdvertisingOption para que third_party sea el único valor válido para ese campo. Ya no se admiten los siguientes formatos de anuncios: instream_trueview, instream_standard, display, preroll y postroll. Consulta el artículo de asistencia para obtener más detalles.

1 de junio de 2023

Nota: Este es un anuncio de baja.

Esta actualización incluye los siguientes cambios:

20 de diciembre de 2022

Se actualizó la definición del parámetro de consulta ownershipRestriction del método assetSearch.list para aclarar que, si el valor de ese parámetro es none, el valor del parámetro metadataSearchFields también debe usar al menos un filtro de ID. Este cambio en la documentación no refleja un cambio en el comportamiento de la API.

9 de noviembre de 2022

Se actualizó la documentación de los métodos asset.get y asset.list para aclarar cómo se admiten varios valores para lo siguiente:

28 de septiembre de 2022

Se agregó información sobre la elegibilidad para obtener licencia a asset resource.

18 de julio de 2022

Se actualizó la documentación de inactiveReasons del método claimSearch.list para reflejar las mejoras de coherencia con YouTube Studio:

  • Anteriormente, Studio quitó la compatibilidad con Audio Swap y Song Erase. Los valores de API correspondientes, audio_removed y song_erased, se ignoraron de forma silenciosa y ahora no están documentados.
  • channel_whitelisted se reemplazó por channel_allowlisted. El valor anterior ya no se documenta, pero aún es compatible.
  • Ahora se admiten los valores closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced y video_modified.

14 de junio de 2022

Se actualizó la documentación del recurso assetSearch para reflejar las dos propiedades nuevas: isrcs[] y iswcs[]. Los nuevos valores de las propiedades isrcs[] y iswcs[] contienen un array de valores de cadenas, cada uno de los cuales especifica un ISRC o ISWC, según corresponda, que se asigna al activo identificado por el resultado de la búsqueda.

Se recomiendan las propiedades nuevas en lugar de las propiedades isrc y iswc que ya se incluyen en los recursos assetSearch, ya que las nuevas proporcionan datos más precisos. Mientras que las propiedades nuevas pueden enumerar un array de valores de cadena, las propiedades isrc y iswc identifican solo un código ISRC o ISWC asociado con el resultado de la búsqueda.

12 de mayo de 2022

Se actualizaron los vínculos a las bibliotecas cliente para que apunten a las bibliotecas cliente estándar de las APIs de Google. Se actualizaron las vinculaciones pregeneradas para PHP.

3 de mayo de 2022

El parámetro status del método claimSearch.list ahora admite más filtros basados en posibles detalles de reclamos.

2 de mayo de 2022

Se actualizó la documentación de la respuesta del método assetSearch.list para reflejar las mejoras de coherencia con el AIP-158:

  • La descripción de pageInfo.totalResults menciona explícitamente que el valor es una estimación y no el valor real.
  • Se quitaron los campos pageInfo.resultsPerPage y pageInfo.startIndex.

25 de abril de 2022

Se actualizó la documentación del recurso assetLabels.list para aclarar el significado de los parámetros de solicitud labelPrefix y q, y para documentar que la solicitud o respuesta admite la paginación.

8 de diciembre de 2021

Se actualizó la documentación del recurso claimSearch.list para reflejar correctamente los dos casos de uso que abarca este método:

  • Buscar por ID (activo, referencia o video) o cadena de consulta
  • Buscar por fecha de creación, fecha de modificación o estado del reclamo

Cada caso de uso admite un conjunto diferente de parámetros de consulta. Se actualizó la documentación del método claimSearch.list para explicar qué parámetros son compatibles con cada caso de uso.

17 de noviembre de 2021

Esta actualización incluye los siguientes cambios:

  • El método claims.update ahora admite la capacidad de actualizar el estado de un reclamo inactivo o potencial a active. La definición de la propiedad status del recurso claim proporciona más detalles.
  • Se actualizó la documentación de los recursos claim y claimSearch para reflejar la incorporación del nuevo objeto studioInfo, que contiene vínculos a páginas de YouTube Studio relacionadas con el reclamo.
  • Cambió la lista de valores admitidos para el parámetro origin del método claimSearch.list. El parámetro ahora admite cuatro valores adicionales: batchTool, inProductShorts, melodyMatch y youTubeAdmin. Además, ya no se admiten los valores dropboxUpload y webUpload.

26 de febrero de 2021

Se actualizó la documentación del parámetro videoId del método claimSearch.list para indicar que el valor del parámetro ahora acepta un máximo de 10 IDs de video separados por comas. La API mostrará un error badRequest (código de respuesta HTTP 400) si el valor contiene más de 10 IDs de video.

6 de diciembre de 2018

Nota: Este es un anuncio de baja.

Se actualizó la documentación de la API para quitar las referencias al recurso contentOwnerAdvertisingOptions y sus métodos. Estos métodos se usaban de forma muy mínima, y los usuarios de la API que los usaban se comunicaron por separado antes de este anuncio.

21 de marzo de 2018

Esta actualización incluye los siguientes cambios:

  • Ahora, la propiedad metadataMine.artist debe establecerse cada vez que insertes, actualices o corrigas un video musical o un activo de grabación de sonido. La API ahora muestra un error si la propiedad no está configurada para esos tipos de recursos. Además, ten en cuenta que la propiedad metadataMine.artist solo se admite para artistas de videos musicales y grabaciones de sonido.

24 de julio de 2017

Esta actualización incluye los siguientes cambios:

  • El nuevo recurso package representa un grupo de archivos que se entregan a través de la Web, SFTP o algún otro mecanismo de entrega. La API admite dos métodos para este recurso:

    • El método package.insert valida y sube un paquete solo de metadatos que contiene exactamente un archivo de metadatos.
    • El método package.get recupera información sobre un paquete subido anteriormente.

  • En el caso del método validator.validate, se actualizó la definición de la propiedad uploaderName para indicar que el valor no identifica al socio de contenido que sube los datos, sino un valor como web-google o yt-google que identifica la cuenta de cargador específica que usa el propietario del contenido.

  • La propiedad status del recurso reference ya no usa el valor duplicate_on_hold para indicar que una referencia es un duplicado de otra. En cambio, si una referencia es un duplicado, el valor de la propiedad status ahora se establece en inactive y el valor de la propiedad statusReason es REASON_DUPLICATE_FOR_OWNERS.

    Sin embargo, al igual que antes, la propiedad duplicateLeader del recurso solo se propaga si la referencia es un duplicado. Si está configurada, el valor de esa propiedad identifica la referencia duplicada.

17 de abril de 2017

Esta actualización incluye los siguientes cambios:

  • El nuevo recurso assetShare, que solo es relevante para los activos de composición, identifica una relación entre dos representaciones de un recurso de activo. Estas representaciones reflejan un nuevo modelo de datos de publicación diseñado para brindar más transparencia y control sobre cómo se asocian tus derechos con los activos de grabación de sonido.

    En el modelo nuevo, cada grabación de sonido se asigna a exactamente un activo único, que se denomina vista de composición. Los metadatos de ese activo representan el conjunto canónico de información que YouTube muestra sobre los derechos de composición asociados con una grabación determinada y pueden sintetizar información de varios proveedores de datos.

    Además, cada propietario de la composición tiene su propio activo de porcentaje de composición. El porcentaje de composición representa la información que un editor en particular proporcionó para un activo de composición. El porcentaje de composición se puede asociar con muchas grabaciones de sonido.

    El recurso assetShare identifica una relación entre una vista de composición y un porcentaje de composición. El nuevo método assetShares.list te permite hacer lo siguiente:

    • Proporciona el ID de una vista de composición y recupera la parte de la composición correspondiente que pertenece al socio que autoriza la solicitud, si existe.
    • Proporciona el ID de un porcentaje de composición que sea propiedad del socio de contenido y recupera una lista de todas las vistas de composición a las que está vinculado ese porcentaje.

  • En la nueva guía Cómo administrar activos de composición, se explica cómo los diferentes métodos de la API controlan las solicitudes según si los IDs de activos enviados a esos métodos identifican vistas de composición o porcentajes de composición.

  • La nueva propiedad claimedVideoOptions.autoGeneratedBreaks del recurso contentOwnerAdvertisingOptions indica si YouTube debe generar automáticamente pausas publicitarias en los videos reclamados que duran más de 10 minutos. Si bien la propiedad afecta a todos los videos del propietario del contenido que duran más de 10 minutos, si un video tiene varios reclamos, el primer socio que reclama un video establece el comportamiento predeterminado de esta propiedad en relación con ese video.

11 de agosto de 2016

Esta actualización incluye los siguientes cambios:

  • Las Condiciones del Servicio de los Servicios de la API de YouTube publicadas recientemente ("las Condiciones Actualizadas"), que se analizan en detalle en el Blog de Ingeniería y Desarrolladores de YouTube, proporcionan un amplio conjunto de actualizaciones de las Condiciones del Servicio actuales. Además de las Condiciones Actualizadas, que entrarán en vigencia el 10 de febrero de 2017, esta actualización incluye varios documentos de respaldo para ayudar a explicar las políticas que deben seguir los desarrolladores.

    El conjunto completo de documentos nuevos se describe en el historial de revisiones de las Condiciones Actualizadas. Además, en ese historial de revisiones también se explicarán los cambios futuros en las Condiciones Actualizadas o en esos documentos de respaldo. Puedes suscribirte a un feed RSS que muestre los cambios en ese historial de revisión desde un vínculo en ese documento.

31 de mayo de 2016

Esta actualización incluye los siguientes cambios:

  • Nuevos recursos y métodos

    • El nuevo método validator.validate te permite determinar si un archivo de metadatos contiene errores de validación que impedirían que YouTube lo procese correctamente. Si el archivo contiene errores, la propiedad errors de la respuesta de la API contiene una lista de errores de validación que identifican la gravedad, la causa y la ubicación de cada error.

  • Errores nuevos y actualizados

    • Los métodos assets.patch y assets.update ahora admiten el siguiente error. Recuerda que un método puede admitir varios errores que tengan el mismo tipo de error. Consulta la documentación de errores de cada método o la página de errores para obtener una lista completa de los posibles errores.

      Errores
      invalidValue (400) parameters.assetId
      La solicitud falló porque el recurso que se actualiza se fusionó con otro. Vuelve a enviar la solicitud con el ID de ese activo, que se muestra en el mensaje de error, como el valor del parámetro assetId.

28 de marzo de 2016

Esta actualización incluye los siguientes cambios:

  • Actualizaciones de los recursos y métodos existentes

    • La nueva propiedad matchInfo.matchSegments[] del recurso claim contiene una lista en la que cada elemento describe un segmento del video reclamado que coincide con parte del video de referencia. Un reclamo puede 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ía dos segmentos de coincidencia. Un segmento describiría la coincidencia de audio y el otro describiría la coincidencia de video.

      Para cada segmento coincidente, la API muestra la duración y el tipo (audio o video) del contenido coincidente. La API también identifica las compensaciones de tiempo en las que comienza y termina cada segmento de coincidencia en el video reclamado y en el de referencia.

    • El valor de la propiedad claimedVideoOptions.newVideoDefaults[] del recurso contentOwnerAdvertisingOptions ahora se puede actualizar cuando llamas a los métodos contentOwnerAdvertisingOptions.patch o contentOwnerAdvertisingOptions.update.

    • La propiedad allowedOptions.autoGeneratedBreaks de solo lectura del recurso contentOwnerAdvertisingOptions dejó de estar disponible.

  • Errores nuevos y actualizados

    • El método claims.update de la API ahora admite el siguiente error. Recuerda que un método puede admitir varios errores que tengan el mismo tipo de error. Consulta la documentación de errores de cada método o la página de errores para obtener una lista completa de los posibles errores.

      Errores
      badRequest (400) alreadyClaimed
      El reclamo es un duplicado de otro reclamo existente y no se puede actualizar.

    • En ocasiones, el método assets.list se agota y muestra un código de respuesta HTTP 500 (Internal Server Error), en particular, cuando la solicitud recupera datos de muchos activos y el valor del parámetro fetchMatchPolicy es effective. Si tu solicitud assets.list especifica varios IDs de activos y muestra un error 500, intenta volver a enviar la solicitud para un solo activo o una cantidad menor de activos.

    • Se actualizó la documentación del error references.insert para indicar que, si la solicitud sube un archivo de referencia dañado, ese problema no se identifica hasta que se procesa la referencia. Por lo tanto, incluso si la solicitud references.insert muestra una respuesta correcta, es posible que la referencia no se procese correctamente. Te recomendamos que, después de insertar una referencia, realices una sondeo con el método references.list para confirmar que la referencia se active como se espera.

3 de febrero de 2016

Esta actualización incluye los siguientes cambios:

  • Actualizaciones de los recursos y métodos existentes

    • La API ahora admite anuncios de ficha de producto. Los anuncios de ficha de producto destacan productos relacionados con el contenido de un video o que aparecen en él. Estos anuncios son tarjetas patrocinadas que se muestran durante el video. El sistema de anuncios agrega las tarjetas automáticamente. Los espectadores ven un avance de la tarjeta durante unos segundos y también pueden hacer clic en el ícono de la esquina superior derecha del video para explorar las tarjetas de este.

      Como resultado de este cambio, product_listing ahora se puede incluir en los valores de las siguientes propiedades:

      Método de recursos o API Propiedad
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • Los nuevos createdBefore y createdAfter del método assetSearch.list le indican a la API que solo muestre los recursos creados antes o después de una fecha determinada.

    • En la respuesta de la API a una solicitud assetSearch.list, la propiedad type ahora admite el valor art_track_video. En el Centro de ayuda de YouTube, encontrarás más información sobre los videos de pistas de arte.

    • El método claimSearch.list admite los siguientes parámetros nuevos:

      Parámetros
      referenceId Este parámetro de filtro especifica el ID de referencia de YouTube de la referencia para la que recuperas los reclamos.
      inactiveReasons Este parámetro opcional te permite restringir la respuesta de la API para que solo incluya reclamos inactivos según los motivos especificados por los que se volvieron inactivos. En la definición del parámetro, se enumeran los tipos de reclamos inactivos por los que puedes realizar búsquedas.
      partnerUploaded Este parámetro booleano opcional te permite especificar que la respuesta de la API solo debe incluir reclamos subidos por socios o no.

    • El nuevo objeto references#origination del recurso reference contiene información que describe la fuente de la referencia.

    • El método references.insert ahora admite la capacidad de subir referencias generadas con el software gfp_gen de YouTube. Si proporcionas una huella digital generada previamente, establece el valor de la propiedad fpDirect en true en el recurso reference subido.

      Ten en cuenta que, con este cambio, la API ya no muestra un error si intentas configurar la propiedad fpDirect cuando subes una referencia.

  • Errores nuevos y actualizados

    La documentación ahora muestra los errores que muestran los métodos del recurso whitelist.

    Además, en la siguiente tabla, se identifican los errores nuevos que admite la API y los métodos que podrían mostrar cada error. Ten en cuenta que un método puede mostrar varios errores que tienen el mismo tipo de error. Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

    Errores
    badRequest (400) inappropriateCampaignTarget
    Los métodos campaigns.insert y campaigns.update muestran este error si una campaña intenta mostrar un video que puede ser inapropiado para algunos usuarios. Para corregir el error, elige otro contenido para mostrar.
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    El método claims.insert muestra este error si intentas crear un reclamo subido por un socio con un activo de composición o de grabación de sonido.
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    El método claims.insert muestra este error si ya existe un reclamo por música grabada en el video especificado. No se pueden agregar reclamos de composición directa a través de la API.
    badRequest (400) asset_id
    El método references.insert muestra este error si la solicitud intentó crear una referencia a través de un archivo, pero no especificó un assetId.
    badRequest (400) canNotBeActivated
    El método references.update muestra este error si no se puede activar la referencia, posiblemente debido a su estado o a las condiciones de propiedad.
    badRequest (400) videoNotClaimed
    El método videoAdvertisingOptions.get muestra este error si no reclamaste el video para el que intentas recuperar las opciones publicitarias, por lo que la información solicitada no estará disponible para ti.

18 de diciembre de 2015

Las leyes de la Unión Europea (UE) exigen que se realicen determinadas divulgaciones y se obtenga el consentimiento de los usuarios finales de la UE. Por lo tanto, en el caso de los usuarios finales de la Unión Europea, debes satisfacer la Política de Consentimiento de Usuarios de la UE. Agregamos un aviso sobre este requisito en nuestras Condiciones del Servicio de la API de YouTube.

21 de abril de 2015

Esta actualización incluye los siguientes cambios:

30 de marzo de 2015

Esta actualización incluye los siguientes cambios:

  • Actualizaciones de los recursos y métodos existentes

    • El nuevo parámetro isrcs del método assetSearch.list te permite especificar una lista de hasta 50 códigos ISRC. La respuesta de la API incluirá los activos asociados con esos ISRC.

    • La propiedad event[].reason del recurso claimHistory admite los siguientes valores nuevos. Cada motivo explica por qué ocurrió un evento en particular relacionado con el reclamo:

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • El nuevo parámetro sort del método claimSearch.list especifica el método que se usará para ordenar los recursos en la respuesta de la API. De forma predeterminada, los recursos se ordenan en orden cronológico inverso (del más reciente al más antiguo) según las fechas en las que se crearon. También puedes ordenar los recursos de la cantidad más alta a la más baja de vistas para el contenido reclamado.

      Ten en cuenta que, si la solicitud claimSearch.list también establece el valor del parámetro status en appealed, disputed, pending, potential o routedForReview, los resultados se ordenan según el momento en que vence el período de revisión de reclamos.

    • Los métodos ownership.update y ownership.patch ahora muestran correctamente todas las propiedades que se pueden actualizar cuando se llama a estos métodos. Este cambio representa una corrección en la documentación de la API y no identifica un cambio en la funcionalidad de la API.

    • Los parámetros fetchMatchPolicy para los métodos assets.get y assets.list ahora incluyen effective como un valor compatible. El valor le indica al servidor de la API que recupere la política de coincidencias que YouTube aplica al activo.

    • Los parámetros id de los métodos assets.list, claims.list, contentOwners.list, policies.list, publishers.list y references.list ahora indican que sus valores de parámetros pueden contener un máximo de 50 IDs separados por comas.

  • Errores nuevos y actualizados

    En la siguiente tabla, se identifican los errores nuevos que admite la API y los métodos que podrían mostrar cada error. Ten en cuenta que un método puede mostrar varios errores que tienen el mismo tipo de error.

    Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

    Tipo de error Detalle del error Descripción
    badRequest (400) tooManyIsrcs El método assetSearch.list muestra este error si el parámetro isrcs especifica más de 50 códigos ISRC.
    badRequest (400) videoIsPrivate El método claims.insert muestra este error si intentas reclamar un video privado. Solo puedes reclamar un video si su estado de privacidad es public o unlisted.
    notModified (304) blockOutsideOwnershipUnchanged El método claims.update muestra este error si no se pudo modificar correctamente la marca blockOutsideOwnership en el reclamo. Existen varios motivos por los que puede ocurrir este error. Un ejemplo común es que la modificación especificada no tiene efecto en el video reclamado.

7 de noviembre de 2014

Esta actualización incluye los siguientes cambios:

  • Actualizaciones de los recursos y métodos existentes

    • El parámetro status del método claimSearch.list ahora admite un valor de routedForReview. Este valor restringe los resultados a los reclamos que requieren una revisión manual según una regla de la política de coincidencias de un recurso.

    • La propiedad event[].reason del recurso claimHistory admite los siguientes valores nuevos. Cada motivo explica por qué ocurrió un evento en particular relacionado con el reclamo:

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

    • La propiedad origin.source del recurso claim, que identifica la fuente de un reclamo, ahora admite el valor melodyMatch. Un reclamo de coincidencia de melodía indica que el video reclamado comparte una composición musical con una referencia.

    • Se actualizó la documentación del método references.insert para reflejar correctamente que la API usa dos extremos diferentes para ese método. Esto no representa un cambio en la funcionalidad de la API, sino una corrección en la documentación existente.

      • Si la solicitud sube un archivo de referencia nuevo, el extremo correcto es el siguiente:

        POST https://www.googleapis.com/upload/youtube/partner/v1/references

      • Si la solicitud crea una referencia con un video reclamado como contenido de referencia, el extremo correcto es el siguiente:

        POST https://www.googleapis.com/youtube/partner/v1/references

  • Errores nuevos y actualizados

    En la siguiente tabla, se identifican los errores nuevos que admite la API y los métodos que podrían mostrar cada error. Ten en cuenta que un método puede mostrar varios errores que tienen el mismo tipo de error.

    Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

    Tipo de error Detalle del error Descripción
    badRequest (400) invalidLabelName Los métodos assets.insert, assets.update y assetLabels.insert muestran este error si el nombre de una etiqueta de activo no es válido. Los nombres de las etiquetas deben tener entre 2 y 30 caracteres. No pueden contener paréntesis angulares, comas, dos puntos, símbolos et (&) ni el carácter de barra vertical (|).
    badRequest (400) ownerHaveMaximumNumberOfLabels Los métodos assets.insert, assets.update y assetLabels.insert muestran este error si un propietario de contenido ya definió 2, 500 etiquetas de activos únicas, que es la cantidad máxima permitida actualmente.
    badRequest (400) tooManyLabelsOnOneAsset Los métodos assets.insert y assets.update muestran este error si un activo ya está asociado con 30 etiquetas de activos, que es la cantidad máxima permitida actualmente.
    badRequest (400) channelMonetizationSuspended Los métodos claims.insert y claims.update muestran este error si el canal de un video está suspendido por reclamos de socios.
    badRequest (400) channelNotActive El método claims.update muestra este error si el canal de un video no está activo.

  • Los métodos assets.insert y assets.update ya no muestran un error badRequest para algunos recursos si el recurso en el cuerpo de la solicitud no contiene la propiedad metadataMine.contentType.

23 de septiembre de 2014

Esta actualización incluye los siguientes cambios:

  • Cambios en el ID de propietario del contenido

    Entraron en vigencia los cambios en los IDs de los propietarios del contenido que se anunciaron en el historial de revisiones el 9 de julio de 2014. Como resultado de este cambio, la API ahora muestra un ID único generado para identificar al propietario del contenido asociado con el usuario autenticado o un recurso administrado a través de la API. Anteriormente, la API mostraba un nombre legible por humanos como el ID, como "qrs_network".

    Este cambio afecta a la siguiente función de la API y es probable que afecte a los socios que hayan codificado los códigos de socio en sus aplicaciones.

    • La API ahora muestra el ID nuevo como el valor de las propiedades de recursos que antes mostraban el código de socio, como la propiedad id del recurso contentOwner.
    • Todos los métodos de la API admiten el parámetro onBehalfOfContentOwner, que identifica al propietario del contenido en cuyo nombre se realiza la solicitud a la API. Después del cambio, el parámetro debe establecerse en el ID nuevo en lugar del código de socio. Para evitar que se produzcan errores de código, el parámetro aceptará cualquiera de los valores durante un período de transición.
    • Después del cambio, el parámetro contentOwnerId del método contentOwners.list debe especificar el ID nuevo en lugar del código del socio.

  • Actualizaciones de los recursos y métodos existentes

    • El nuevo parámetro metadataSearchFields del método assetSearch.list te permite especificar los campos de metadatos de los recursos que deseas buscar, así como los valores que deseas buscar en esos campos. El valor del parámetro es una lista de pares de campos y valores separados por comas. Dentro de un par, el campo y el valor se separan con dos puntos.

    • El nuevo objeto appliedPolicy del recurso claim especifica la política que YouTube aplica realmente para el reclamo. El valor del objeto es un recurso policy. Ese recurso contiene información sobre las políticas de los países en los que el propietario del contenido que envió la solicitud es propietario del recurso reclamado.

      La política aplicada puede diferir de la que definió el propietario del contenido de dos maneras:

      1. Tiene en cuenta las políticas establecidas por otros propietarios que tienen la propiedad parcial del activo reclamado en algunos de los mismos territorios que el propietario del contenido que envió la solicitud a la API.

      2. Tiene en cuenta las políticas administrativas de YouTube que se aplican en los territorios donde el propietario del contenido es el propietario del activo reclamado.

    • La nueva propiedad uploaderChannelId del recurso claimHistory identifica el ID del canal al que se subió el video reclamado.

8 de septiembre de 2014

Esta actualización incluye los siguientes cambios:

  • Nuevos recursos y métodos

    • El nuevo recurso assetLabel identifica una etiqueta de texto que se puede asignar a un recurso. Las etiquetas te permiten colocar activos en categorías personalizadas, lo que facilita la organización de tu biblioteca de recursos. Puedes buscar elementos según sus etiquetas, lo que también simplifica los casos de uso que te piden actualizar grupos específicos de elementos.

      • El método assetLabels.list te permite recuperar una lista de las etiquetas de un propietario de contenido.
      • El método assetLabels.insert te permite crear una etiqueta de activo nueva. También puedes crear etiquetas nuevas llamando al método assets.update y actualizando las etiquetas de un activo. El servidor de la API creará automáticamente un nuevo recurso assetLabel para cualquier etiqueta que no se haya definido anteriormente.

  • Actualizaciones de los recursos y métodos existentes

    • Se actualizó la propiedad label[] del recurso asset para indicar que puedes llamar al método assets.update para actualizar las etiquetas de un activo. Sin embargo, no puedes establecer las etiquetas de un activo cuando llamas al método assets.insert.

      En la nueva guía Cómo usar etiquetas de activos, se explica cómo crear y recuperar etiquetas de activos, así como actualizar las etiquetas de un activo o buscar activos asociados con etiquetas en particular.

  • Errores nuevos y actualizados

    La API admite varios errores nuevos para los métodos assetLabels.list y assetLabels.insert.

9 de julio de 2014

Esta actualización incluye los siguientes cambios:

  • Cambios en el ID de propietario del contenido

    Históricamente, la API usó un código de socio legible por humanos, como "qrs_network", para identificar de forma única al propietario del contenido asociado con el usuario autenticado o un recurso administrado a través de la API. En el tercer trimestre de 2014, la API cambiará para usar un ID único de 22 caracteres para identificar a los propietarios del contenido. El cambio afecta a la siguiente funcionalidad de la API y es probable que afecte a los socios que hayan codificado los códigos de socio en sus aplicaciones.

    • La API mostrará el ID de 22 caracteres como el valor de las propiedades de recursos que anteriormente mostraban el código de socio, como la propiedad id del recurso contentOwner.
    • Todos los métodos de la API admiten el parámetro onBehalfOfContentOwner, que identifica al propietario del contenido en cuyo nombre se realiza la solicitud a la API. Después del cambio, el parámetro debe establecerse en el ID de 22 caracteres en lugar del código de socio. Para evitar que se produzcan errores de código, el parámetro aceptará cualquiera de los valores durante un período de transición.
    • Después del cambio, el parámetro contentOwnerId del método contentOwners.list debe especificar el ID de 22 caracteres en lugar del código de socio.

  • Actualizaciones de los recursos y métodos existentes

    • Un recurso asset ahora admite la propiedad label, que especifica una lista de etiquetas de activos asociadas con el activo. Puedes aplicar una etiqueta a varios elementos para agruparlos. Puedes usar las etiquetas como filtros de búsqueda para realizar actualizaciones masivas, descargar informes o filtrar YouTube Analytics.

    • El método assetSearch.list ahora admite los siguientes parámetros opcionales:

      • labels: Restringe los resultados para que solo incluyan los recursos asociados con las etiquetas especificadas. De forma predeterminada, la API muestra los activos que coinciden con todas las etiquetas especificadas. Sin embargo, puedes usar el parámetro includeAnyProvidedLabel para indicarle a la API que muestre los recursos que coincidan con cualquiera de las etiquetas especificadas.
      • includeAnyProvidedLabel: Se usa junto con el parámetro labels y le indica a la API que muestre los activos asociados con cualquiera de las etiquetas especificadas en el valor del parámetro labels.

    • Un recurso claimHistory ahora contiene las siguientes propiedades nuevas:

    • El método claimSearch.list ahora admite los siguientes parámetros opcionales:

      • createdAfter: Restringe los resultados para que solo incluyan reclamos creados después de la fecha especificada.
      • createdBefore: Restringe los resultados para que solo incluyan los reclamos creados antes de la fecha especificada.
      • includeThirdPartyClaims: Se usa junto con el parámetro videoId para indicar si se deben incluir reclamos de terceros en los resultados de la API.

  • Información más detallada sobre el error

    La documentación de errores ahora especifica el código de respuesta HTTP para cada tipo de error.

  • Errores nuevos y actualizados

    En la siguiente tabla, se identifican los errores nuevos que admite la API y los métodos que podrían mostrar cada error. Ten en cuenta que un método puede mostrar varios errores que tienen el mismo tipo de error. Por ejemplo, se muestra un error required si intentas insertar un recurso asset al que le falta un campo de metadatos obligatorio. De hecho, puede haber más de un campo de metadatos obligatorio, cada uno de los cuales mostrará un error con un mensaje ligeramente diferente.

    Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

    Método Errores
    assetSearch.list
    • invalidValue: La API no admite la búsqueda de recursos de programas o temporadas. Cambia el valor del parámetro type a un valor admitido.
    assets.insert
    • conflict: Ya existen demasiados activos con el mismo identificador (p.ej., ID personalizado, ISRC, etc.).
    • conflict: Ya existen demasiadas copias del activo especificado.
    • invalidValue: El usuario que llama a la API no tiene permiso para crear recursos del tipo especificado.
    assets.patch
    assets.update
    • badRequest: La API no admite la conversión de tipo de activo que intentaste.
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest: No puedes actualizar la propiedad de un activo de pista de arte.
    references.patch
    references.update
    • badRequest: La referencia tiene un estado no válido para la operación que intentas realizar.

3 de febrero de 2014

Esta actualización incluye los siguientes cambios:

  • Actualizaciones de los recursos y métodos existentes

    • Un recurso asset ahora puede tener un valor type de art_track_video.

    • Un recurso claimSearch ahora incluye las siguientes propiedades nuevas:

      • El objeto origin contiene información que describe la forma en que se creó el reclamo.
      • La propiedad thirdPartyClaim contiene un valor booleano que indica si el reclamo fue realizado por un propietario de contenido que no es el asociado con el usuario que realiza la búsqueda.

    • El método claimSearch.list ahora admite los siguientes parámetros opcionales:

      • contentType: Restringe los resultados para que solo incluyan reclamos de audio, de video o audiovisuales.
      • origin: Especifica uno o más orígenes de reclamos, como descriptiveSearch o videoMatch, para los que deseas encontrar reclamos.
      • status: Restringe los resultados para que solo incluyan los reclamos que tengan el estado especificado.

    • La propiedad status del recurso claim ahora admite los siguientes valores adicionales: appealed, disputed, potential, takedown y unknown.

    • La nueva propiedad blockOutsideOwnership del recurso claim indica si se debe bloquear el video reclamado en los territorios donde no es propiedad explícita. De forma predeterminada, un video reclamado se podía ver en los países en los que no se habían definido los datos de propiedad del activo asociado con el reclamo.

    • La nueva propiedad allowedOptions.autoGeneratedBreaks del recurso contentOwnerAdvertisingOption indica si el socio puede optar por mostrar anuncios in-stream durante el video en las pausas que determina automáticamente YouTube.

    • Ahora se puede llamar al método contentOwners.list con un token de autorización que especifique el permiso https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

    • La nueva propiedad timeUpdated del recurso policy especifica la hora en la que se actualizó la política por última vez.

    • El método policies.list ahora admite un parámetro sort opcional, que se puede usar para especificar que los resultados se deben ordenar de forma ascendente o descendente según la última vez que se actualizaron.

    • La nueva propiedad expiryTime del recurso referenceConflict especifica la hora en la que finalizará el período de revisión del conflicto de referencia, lo que hará que venza.

    • La nueva propiedad autoGeneratedBreaks del recurso videoAdvertisingOption indica si el video debe mostrar anuncios in-stream durante el video en las pausas que determina automáticamente YouTube.

  • Errores nuevos y actualizados

    En la siguiente tabla, se identifican los errores nuevos que admite la API y los métodos que podrían mostrar cada error. Ten en cuenta que un método puede mostrar varios errores que tienen el mismo tipo de error. Por ejemplo, se muestra un error required si intentas insertar un recurso asset al que le falta un campo de metadatos obligatorio. De hecho, puede haber más de un campo de metadatos obligatorio, cada uno de los cuales mostrará un error con un mensaje ligeramente diferente.

    Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

    Método Errores
    assets.insert
    assets.update
    • badRequest: La API no admite operaciones de escritura en recursos de pista de arte.
    claimSearch.list
    • invalidValue: El parámetro pageToken de la solicitud especifica un token de página no válido.
    claims.insert
    • badRequest: El reclamo que intentas crear no es válido porque el canal del video no está activo.
    • badRequest: El video que intentas reclamar está exento de una política de eliminación. Si tienes alguna consulta, escribe a copyright@youtube.com.
    • badRequest: No se puede procesar tu solicitud porque no puedes crear un reclamo de terceros en el video especificado.
    • conflict: YouTube no puede crear el reclamo solicitado porque el video anuló un aviso de eliminación.
    • conflict: YouTube no puede crear el reclamo solicitado porque el video tiene un reclamo de eliminación activo.
    references.insert
    • badRequest: El video reclamado que intentas usar se borró o rechazó, o bien falló su procesamiento.

  • Los errores contentOwnerNotProvided y internalError, que no son específicos de un método de API en particular, ya no se incluyen en todas las páginas de métodos. Sus descripciones aún se pueden encontrar en la sección Errores generales de la documentación de errores de la API.

12 de septiembre de 2013

Esta actualización incluye los siguientes cambios:

  • Nuevos recursos y métodos

    • El nuevo recurso referenceConflict identifica un conflicto entre dos archivos de referencia y muestra las coincidencias que existían entre esos archivos cuando se identificó el conflicto. El método referenceConflicts.list te permite recuperar una lista de conflictos de referencias no resueltos asociados con el propietario del contenido autorizado. El método referenceConflicts.get te permite recuperar un conflicto de referencia especificando su ID de conflicto de referencia único.

    Actualizaciones de los recursos y métodos existentes

    • La API ahora admite la capacidad de recuperar la política de coincidencias efectiva de un recurso. Este cambio es similar a los cambios lanzados el 16 de julio de 2013, que incluían compatibilidad para recuperar el conjunto canónico de metadatos y datos de propiedad de un recurso.

      Para recuperar la política de coincidencias efectiva de un recurso, establece el valor del parámetro fetchMatchPolicy en effective cuando llames a los métodos assets.get o assets.list. En la respuesta de la API, el objeto matchPolicyEffective de cada recurso asset que se muestra contiene la política de coincidencia efectiva para ese recurso.

    • El nuevo objeto ownershipConflicts del recurso asset contiene información sobre los conflictos de propiedad del activo. La estructura del objeto es similar a la de un recurso ownership, que identifica cada tipo de derechos que puede tener un propietario de activos. (para la mayoría de los tipos de activos, los propietarios solo pueden tener la propiedad general de los activos, pero en el caso de los activos de composición, los propietarios pueden detallar su propiedad de los derechos de interpretación, los derechos de sincronización o los derechos mecánicos).

      Del mismo modo, el objeto ownershipConflicts contiene listas separadas que identifican conflictos de derechos de propiedad general, derechos de interpretación, derechos de sincronización y derechos mecánicos. Para cada conflicto, los datos identifican los territorios en los que se produce, los propietarios que proporcionaron datos de propiedad en conflicto y el porcentaje del activo que cada propietario en conflicto afirma poseer.

    • Los métodos assets.get y assets.get ahora admiten el nuevo parámetro fetchOwnershipConflicts. El parámetro tiene un valor booleano que indica si la solicitud a la API debe recuperar conflictos de propiedad para los recursos en la respuesta de la API. El valor predeterminado es false, lo que significa que no se muestran conflictos de propiedad.

    • Se actualizó la definición del parámetro q del método assetSearch.list para identificar los campos de metadatos que busca YouTube.

    • La documentación del cuerpo de la solicitud para un método references.insert ahora indica que debes establecer el valor de la propiedad contentType. Este cambio actualiza la documentación para que refleje correctamente la funcionalidad real de la API, pero no representa un cambio en la funcionalidad de la API.

  • Errores nuevos y actualizados

    • La API admite un nuevo error forbidden, que no es específico de un método determinado, que indica que una cuenta de servicio no puede autorizar la operación solicitada.

    • El método assets.insert ahora identifica los errores de metadatos que se producen en las propiedades del objeto metadataMine en lugar del objeto metadata, que dejó de estar disponible a partir de la actualización de la API del 16 de julio de 2013.

    • Se actualizó la página errors para que, para cada recurso que admita los métodos update y patch, la página contenga una tabla que enumere los errores que muestran esos dos métodos. Anteriormente, la página enumeraba los errores de cada método por separado, aunque las listas siempre eran las mismas.

16 de julio de 2013

Esta actualización incluye los siguientes cambios:

  • Nuevos recursos y métodos

    • El nuevo método claimHistory.get te permite identificar y recuperar información sobre un reclamo específico. El recurso claimHistory que se muestra contiene una lista de eventos relacionados con el reclamo, como su creación, actualización, anulación o cierre.

    • El nuevo método claimSearch.list te permite buscar reclamos que cumplan con uno o todos los siguientes criterios:

      • Los reclamos están asociados con un activo específico.
      • Los reclamos están asociados con un video específico.
      • Los reclamos coinciden con una cadena de consulta proporcionada en la solicitud.

      Cada recurso claimSnippet de la respuesta de la API contiene detalles sobre un reclamo, incluido su ID único, su estado, su tipo (audio, video o audiovisual) y el activo y el video asociados con él. El recurso también especifica la cantidad de vistas del video reclamado y su título.

  • Actualizaciones de los recursos y métodos existentes

    • La documentación ahora enumera los valores admitidos para las propiedades que tienen un conjunto de valores enumerados. Estas propiedades incluyen la propiedad type del recurso asset y la propiedad status del recurso claim.

    • En el caso de los métodos assets.get y assets.list, la API ahora admite valores separados por comas para los parámetros de solicitud fetchMetadata y fetchOwnership, lo que te permite recuperar varios conjuntos de metadatos o datos de propiedad.

      En la siguiente lista, se explican los cambios correspondientes en la estructura del recurso asset, así como los efectos de esos cambios en los métodos de la API que usan recursos asset de get, list, insert, update o patch.

      • El objeto metadata dejó de estar disponible y se reemplazó por los objetos metadataMine y metadataEffective. Los objetos nuevos permiten que un recurso asset incluya el conjunto de metadatos que proporciona el propietario del contenido que realiza la solicitud a la API, así como el conjunto canónico de metadatos que YouTube determinó que es el más preciso y completo para el activo.

      • Del mismo modo, el objeto ownership se reemplazó por los objetos ownershipMine y ownershipEffective.

      • El objeto matchPolicy se reemplazó por el objeto matchPolicyMine. (Actualmente, la API no admite la capacidad de recuperar la política de coincidencias efectiva de un recurso).

      Nota: Para garantizar la retrocompatibilidad, si se solicita solo una versión de metadatos, un conjunto de datos de propiedad o una política de coincidencias para un activo, la respuesta de la API incluirá el objeto obsoleto y el objeto que se admite recientemente. Por ejemplo, si una solicitud establece el parámetro fetchMetadata en mine, la respuesta de la API contendrá un objeto metadata y un objeto metadataMine, que contendrán los mismos datos. (La capacidad de establecer fetchMetadata=mine era compatible antes de la actualización de la función, lo que te permitía recuperar varias versiones de metadatos).

      Sin embargo, si el parámetro fetchMetadata se establece en mine,effective, la respuesta de la API contendrá objetos metadataMine y metadataEffective, pero no contendrá un objeto metadata. (La capacidad de establecer fetchMetadata=mine,effective no era compatible antes de esta actualización de funciones, por lo que no es necesario mostrar el objeto metadata para la retrocompatibilidad). El mismo principio también se aplica a los parámetros fetchOwnership y fetchMatchPolicy.

      Del mismo modo, para la retrocompatibilidad, una solicitud a insert, update o patch a un recurso asset puede incluir el objeto metadataMine o el objeto metadata. El mismo principio se aplica a la configuración de los datos de propiedad o la política de coincidencia de un recurso asset.

    • Los parámetros assetId, q y videoId del método claims.list dejaron de estar disponibles. Para buscar reclamos con cualquiera de estos criterios, usa el método claimSearch.list, que admite todos esos parámetros.

    • En un recurso ownership, los valores de las propiedades general[].ratio, performance[].ratio, synchronization[].ratio y mechanical[].ratio ahora tienen un formato de contenido de double en lugar de integer.

    • La definición de la propiedad rules[].action del recurso policy ahora enumera los valores válidos para esa propiedad: block, monetize, takedown y track. Sin embargo, ten en cuenta que no puedes usar la API para aplicar una política de eliminación a un reclamo.

    • La nueva propiedad claimId del recurso reference está presente si la referencia se creó asociando un recurso con un video de YouTube existente 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.

    • La nueva propiedad excludedIntervals[] del recurso reference especifica una lista de intervalos de tiempo durante la referencia que YouTube debe ignorar cuando intenta hacer coincidir la referencia. Cada intervalo especifica una hora de inicio y de finalización medida en segundos desde el inicio del video.

    • La API ya no requiere que se establezca la propiedad status en el recurso reference que se envía en el cuerpo de una solicitud references.update o references.patch.

    • Se corrigió la documentación para describir correctamente el formato de respuesta de la API para el método videoAdvertisingOptions.getEnabledAds. La respuesta, que es un recurso youtubePartner#videoAdvertisingOptionGetEnabledAds, contiene la siguiente información:

      • id: Es el ID que YouTube usa para identificar de forma exclusiva el video reclamado asociado con la configuración.

      • adBreaks: Es una lista de objetos en la que cada uno contiene información sobre un punto antes, durante o después de la reproducción del video cuando se permite que se publiquen los anuncios. Cada objeto también puede especificar otros atributos de la pausa publicitaria, como los espacios publicitarios que se muestran durante la pausa y los tipos de anuncios que se pueden publicar durante cada espacio.

      • adsOnEmbeds: Es un campo booleano que indica si YouTube puede mostrar anuncios cuando el video se reproduce en un reproductor incorporado.

      • countriesRestriction: Es una lista de objetos en la que cada uno identifica una lista de territorios y los formatos de anuncios que se usan durante la reproducción del video en esos territorios.

  • Errores nuevos y actualizados

    • En la siguiente tabla, se identifican los errores nuevos que admite la API y los métodos que podrían mostrar cada error. También identifica los errores que cambiaron. Ten en cuenta que un método puede mostrar varios errores que tienen el mismo tipo de error. Por ejemplo, se muestra un error required si intentas insertar un recurso asset al que le falta un campo de metadatos obligatorio. De hecho, puede haber más de un campo de metadatos obligatorio, cada uno de los cuales mostrará un error con un mensaje ligeramente diferente.

      Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

      Método Errores
      assets.insert
      assets.update
      assets.patch
      • Los errores invalidValue y required que antes se asociaban con propiedades secundarias del objeto metadata ahora se asocian con las mismas propiedades secundarias del objeto metadataMine.
      claimHistory.get
      • notFound: No se puede encontrar el reclamo para el que intentas recuperar el historial.
      • required: La solicitud no especifica un valor para el parámetro claimId.
      claimSearch.list
      claims.list
      • badRequest: La solicitud especifica criterios no válidos. Como máximo, se puede especificar uno de los siguientes parámetros de filtro: q, assetId, videoId.
      claims.insert
      • badRequest: El reclamo que intentas crear no es válido porque el propietario del contenido solicitado no es propietario del activo asociado con el reclamo.
      • badRequest: El propietario del contenido en cuyo nombre actúas no tiene permiso para crear políticas con la acción especificada.
      • invalidValue: El propietario del contenido en cuyo nombre actúas no tiene permiso para reclamar videos subidos por usuarios a través de la API.
      contentOwners.list
      • badRequest: La solicitud especifica criterios no válidos. Se debe especificar exactamente uno de los siguientes parámetros de filtro: fetchMine, id. (Anteriormente, el error enumeraba un conjunto diferente de parámetros de filtro: has_conflicts_with, restrict_to_user, name_prefix y id).
      ownership.update
      ownership.patch
      • badRequest: Una solicitud que actualiza los datos de propiedad de un recurso de composición debe especificar datos de propiedad detallados (derechos mechanical, performance, synchronization o lyric) en lugar de derechos de propiedad general. Se agregó compatibilidad con el tipo de derechos lyric.
      policies.insert
      policies.update
      policies.patch
      • invalidValue: La solicitud contiene una regla de política no válida porque la API no admite la creación ni la modificación de políticas que especifiquen una acción takedown. Este error, que informa un motivo de invalidPolicyTakedownAction, reemplaza el error invalidPolicyConditionalTakedown obsoleto.
      references.insert
      • badRequest: La solicitud debe enviar un archivo multimedia o especificar un valor para el parámetro de solicitud claimId. Sin embargo, una solicitud no puede enviar un archivo multimedia y especificar un valor para el parámetro de solicitud claimId.
      • badRequest: Ya se creó una referencia para el mismo contenido a partir de un reclamo diferente en el mismo video de YouTube.
      • badRequest: La API no admite la capacidad de establecer un valor para la propiedad fpDirect cuando se crea una referencia.
      • internalError: Hay un problema con el archivo multimedia que se subió.
      • invalidValue: El valor del parámetro de la solicitud contentType, assetId o claimId no es válido. El error identifica el valor no válido.
      • notFound: No se puede encontrar el recurso o el reclamo que especificaste. Verifica los valores de los parámetros assetId y claimId en tu solicitud.
      • required: La solicitud debe especificar un valor para el parámetro contentType.
      references.insert
      references.update
      references.patch
      • invalidValue: Los excludedIntervals especificados para la referencia no son válidos. Ten en cuenta que no puedes especificar intervalos de exclusión cuando desactivas una referencia.

10 de mayo de 2013

Esta actualización incluye los siguientes cambios:

8 de abril de 2013

Esta actualización incluye los siguientes cambios:

  • Se cambió el nombre de la API a API de YouTube Content ID.

  • Varias propiedades cambiaron en el recurso assetMatchPolicy:

    • El valor de la propiedad kind cambió de youtubePartner#policy a youtubePartner#assetMatchPolicy.
    • La nueva propiedad policyId contiene un valor que identifica de forma exclusiva un recurso de política guardada.
    • El valor de la propiedad rules[].subaction ahora es una lista de cadenas en lugar de una sola cadena.
    • El valor de la propiedad rules[].conditions.contentMatchType ahora es una lista de cadenas en lugar de una cadena.
    • Se quitaron las propiedades id, name y description.

  • Se actualizó la documentación del método assetMatchPolicy.update para reflejar el hecho de que puedes establecer valores para la propiedad policyId o el objeto rules[] cuando llames al método.

  • El recurso claims ahora admite varias propiedades nuevas:

    Nombre de la propiedad Valor Descripción
    timeCreated datetime Es la fecha y hora en la que se creó el reclamo.
    matchInfo object El objeto matchInfo contiene información sobre el contenido coincidente que generó el reclamo. Esta información solo se incluye en un recurso claim si el reclamo se generó automáticamente porque un video subido coincidió con un archivo de referencia existente.
    matchInfo.referenceId string Es el ID único que YouTube usa para identificar el reference de referencia que generó la coincidencia.
    matchInfo.longestMatch object El objeto longestMatch contiene información sobre la coincidencia más larga entre la referencia y el video subido.
    matchInfo.longestMatch.durationSecs unsigned long Es la duración de la coincidencia, en segundos.
    matchInfo.longestMatch.userVideoOffset unsigned long Es el desplazamiento de tiempo cuando comienza la coincidencia, medido en segundos desde el principio del video subido.
    matchInfo.longestMatch.referenceOffset unsigned long Es el desfase de tiempo cuando comienza la coincidencia, medido en segundos desde el principio de la referencia.
    matchInfo.totalMatch object El objeto totalMatch contiene información sobre el importe total del video subido que coincidió con la referencia y sobre el importe total de la referencia que coincidió con el video subido. Estos valores pueden diferir si el contenido coincidente se reproduce en un bucle en el video subido o en la referencia. Por ejemplo, si un video subido incluye un clip de 10 segundos de una referencia, pero el clip se repite seis veces, el total de contenido coincidente en el video subido es de 60 segundos, pero el total de contenido coincidente en la referencia es de solo 10 segundos.
    matchInfo.totalMatch.userVideoDurationSecs unsigned long Es la duración total, en segundos, del contenido del video subido que coincide con la referencia.
    matchInfo.totalMatch.referenceDurationSecs unsigned long Es la duración total, en segundos, del contenido de referencia que coincide con el video subido.
    origin object El objeto origin contiene información que describe la fuente del reclamo.
    origin.source string Es la fuente del reclamo.

  • Se actualizó la propiedad policy en el recurso claims para indicar que el valor no se puede actualizar para un reclamo de AudioSwap.

  • Se cambió el nombre de la propiedad timeProvidedMs del recurso metadataHistory a timeProvided.

  • Se cambió el nombre de la propiedad timeProvidedMs del recurso ownershipHistory a timeProvided.

  • Se actualizó la definición del método ownershipHistory.list para indicar que solo recupera los datos de propiedad más recientes de cada propietario del contenido. Sin embargo, si el propietario del contenido ha presentado datos de propiedad a través de múltiples fuentes de datos (API, canales de contenido, etc.), la lista contendrá los datos más recientes de cada propietario del contenido y de cada fuente de datos.

  • Varias propiedades cambiaron en el recurso policy:

    • Se cambió el nombre de la propiedad rule por rules.
    • El valor de la propiedad rules[].subaction ahora es una lista de cadenas en lugar de una sola cadena.
    • El valor de la propiedad rules[].conditions.contentMatchType ahora es una lista de cadenas en lugar de una sola cadena.

  • Se actualizó la documentación de los métodos policies.insert y policies.update para reflejar el hecho de que puedes establecer valores para el objeto rules[] cuando llames a esos métodos.

  • Varios métodos de la API admiten nuevos tipos de errores. En la siguiente tabla, se identifica el método y, de forma breve, los tipos de errores admitidos recientemente. En muchos casos, puede haber varios errores para un tipo determinado. Por ejemplo, se muestra un error required si intentas insertar un recurso asset al que le falta un campo de metadatos obligatorio. De hecho, puede haber más de un campo de metadatos obligatorio, cada uno de los cuales mostrará un error con un mensaje ligeramente diferente.

    Para obtener más información, consulta la documentación de errores de cada método o la página Errores.

    Método Errores
    assets.insert
    • invalidValue: Un campo de metadatos de activo contiene un valor no válido.
    • required: Falta un campo de metadatos de activo obligatorio.
    assets.update
    assets.patch
    • forbidden: El socio que intenta completar la actualización no es propietario del recurso que se está actualizando.
    • invalidValue: Un campo de metadatos de activo contiene un valor no válido.
    • notFound: El activo se asocia con un activo de temporada o de programa que no se puede encontrar.
    • required: Falta un campo de metadatos de activo obligatorio.
    claims.insert
    • badRequest: La solicitud intenta reclamar un video, pero no se permite.
    ownership.update
    ownership.patch
    • badRequest: La solicitud define una propiedad total superior al 100% en un territorio.
    policies.insert
    policies.patch
    policies.update
    • conflictingPolicyRules: La política contiene reglas de políticas en conflicto.

  • En la nueva página errors, se enumeran los errores que puede mostrar la API. La página incluye errores generales, que pueden ocurrir en varios métodos de API diferentes, así como errores específicos del método.

18 de enero de 2013

Esta actualización incluye los siguientes cambios:

  • El método videoAdvertisingOptions.getEnabledAds recientemente documentado te permite recuperar detalles sobre los tipos de anuncios permitidos para un video subido por un socio o un usuario específico.

  • Se actualizó la definición del parámetro ownershipRestriction del método assetSearch.list para indicar que el valor predeterminado del parámetro es mine, lo que indica que la API solo debe recuperar los recursos que pertenecen al usuario actual.

  • La documentación del método assets.list refleja los siguientes cambios:

    • El parámetro id ahora es obligatorio.

    • El parámetro fetchMatchPolicy recientemente admitido te permite indicar si la solicitud a la API también debe recuperar la política de coincidencias que estableciste para el activo.

    • El parámetro fetchOwnership recientemente admitido te permite indicar si la solicitud a la API también debe recuperar los datos de propiedad del activo.

    • La lista de recursos que muestra la API ya no contiene datos de paginación. Como resultado, la propiedad nextPageToken y el objeto pageInfo se quitaron de la respuesta de la API. El objeto pageInfo contenía las propiedades totalResults, resultsPerPage y startIndex.

  • Se actualizó la documentación del recurso claims para indicar que debes especificar una política cuando crees un reclamo. (Actualmente, YouTube no aplica tu política de uso predeterminada si un reclamo insertado no especifica una política, aunque la documentación indicaba que sí sucedía).

  • La propiedad hasUnpublishedDraft del recurso policy dejó de estar disponible.

  • El parámetro id recientemente admitido del método policies.list te permite identificar las políticas guardadas que debe recuperar la solicitud de API. Solo se pueden recuperar las políticas que pertenecen al propietario del contenido autenticado actualmente.

  • Se actualizó la definición del parámetro releaseClaims para los métodos references.patch y references.update para indicar que el parámetro solo funciona cuando el estado del reclamo se actualiza a inactive. En ese caso, también puedes establecer el valor del parámetro releaseClaims en true para liberar todos los reclamos de coincidencia que produce la referencia.

  • Los métodos references.patch y references.update se actualizaron para indicar que debes especificar el estado de la referencia cuando realices cualquiera de estas operaciones.

  • Varios métodos de la API admiten nuevos tipos de errores. En la siguiente tabla, se identifican el método y los errores admitidos recientemente:

    Método Tipo de error Detalle del error Descripción
    guideCategories.list notFound Unavailable No se puede encontrar el activo para el que intentas recuperar la política de coincidencias.
    claims.get notFound Unavailable No se puede encontrar el reclamo que intentas recuperar.
    ownership.patch invalidValue Unavailable Los datos de propiedad que proporcionaste contienen un valor no válido.
    ownership.update invalidValue Unavailable Los datos de propiedad que proporcionaste contienen un valor no válido.