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

Nota: La API de Content ID de YouTube se diseñó para que la usen los socios de contenido de YouTube, por lo que no todos los desarrolladores ni todos los usuarios de YouTube pueden acceder a ella. Si la API de Content ID de YouTube no aparece como uno de los servicios enumerados en la Consola de API de Google, consulta el Centro de ayuda de YouTube para obtener más información sobre el Programa de socios de YouTube.

Esta página enumera los cambios y las actualizaciones de la documentación de la API de Content ID de YouTube.

10 de noviembre de 2023

Se actualizó el campo adFormats[] del recurso videoAdvertisingOption a fin de que third_party_ads 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:

• Actualizaciones de recursos y métodos existentes

  • El campo breakPosition[] del recurso videoAdvertisingOption se marcó como obsoleto y se quitará en 2024.
    Los métodos videoAdvertisingOptions.update y videoAdvertisingOptions.patch ya ignoran el campo.
  • Se quitó el campo adBreaks[].slot[] obsoleto del recurso videoAdvertisingOption.
  • Se quitaron los campos category y showCustomId obsoletos del recurso asset.
  • El nuevo campo timeStatusLastModified del recurso claim informa la hora en que se modificó una reclamación por última vez.
  • Se puede usar el parámetro isVideoShortsEligible del nuevo método claimSearch.list para filtrar los videos reclamados según su elegibilidad para YouTube Shorts.

• Recursos y métodos nuevos

  • Ahora la API admite mostrar una lista de los recursos de YouTube Music:
    • Los recursos musicRelease se pueden enumerar con el método musicReleases.list.
    • Los recursos musicTrack se pueden enumerar con el método musicTracks.list.
    • Los recursos musicChangeRequest se pueden enumerar con el método musicChangeRequests.list.

20 de diciembre de 2022

Se actualizó la definición del parámetro de búsqueda 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 una modificación 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 a fin de aclarar cómo se admiten varios valores para lo siguiente:

• fetchMatchPolicy (get, list)
• fetchMetadata (get, list)
• fetchOwnership (get, list)

28 de septiembre de 2022

Se agregó información sobre la posibilidad de obtener licencias 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 había quitado la compatibilidad con Audio Swap y Song Erase. Se ignoraron en silencio los valores correspondientes de la API, audio_removed y song_erased, y no se documentaron.
• Se reemplazó channel_whitelisted por channel_allowlisted. El valor anterior ya no se documenta, pero todavía 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 cadena, y cada valor especifica un ISRC o ISWC, según corresponda, que se asigna al activo identificado por el resultado de la búsqueda.

Se recomienda usar las propiedades nuevas en lugar de las propiedades isrc y iswc que ya se incluyen en los recursos assetSearch, ya que proporcionan datos más precisos. Mientras que las propiedades nuevas pueden enumerar un array de valores de strings, 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 generadas previamente para PHP.

3 de mayo de 2022

El parámetro status del método claimSearch.list ahora admite más filtros en función de los detalles del reclamo potencial.

2 de mayo de 2022

Se actualizó la documentación de la Respuesta del método assetSearch.list a fin de reflejar las mejoras de coherencia con AIP-158:

• La descripción de pageInfo.totalResults menciona de forma explícita 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 / 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:

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

Cada caso de uso admite un conjunto diferente de parámetros de consulta. Se actualizó la documentación del método claimSearch.list a fin de explicar qué parámetros son compatibles para 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 las 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 referencias al recurso contentOwnerAdvertisingOptions y sus métodos. Estos métodos se usaban muy poco, y antes de este anuncio se contactó a los usuarios de la API que sí los usaban.

21 de marzo de 2018

Esta actualización incluye los siguientes cambios:

• Ahora se debe configurar la propiedad metadataMine.artist cada vez que insertes, actuales o parches un activo de video musical o grabación de sonido. Ahora, la API 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 es compatible con 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 envían a través de la Web, SFTP o un mecanismo de entrega diferente. La API admite dos métodos para este recurso:

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

• Para el método validator.validate, se actualizó la definición de la propiedad uploaderName a fin de 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 específica de quien sube el video 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 referencia. 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, como antes, la propiedad duplicateLeader del recurso solo se propaga si la referencia es un duplicado. Si se configura, 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 elementos de composición identifica una relación entre dos representaciones de un recurso de elemento. 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, lo que se denomina vista de composición. Los metadatos del activo representan el conjunto canónico de información que muestra YouTube sobre los derechos de composición asociados a una grabación determinada y puede 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 publicador 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 realizar cualquiera de las siguientes acciones:

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

• La nueva guía Cómo administrar activos de composición explica cómo los diferentes métodos de la API manejan las solicitudes en función de si los ID 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. Aunque la propiedad afecta a todos los videos del propietario del contenido que duren más de 10 minutos, si un video tiene varios reclamos, el primer socio que reclame un video establecerá el comportamiento predeterminado de esa 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 de forma detallada en el Blog para desarrolladores e ingenieros de YouTube, proporcionan un conjunto completo 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 explicar las políticas que deben seguir los desarrolladores.

  El conjunto completo de documentos nuevos se describe en el historial de revisión de las Condiciones actualizadas. Además, los próximos cambios que se realicen en las Condiciones actualizadas o en esos documentos de respaldo también se explicarán en ese historial de revisión. Puedes suscribirte a un feed RSS que indique 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:

• Recursos y métodos nuevos

  • El nuevo método validator.validate 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 contendrá una lista de errores de validación en la que se identificará la gravedad, la causa y la ubicación de cada uno.

• Errores nuevos y actualizados

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

    Errores
    invalidValue (400)	parameters.assetId No se pudo completar la solicitud porque el activo que se actualizaba se combinó con otro activo. Vuelve a enviar la solicitud con el ID del recurso, 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 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 una parte del video de referencia. Un reclamo puede 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.

    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 horarias en las que comienza y termina cada segmento coincidente tanto en el video reclamado como en el video 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. Como recordatorio, un método puede admitir varios errores que tienen el mismo tipo de error. Consulta la documentación de errores de cada método o la página errores para obtener una lista completa de los posibles errores.

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

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

  • Se actualizó la documentación de error de 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 exitosa, es posible que la referencia no se procese correctamente. Te recomendamos que, después de insertar una referencia, sondees con el método references.list para confirmar que la referencia esté activada como se espera.

3 de febrero de 2016

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • La API ahora admite anuncios de ficha de producto. Los anuncios de ficha de producto destacan los productos que están 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, se puede incluir product_listing en los valores de las siguientes propiedades:

    Recurso/método de API	Propiedad
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

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

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

  • 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 se recuperan 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 específicos por los que se volvieron inactivos. La definición del parámetro enumera los tipos de reclamos inactivos que puedes buscar.
    partnerUploaded	Este parámetro booleano opcional te permite especificar que la respuesta de la API solo debe incluir reclamaciones subidas por socios o no subidas por socios.

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

  • El método references.insert ahora permite 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 mostrará un error si intentas establecer la propiedad fpDirect cuando subes una referencia.

• Errores nuevos y actualizados

  En la documentación, ahora se enumeran 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. Consulta la documentación de errores de cada método o la página de errores para obtener más información.

  Errores
  badRequest (400)	inappropriateCampaignTarget Los métodos campaigns.insert y campaigns.update muestran este error si una campaña intenta destacar un video que puede ser inapropiado para algunos usuarios. Para solucionar el error, elige otro contenido para destacar.
  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 para la 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 la solicitud no especificó un assetId.
  badRequest (400)	canNotBeActivated El método references.update muestra este error si la referencia no se puede activar, posiblemente debido al estado de la referencia o a las condiciones de propiedad.
  badRequest (400)	videoNotClaimed El método videoAdvertisingOptions.get muestra este error si no reclamas el video para el que intentas recuperar las opciones de publicidad, por lo que la información solicitada no está disponible para ti.

18 de diciembre de 2015

Las leyes de la Unión Europea (UE) exigen que se proporcionen ciertas divulgaciones a los usuarios finales de la UE y se obtenga el consentimiento de ellos. Por lo tanto, en el caso de los usuarios finales de la Unión Europea, debe 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:

• El nuevo recurso campaign representa una campaña de propietario de contenido específica, que le permite usar anotaciones para promocionar contenido en videos reclamados y subidos por usuarios. Por ejemplo, un propietario del contenido podría crear una campaña en la que se agreguen vínculos a la página de reproducción de una película para los videos reclamados y subidos por usuarios que contengan escenas de esa película.

  La API admite métodos para los recursos campaign get, list, insert, update, patch y delete.

• La API admite varios errores nuevos para los nuevos métodos campaigns.get, campaigns.insert, campaigns.update y campaigns.delete.

30 de marzo de 2015

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • El nuevo parámetro isrcs del método assetSearch.list te permite especificar una lista de hasta 50 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 forma cronológica inversa (de más recientes a más antiguos) según las fechas en las que se crearon. También puedes ordenar los recursos de mayor a menor cantidad 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 ordenarán por el momento en que vence el período de revisión de reclamaciones.

  • Los métodos ownership.update y ownership.patch ahora enumeran 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 su funcionalidad.

  • Los parámetros fetchMatchPolicy para los métodos assets.get y assets.list ahora muestran effective como un valor admitido. El valor indica al servidor de la API que recupere la política de coincidencias que YouTube aplica para el 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.

  Consulta la documentación de errores de cada método o la página de errores para obtener más información.

  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 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 la marca blockOutsideOwnership de la reclamación no se modificó correctamente. Existen varios motivos por los que puede ocurrir este error. Un ejemplo común es cuando la modificación especificada no afecta al video reclamado.

7 de noviembre de 2014

Esta actualización incluye los siguientes cambios:

• Actualizaciones de 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 activo.

  • 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 una reclamación, ahora admite el valor melodyMatch. Un reclamo por 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 a fin de 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 nuevo archivo de referencia, el extremo correcto es:

      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.

  Consulta la documentación de errores de cada método o la página de errores para obtener más información.

  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 etiquetas deben tener entre dos y 30 caracteres. No pueden contener corchetes angulares, comas, dos puntos, signos 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 el propietario del 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 recurso 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 se suspende debido a 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 elementos 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

  Los cambios en el ID del propietario del contenido anunciados en el historial de revisión el 9 de julio de 2014 entraron en vigor. 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 con un recurso administrado a través de la API. Anteriormente, la API mostraba un nombre legible como ID, como "qrs_network".

  Este cambio afecta las siguientes funciones de la API y probablemente afecte a los socios que tienen códigos de socio hard-coded en sus aplicaciones.

  • La API ahora muestra el ID nuevo como el valor de las propiedades del recurso 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. Luego del cambio, el parámetro se debe establecer en el ID nuevo en lugar del código de socio. Para evitar fallas en el 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 de socio.

• Actualizaciones de recursos y métodos existentes

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

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

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

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

    2. Tiene en cuenta las políticas administrativas de YouTube que se aplican en los territorios en los que el propietario del contenido es 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:

• Recursos y métodos nuevos

  • El nuevo recurso assetLabel identifica una etiqueta de texto que se puede asignar a un elemento. Las etiquetas de activos te permiten ubicar activos en categorías personalizadas, lo que facilita la organización de tu biblioteca de activos. 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 del contenido.
    • El método assetLabels.insert te permite crear una nueva etiqueta de activo. 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 antes no estaba definida.

• Actualizaciones de recursos y métodos existentes

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

    En la nueva guía Cómo usar las etiquetas de activos, se explica cómo crear y recuperar etiquetas de activos y cómo actualizarlas o buscar activos asociados con etiquetas específicas.

• Errores nuevos y actualizados

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

9 de julio de 2014

Esta actualización incluye los siguientes cambios:

• Cambios en el ID de propietario del contenido

  Históricamente, la API ha utilizado un código de socio legible, como "qrs_network", para identificar de forma única al propietario del contenido asociado con el usuario autenticado o con un recurso administrado a través de la API. En el tercer trimestre de 2014, la API cambiará y usará un ID único de 22 caracteres para identificar a los propietarios del contenido. El cambio afecta las siguientes funciones de la API y probablemente afecte a los socios que tienen códigos de socio hard-coded en sus aplicaciones.

  • La API mostrará el ID de 22 caracteres como el valor de las propiedades del recurso que mostraron previamente 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. Luego del cambio, el parámetro se debe configurar con el ID de 22 caracteres en lugar del código de socio. Para evitar fallas en el 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 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 en forma masiva, 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 elementos asociados con las etiquetas especificadas. Según la configuración predeterminada, la API muestra elementos 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: Si se usa junto con el parámetro labels, este parámetro le indica a los elementos que se muestran de la API que se asocian con cualquiera de las etiquetas especificadas en el valor del parámetro labels.

  • Un recurso claimHistory ahora contiene las siguientes propiedades nuevas:

    • La propiedad event[].source.userEmail proporciona la dirección de correo electrónico del usuario que inició el evento.
    • La propiedad event[].typeDetails.disputeNotes contiene notas de disputa para un evento dispute_create.

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

    • createdAfter: Restringe los resultados para que solo incluyan los 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: Si se usa junto con el parámetro videoId, se indica si se deben incluir reclamaciones de terceros en los resultados de la API.

• Información más detallada del error

  La documentación sobre 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.

  Consulta la documentación de errores de cada método o la página de errores para obtener más información.

  Método	Errores
  assetSearch.list	invalidValue: la API no admite la capacidad de buscar elementos de programa o temporada. 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 elemento especificado. invalidValue: El usuario que llama a la API no tiene permiso para crear elementos del tipo especificado.
  assets.patch assets.update	badRequest: la API no admite la conversión del tipo de elemento que intentaste.
  claimSearch.list	badRequest: El parámetro includeThirdPartyClaims solo se puede usar junto con el filtro videoId.
  ownership.patch ownership.update	badRequest: No puedes actualizar la propiedad de un activo de pista con portada.
  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 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ó la reclamación.
    • La propiedad thirdPartyClaim contiene un valor booleano que indica si el reclamo lo realizó un propietario de contenido distinto del que está 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 solo audio, de video o audiovisuales.
    • origin: Especifica uno o más orígenes de reclamos, como descriptiveSearch o videoMatch, para los que quieres 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 en los que no tiene su propiedad explícita. Según la configuración predeterminada, un video reclamado se podrá ver en los países donde no se hayan 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 los momentos de pausa que YouTube determina automáticamente.

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

  • La nueva propiedad timeUpdated del recurso policy especifica la hora en 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 hora en que se actualizaron por última vez.

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

  • La nueva propiedad autoGeneratedBreaks del recurso videoAdvertisingOption indica si el video debe mostrar anuncios in-stream y durante el video en los momentos de pausa que YouTube determina automáticamente.

• 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.

  Consulta la documentación de errores de cada método o la página de errores para obtener más información.

  Método	Errores
  assets.insert assets.update	badRequest: La API no admite operaciones de escritura en activos de pistas con portada.
  claimSearch.list	invalidValue: El parámetro pageToken en 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, comunícate con 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 ha presentado una contranotificación a 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: se borró o rechazó el video reclamado que intentas usar, o bien se produjo un error en su procesamiento.

• Los errores contentOwnerNotProvided y internalError, que no son específicos de un método de API en particular, ya no se muestran en la página de cada método. Puedes encontrar sus descripciones 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:

• Recursos y métodos nuevos

  • El nuevo recurso referenceConflict identifica un conflicto entre dos archivos de referencia y enumera las coincidencias que existían entre esos archivos cuando se identificó el conflicto. El método referenceConflicts.list permite recuperar una lista de conflictos de referencia sin resolver 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 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 paralelo a los cambios publicados el 16 de julio de 2013, que incluían compatibilidad para recuperar el conjunto canónico de metadatos y datos de propiedad de un activo.

    Para recuperar la política de coincidencias vigente para 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 en cada recurso asset que se muestra contiene la política de coincidencias 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 diferente de derechos que puede tener el propietario de un activo. (en la mayoría de los tipos de elementos, los propietarios pueden simplemente tener la propiedad general del elemento, pero en el caso de los activos de composición, los propietarios pueden detallar la propiedad de los derechos de ejecución, derechos de sincronización o derechos mecánicos).

    De manera similar, el objeto ownershipConflicts contiene listas separadas que identifican conflictos de derechos de propiedad general, derechos de rendimiento, derechos de sincronización y derechos mecánicos. Para cada conflicto, los datos identifican los territorios en los que se produce el conflicto, los propietarios que proporcionaron datos de propiedad en conflicto y el porcentaje del elemento que cada propietario en conflicto demanda como propietario.

  • 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 de la API debe recuperar los conflictos de propiedad de los elementos en la respuesta de la API. El valor predeterminado es false, lo que significa que no se muestran los conflictos de propiedad.

  • Se actualizó la definición del parámetro q del método assetSearch.list para identificar los campos de metadatos en los que se 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 reflejar adecuadamente 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, y que indica que una cuenta de servicio no puede autorizar la operación solicitada.

  • El método assets.insert ahora identifica errores de metadatos como ocurre 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.

  • La página errors se actualizó de modo que, para cada recurso que admite los métodos update y patch, la página contenga una tabla que enumera los errores que muestran esos dos métodos. Anteriormente, en la página se enumeraban 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:

• Recursos y métodos nuevos

  • El nuevo método claimHistory.get 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, impugnación o cierre.

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

    • Los reclamos se asocian con un activo específico.
    • Los reclamos se asocian con un video específico.
    • Las reclamaciones coinciden con una cadena de consulta proporcionada en la solicitud.

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

• Actualizaciones de recursos y métodos existentes

  • En la documentación, ahora se enumeran 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.

  • Para 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 impactos de esos cambios en los métodos de API que get, list, insert, update o patch asset.

    • 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 proporcionados por el propietario del contenido que realiza la solicitud a la API y el conjunto canónico de metadatos que YouTube determina que es el conjunto de metadatos más preciso y completo para el activo.

    • De manera similar, se reemplazó el objeto ownership 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 para un recurso).

    Nota: Para garantizar la retrocompatibilidad, si solo se solicita una versión de metadatos, un conjunto de datos de propiedad o una política de coincidencias para un elemento, la respuesta de la API incluirá el objeto obsoleto y el nuevo objeto admitido. 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, ambos con los mismos datos. (Se admitía la capacidad de configurar fetchMetadata=mine antes de la actualización de funciones, 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 configurar fetchMetadata=mine,effective no era compatible antes de esta actualización de función, por lo que no es necesario devolver el objeto metadata para retrocompatibilidad). El mismo principio también se aplica a los parámetros fetchOwnership y fetchMatchPolicy.
    
    De manera similar, para lograr la retrocompatibilidad, una solicitud a insert, update o patch, un recurso asset puede incluir el objeto metadataMine o metadata. El mismo principio se aplica a la configuración de los datos de propiedad de un recurso asset o la política de coincidencias.

  • 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 es compatible con 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 muestra una lista de 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ó al asociar un activo a 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 intente hacer coincidir la referencia. Cada intervalo especifica un tiempo de inicio y finalización medidos en segundos desde el inicio del video.

  • La API ya no requiere que se configure 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 a fin de 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: el ID que YouTube utiliza para identificar de forma exclusiva el video reclamado asociado con la configuración.

    • adBreaks: Es una lista de objetos en la que cada objeto contiene información sobre un punto antes, durante o después de la reproducción de video en la que se permiten la ejecución de anuncios. Cada objeto también puede especificar otros atributos de la pausa publicitaria, como los espacios publicitarios que se producen 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 objeto identifica una lista de territorios y los formatos de anuncios que se utilizan durante las reproducciones 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.

    Consulta la documentación de errores de cada método o la página de errores para obtener más información.

    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 están asociados con las mismas propiedades secundarias en el objeto metadataMine.
    claimHistory.get	notFound: no se puede encontrar el reclamo del 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 o 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 nombre del cual actúas no tiene permiso para crear políticas con la acción especificada. invalidValue: el propietario del contenido en nombre del cual 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 solamente uno de los siguientes parámetros de filtro: fetchMine o 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 activo de composición debe especificar los datos de propiedad detallados de &ndahs; derechos de mechanical, performance, synchronization o lyric, en lugar de derechos de propiedad de general. Se admite el tipo de derechos lyric recientemente.
    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 o modificación de políticas que especifican una acción takedown. Este error, que informa un motivo de invalidPolicyTakedownAction, reemplaza el error invalidPolicyConditionalTakedown que dejó de estar disponible.
    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 ni 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 subido. invalidValue: El valor del parámetro de solicitud contentType, assetId o claimId no es válido. El error identifica el valor no válido. notFound: no se puede encontrar el activo 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:

• YouTube ya no identifica elementos y servicios experimentales de la API. En cambio, ahora se ofrece una lista de las API de YouTube que están sujetas a la política de baja.

8 de abril de 2013

Esta actualización incluye los siguientes cambios:

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

• Cambiaron varias propiedades 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 manera única un recurso de política guardado.
  • El valor de la propiedad rules[].subaction ahora es una lista de cadenas en lugar de una 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 llamas al método.

• El recurso claims ahora admite varias propiedades nuevas:

  Nombre de la propiedad	Valor	Descripción
  timeCreated	datetime	Fecha y hora en que se creó la reclamación.
  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	El ID único que YouTube utiliza para identificar la referencia reference 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	La duración de la coincidencia, en segundos.
  matchInfo.longestMatch.userVideoOffset	unsigned long	El tiempo de desfase cuando comienza la coincidencia, medido en segundos desde el principio del video que se subió.
  matchInfo.longestMatch.referenceOffset	unsigned long	El tiempo de desfase cuando comienza la coincidencia, medido en segundos desde el principio de la referencia.
  matchInfo.totalMatch	object	El objeto totalMatch contiene información sobre la cantidad total del video subido que coincidió con la referencia y sobre la cantidad total de la referencia que coincidió con el video subido. Estos valores pueden diferir si el contenido coincidente se ejecuta 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 este se repite seis veces, el contenido coincidente total en el video subido es de 60 segundos, pero el contenido coincidente total 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 de la reclamación.
  origin.source	string	Es la fuente de la reclamación.

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

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

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

• Se actualizó la definición del método ownershipHistory.list para indicar que el método 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.

• Cambiaron varias propiedades 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 cadena.
  • El valor de la propiedad rules[].conditions.contentMatchType ahora es una lista de cadenas en lugar de una 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 llamas a esos métodos.

• Varios métodos de API admiten nuevos tipos de error. En la siguiente tabla, se identifica el método y se identifican brevemente 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.

  Consulta la documentación de errores de cada método o la página de errores para obtener más información.

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

• En la nueva página de errores, se indican los errores que puede mostrar la API. La página incluye errores generales, que pueden ocurrir para 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 recién documentado te permite recuperar detalles sobre los tipos de anuncios permitidos para un video específico subido por un socio o un usuario.

• 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 elementos que son propiedad del usuario actual.

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

  • El parámetro id ahora es obligatorio.

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

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

  • La lista de elementos 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 creas una reclamación. (YouTube no aplica actualmente tu política de uso predeterminada si un reclamo insertado no especifica una política, a pesar de que la documentación indicaba que eso sí sucedió).

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

• El parámetro id recién admitido del método policies.list te permite identificar las políticas guardadas que la solicitud a la API debe recuperar. 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 a fin de indicar que el parámetro solo funciona cuando el estado de la reclamación se actualiza a inactive. En ese caso, también puedes establecer el valor del parámetro releaseClaims en true para retirar todos los reclamos de coincidencias que generó la referencia.

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

• Varios métodos de API admiten nuevos tipos de error. En la siguiente tabla, se identifica 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 elemento cuya política de coincidencias intentas recuperar.
  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.