API YouTube Content ID – Historique des révisions

Remarque:L'API YouTube Content ID est destinée aux partenaires de contenus YouTube. Elle n'est pas accessible à tous les développeurs ni à tous les utilisateurs de YouTube. Si l'API YouTube Content ID ne figure pas parmi les services listés dans la console Google APIs, consultez le Centre d'aide YouTube pour en savoir plus sur le Programme Partenaire YouTube.

Cette page liste les modifications apportées à l'API YouTube Content ID et les mises à jour de la documentation.

26 mars 2025

À partir du 31 mars 2025, YouTube modifiera la façon dont les vues des Shorts sont comptabilisées. Auparavant, une vue était comptabilisée pour les Shorts lorsqu'ils étaient regardés pendant un certain nombre de secondes. Désormais, les vues comptabilisent le nombre de fois qu'un Short commence à être regardé ou est regardé à nouveau, sans durée de visionnage minimale requise. En savoir plus

D'ici le 30 juin 2025, l'API Content ID sera mise à jour comme suit:

• Les ordres de tri de claimSearch.list.sort seront mis à jour :
  • DAILY_ENGAGED_VIEWS sera ajouté pour le nombre de vues quotidien, selon la méthode de comptabilisation précédente.
  • LIFETIME_ENGAGED_VIEWS sera ajouté au nombre de vues sur toute la durée de vie en fonction de la méthodologie de comptabilisation des vues précédente.
• Les ordres de tri de assetSearch.list.sort seront mis à jour :
  • DAILY_ENGAGED_VIEWS sera ajouté pour le nombre de vues quotidien, selon la méthode de comptabilisation précédente.

D'ici le 30 septembre 2025, l'API Content ID sera mise à jour comme suit:

• L'ordre de tri VIEWS sera abandonné.assetSearch.list.sort
• L'ordre de tri VIEW_COUNT sera abandonné.claimSearch.list.sort
• claimSearch.claimSnippet.videoViews sera mis à jour pour refléter la nouvelle méthode de comptabilisation des vues des Shorts.
• claimSearch.claimSnippet.engagedViews sera ajouté pour le nombre de vues selon la méthode de comptabilisation précédente

14 janvier 2025

Le champ autoGeneratedBreaks[] de la ressource videoAdvertisingOption a été mis à jour, car nous autorisons désormais à fournir ad_breaks et autoGeneratedBreaks en même temps. Si autoGeneratedBreaks est défini sur "true" pour une vidéo avec adBreaks défini, nos systèmes identifieront des emplacements pour diffuser des annonces en plus de ceux que vous avez définis manuellement. Pour en savoir plus, consultez cet article d'assistance.

10 novembre 2023

Le champ adFormats[] de la ressource videoAdvertisingOption a été mis à jour afin que third_party soit la seule valeur valide pour ce champ. Les formats d'annonces suivants ne sont plus acceptés: instream_trueview, instream_standard, display, preroll et postroll. Pour en savoir plus, consultez cet article d'aide.

1er juin 2023

Remarque:Il s'agit d'une annonce d'abandon.

Cette mise à jour inclut les modifications suivantes :

• Mises à jour des ressources et méthodes existantes

  • Le champ breakPosition[] de la ressource videoAdvertisingOption a été marqué comme obsolète et sera supprimé en 2024.
    Les méthodes videoAdvertisingOptions.update et videoAdvertisingOptions.patch ignorent déjà le champ.
  • Le champ adBreaks[].slot[] obsolète de la ressource videoAdvertisingOption a été supprimé.
  • Les champs category et showCustomId obsolètes de la ressource asset ont été supprimés.
  • Le champ timeStatusLastModified de la nouvelle ressource claim indique l'heure à laquelle une revendication a été modifiée pour la dernière fois.
  • Le paramètre isVideoShortsEligible de la nouvelle méthode claimSearch.list permet de filtrer les vidéos revendiquées en fonction de leur éligibilité aux Shorts YouTube.

• Nouvelles ressources et méthodes

  • L'API permet désormais de lister les ressources YouTube Music :
    • Les ressources musicRelease peuvent être listées à l'aide de la méthode musicReleases.list.
    • Les ressources musicTrack peuvent être listées à l'aide de la méthode musicTracks.list.
    • Les ressources musicChangeRequest peuvent être listées à l'aide de la méthode musicChangeRequests.list.

20 décembre 2022

La définition du paramètre de requête ownershipRestriction de la méthode assetSearch.list a été mise à jour pour préciser que si la valeur de ce paramètre est none, la valeur du paramètre metadataSearchFields doit également utiliser au moins un filtre d'ID. Cette modification de la documentation ne reflète pas un changement de comportement de l'API.

9 novembre 2022

La documentation des méthodes asset.get et asset.list a été mise à jour pour clarifier la prise en charge de plusieurs valeurs pour:

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

28 septembre 2022

Des informations sur l'éligibilité à une licence ont été ajoutées à asset resource.

18 juillet 2022

La documentation de la méthode claimSearch.list inactiveReasons a été mise à jour pour refléter les améliorations apportées à la cohérence avec YouTube Studio:

• Studio avait précédemment supprimé la compatibilité avec Audio Swap et Song Erase. Les valeurs d'API correspondantes, audio_removed et song_erased, ont été ignorées en mode silencieux et ne sont plus documentées.
• channel_whitelisted a été remplacé par channel_allowlisted. La valeur précédente n'est plus documentée, mais elle est toujours prise en charge.
• Les valeurs closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced et video_modified sont désormais acceptées.

14 juin 2022

La documentation sur la ressource assetSearch a été mise à jour pour refléter les deux nouvelles propriétés: isrcs[] et iswcs[]. Les nouvelles valeurs de propriété isrcs[] et iswcs[] contiennent chacune un tableau de valeurs de chaîne, chaque valeur spécifiant un code ISRC ou ISWC, le cas échéant, qui correspond au composant identifié par le résultat de recherche.

Les nouvelles propriétés sont recommandées par rapport aux propriétés isrc et iswc déjà incluses dans les ressources assetSearch, car elles fournissent des données plus précises. Alors que les nouvelles propriétés peuvent lister un tableau de valeurs de chaîne, les propriétés isrc et iswc n'identifient chacune qu'un seul code ISRC ou ISWC associé au résultat de recherche.

12 mai 2022

Les liens vers les bibliothèques clientes ont été mis à jour pour pointer vers les bibliothèques clientes standards des API Google. Les liaisons prégénérées pour PHP ont été mises à jour.

3 mai 2022

Le paramètre status de la méthode claimSearch.list accepte désormais davantage de filtres basés sur les informations potentielles sur la revendication.

2 mai 2022

La documentation de la réponse de la méthode assetSearch.list a été mise à jour pour refléter les améliorations apportées afin de respecter AIP-158:

• La description de pageInfo.totalResults mentionne explicitement que la valeur est une estimation et non la valeur réelle.
• Les champs pageInfo.resultsPerPage et pageInfo.startIndex ont été supprimés

25 avril 2022

La documentation de la ressource assetLabels.list a été mise à jour pour clarifier la signification des paramètres de requête labelPrefix et q, et pour indiquer que la requête / réponse est compatible avec la pagination.

8 décembre 2021

La documentation de la ressource claimSearch.list a été mise à jour pour refléter correctement les deux cas d'utilisation couverts par cette méthode:

• Rechercher par ID (élément, référence ou vidéo) ou par chaîne de requête
• Rechercher par date de création, date de modification ou état de la revendication

Chaque cas d'utilisation accepte un ensemble différent de paramètres de requête. La documentation de la méthode claimSearch.list a été mise à jour pour expliquer quels paramètres sont compatibles avec chaque cas d'utilisation.

17 novembre 2021

Cette mise à jour inclut les modifications suivantes :

• La méthode claims.update permet désormais de définir l'état d'une réclamation inactive ou potentielle sur active. La définition de la propriété status de la ressource claim fournit plus de détails.
• La documentation des ressources claim et claimSearch a été mise à jour pour refléter l'ajout du nouvel objet studioInfo, qui contient des liens vers les pages YouTube Studio associées à la réclamation.
• La liste des valeurs acceptées pour le paramètre origin de la méthode claimSearch.list a changé. Le paramètre accepte désormais quatre valeurs supplémentaires: batchTool, inProductShorts, melodyMatch et youTubeAdmin. De plus, les valeurs dropboxUpload et webUpload ne sont plus acceptées.

26 février 2021

La documentation du paramètre videoId de la méthode claimSearch.list a été mise à jour pour indiquer que la valeur du paramètre accepte désormais un maximum de 10 ID vidéo séparés par une virgule. L'API renvoie une erreur badRequest (code de réponse HTTP 400) si la valeur contient plus de 10 ID de vidéo.

6 décembre 2018

Remarque:Il s'agit d'une annonce d'abandon.

La documentation de l'API a été mise à jour pour supprimer les références à la ressource contentOwnerAdvertisingOptions et à ses méthodes. Ces méthodes étaient très peu utilisées, et les utilisateurs de l'API qui les ont utilisées ont été contactés séparément avant cette annonce.

21 mars 2018

Cette mise à jour inclut les changements suivants :

• La propriété metadataMine.artist doit désormais être définie chaque fois que vous insérez, modifiez ou appliquez un correctif un clip musical ou un enregistrement audio. L'API renvoie désormais une erreur si la propriété n'est pas définie pour ces types de ressources. Notez également que la propriété metadataMine.artist n'est compatible qu'avec les artistes de clips musicaux et d'enregistrements audio.

24 juillet 2017

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource package représente un groupe de fichiers diffusés via le Web, SFTP ou un autre mécanisme de diffusion. L'API accepte deux méthodes pour cette ressource:

  • La méthode package.insert valide et importe un package de métadonnées uniquement contenant exactement un fichier de métadonnées.
  • La méthode package.get récupère des informations sur un package importé précédemment.

• Pour la méthode validator.validate, la définition de la propriété uploaderName a été modifiée pour indiquer que la valeur n'identifie pas le partenaire de contenu qui importe les données, mais plutôt une valeur telle que web-google ou yt-google qui identifie le compte d'importateur spécifique utilisé par le propriétaire du contenu.

• La propriété status de la ressource reference n'utilise plus la valeur duplicate_on_hold pour indiquer qu'une référence est un double d'une autre référence. À la place, si une référence est un doublon, la valeur de la propriété status est désormais définie sur inactive et la valeur de la propriété statusReason sur REASON_DUPLICATE_FOR_OWNERS.

  Toutefois, comme précédemment, la propriété duplicateLeader de la ressource n'est renseignée que si la référence est en double. Si elle est définie, la valeur de cette propriété identifie la référence en double.

17 avril 2017

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource assetShare, qui n'est pertinente que pour les éléments de composition, identifie une relation entre deux représentations d'une ressource d'élément. Ces représentations reflètent un nouveau modèle de données de publication conçu pour vous offrir plus de transparence sur vos droits et un meilleur contrôle sur leur association aux éléments Enregistrement audio.

  Dans le nouveau modèle, chaque enregistrement audio est mappé sur un seul élément unique, appelé vue de la composition. Les métadonnées de cet élément représentent l'ensemble canonique d'informations que YouTube affiche sur les droits de composition associés à un enregistrement donné. Elles peuvent synthétiser des informations provenant de plusieurs fournisseurs de données.

  De plus, chaque propriétaire de la composition dispose de son propre élément Part de la composition. La part de la composition représente les informations qu'un éditeur particulier a fournies pour un élément de composition. La part de la composition peut être associée à de nombreux enregistrements audio.

  La ressource assetShare identifie une relation entre une vue de composition et un partage de composition. La nouvelle méthode assetShares.list vous permet d'effectuer les opérations suivantes:

  • Indiquez l'ID d'une vue de composition et récupérez la part de composition correspondante détenue par le partenaire autorisant la requête, le cas échéant.
  • Indiquez l'ID d'une part de composition appartenant au partenaire de contenu et récupérez la liste de toutes les vues de la composition auxquelles cette part est associée.

• Le nouveau guide Gérer les éléments de composition explique comment les différentes méthodes d'API gèrent les requêtes en fonction de la nature des ID d'éléments envoyés à ces méthodes (vues ou partages de composition).

• La nouvelle propriété claimedVideoOptions.autoGeneratedBreaks de la ressource contentOwnerAdvertisingOptions indique si YouTube doit générer automatiquement des coupures publicitaires dans les vidéos revendiquées de plus de 10 minutes. Bien que la propriété affecte toutes les vidéos de plus de 10 minutes du propriétaire du contenu, si une vidéo fait l'objet de plusieurs revendications, le premier partenaire qui revendique la vidéo définit le comportement par défaut de cette propriété pour cette vidéo.

11 août 2016

Cette mise à jour inclut les changements suivants :

• Les nouvelles conditions d'utilisation des services d'API YouTube (les "nouvelles conditions"), qui sont détaillées sur le blog YouTube Engineering and Developers, apportent de nombreuses modifications aux conditions d'utilisation actuelles. En plus des nouveaux conditions d'utilisation, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents complémentaires pour aider à expliquer les règles que les développeurs doivent suivre.

  L'ensemble complet des nouveaux documents est décrit dans l'historique des révisions des nouvelles conditions d'utilisation. De plus, les futures modifications apportées aux nouvelles conditions ou aux documents justificatifs seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS listant les modifications de cet historique des révisions à partir d'un lien dans ce document.

31 mai 2016

Cette mise à jour inclut les changements suivants :

• Nouvelles ressources et méthodes

  • La nouvelle méthode validator.validate vous permet de déterminer si un fichier de métadonnées contient des erreurs de validation qui empêcheraient YouTube de le traiter correctement. Si le fichier contient des erreurs, la propriété errors de la réponse de l'API contient une liste d'erreurs de validation, qui identifie la gravité, la cause et l'emplacement de chaque erreur.

• Nouvelles erreurs et mises à jour d'erreurs

  • Les méthodes assets.patch et assets.update sont désormais compatibles avec l'erreur suivante. Pour rappel, une méthode peut prendre en charge plusieurs erreurs ayant le même type. Pour obtenir la liste complète des erreurs possibles, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

    Erreurs
    invalidValue (400)	parameters.assetId La requête a échoué, car l'élément mis à jour a été fusionné avec un autre élément. Envoyez à nouveau la requête en utilisant l'ID de cet élément, qui est renvoyé dans le message d'erreur, comme valeur du paramètre assetId.

28 mars 2016

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • La nouvelle propriété matchInfo.matchSegments[] de la ressource claim contient une liste dans laquelle chaque élément décrit un segment de la vidéo revendiquée qui correspond à une partie de la vidéo de référence. Une revendication peut comporter plusieurs segments de correspondance. Par exemple, si le contenu audio et vidéo d'une vidéo mise en ligne correspond à celui d'une vidéo de référence, deux segments de correspondance s'affichent. L'un décrit la correspondance audio et l'autre la correspondance vidéo.

    Pour chaque segment de correspondance, l'API renvoie la durée et le type (audio ou vidéo) du contenu correspondant. L'API identifie également les décalages temporels de début et de fin de chaque segment de correspondance dans la vidéo revendiquée et la vidéo de référence.

  • La valeur de la propriété claimedVideoOptions.newVideoDefaults[] de la ressource contentOwnerAdvertisingOptions peut désormais être modifiée lorsque vous appelez les méthodes contentOwnerAdvertisingOptions.patch ou contentOwnerAdvertisingOptions.update.

  • La propriété allowedOptions.autoGeneratedBreaks en lecture seule de la ressource contentOwnerAdvertisingOptions est obsolète.

• Nouvelles erreurs et mises à jour d'erreurs

  • La méthode claims.update de l'API est désormais compatible avec l'erreur suivante. Pour rappel, une méthode peut prendre en charge plusieurs erreurs ayant le même type. Pour obtenir la liste complète des erreurs possibles, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

    Erreurs
    badRequest (400)	alreadyClaimed La revendication est un doublon d'une autre revendication existante et ne peut pas être mise à jour.

  • La méthode assets.list expire parfois et renvoie un code de réponse HTTP 500 (Internal Server Error), en particulier lorsque la requête récupère des données pour de nombreux composants et que la valeur du paramètre fetchMatchPolicy est effective. Si votre requête assets.list spécifie plusieurs ID de composant et renvoie une erreur 500, essayez de renvoyer la requête pour un seul composant ou un nombre inférieur de composants.

  • La documentation sur l'erreur references.insert a été mise à jour pour indiquer que si la requête importe un fichier de référence corrompu, ce problème n'est pas identifié tant que la référence elle-même n'est pas traitée. Par conséquent, même si la requête references.insert renvoie une réponse positive, la référence peut ne pas être correctement traitée. Nous vous recommandons, après avoir inséré une référence, d'effectuer une interrogation à l'aide de la méthode references.list pour vérifier qu'elle est activée comme prévu.

3 février 2016

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • L'API est désormais compatible avec les annonces pour une offre de produit. Les annonces de fiche produit mettent en avant des produits liés ou présentés dans le contenu d'une vidéo. Ces annonces sont des fiches sponsorisées qui s'affichent pendant la vidéo. Les fiches sont ajoutées automatiquement par le système d'annonce. Les spectateurs voient une accroche concernant la fiche pendant quelques secondes et peuvent aussi cliquer sur l'icône en haut à droite de la vidéo afin de parcourir les fiches.

    En raison de ce changement, product_listing peut désormais être inclus dans les valeurs des propriétés suivantes:

    Méthode de ressource/API	Propriété
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • Les nouveaux createdBefore et createdAfter de la méthode assetSearch.list indiquent à l'API de ne renvoyer que les composants créés avant et/ou après une date donnée.

  • Dans la réponse de l'API à une requête assetSearch.list, la propriété type accepte désormais la valeur art_track_video. Pour en savoir plus sur les vidéos d'art track, consultez le Centre d'aide YouTube.

  • La méthode claimSearch.list accepte les nouveaux paramètres suivants:

    Paramètres
    referenceId	Ce paramètre de filtre spécifie l'ID de référence YouTube de la référence pour laquelle vous récupérez les revendications.
    inactiveReasons	Ce paramètre facultatif vous permet de limiter la réponse de l'API afin qu'elle n'inclue que les revendications inactives en fonction des raisons spécifiées pour lesquelles elles sont devenues inactives. La définition du paramètre indique les types de revendications inactives pour lesquels vous pouvez effectuer une recherche.
    partnerUploaded	Ce paramètre booléen facultatif vous permet de spécifier que la réponse de l'API ne doit inclure que des revendications importées par un partenaire ou non.

  • Le nouvel objet references#origination de la ressource reference contient des informations décrivant la source de la référence.

  • La méthode references.insert permet désormais d'importer des références générées à l'aide du logiciel gfp_gen de YouTube. Si vous fournissez une empreinte prégénérée, définissez la valeur de la propriété fpDirect sur true dans la ressource reference importée.

    Notez qu'avec ce changement, l'API ne renvoie plus d'erreur si vous essayez de définir la propriété fpDirect lors de l'importation d'une référence.

• Nouvelles erreurs et mises à jour d'erreurs

  La documentation liste désormais les erreurs renvoyées par les méthodes de la ressource whitelist.

  En outre, le tableau suivant identifie les nouvelles erreurs compatibles avec l'API et les méthodes pouvant renvoyer chacune d'elles. Notez qu'une méthode peut renvoyer plusieurs erreurs ayant le même type d'erreur. Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

  Erreurs
  badRequest (400)	inappropriateCampaignTarget Les méthodes campaigns.insert et campaigns.update renvoient cette erreur si une campagne tente d'utiliser une vidéo qui peut être inappropriée pour certains utilisateurs. Pour résoudre ce problème, veuillez choisir un autre contenu à mettre en avant.
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets La méthode claims.insert renvoie cette erreur si vous essayez de créer une revendication importée par un partenaire avec un élément de composition ou d'enregistrement audio.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim La méthode claims.insert renvoie cette erreur si une revendication existe déjà pour la musique enregistrée dans la vidéo spécifiée. Vous ne pouvez pas ajouter de revendications de composition directe via l'API.
  badRequest (400)	asset_id La méthode references.insert renvoie cette erreur si la requête a tenté de créer une référence via un fichier, mais qu'elle n'a pas spécifié d'assetId.
  badRequest (400)	canNotBeActivated La méthode references.update renvoie cette erreur si la référence ne peut pas être activée, en raison de son état ou des conditions de propriété, par exemple.
  badRequest (400)	videoNotClaimed La méthode videoAdvertisingOptions.get renvoie cette erreur si vous n'avez pas revendiqué la vidéo pour laquelle vous essayez de récupérer les options publicitaires. Les informations demandées ne sont donc pas disponibles.

18 décembre 2015

Conformément à la législation de l'Union européenne (UE), vous devez publier certaines informations à l'attention des utilisateurs finaux et obtenir leur consentement dans l'UE. Par conséquent, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE pour les utilisateurs finaux situés dans l'Union européenne. Nous avons ajouté une notification de cette exigence dans nos Conditions d'utilisation de l'API YouTube.

21 avril 2015

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource campaign représente une campagne pour les propriétaires de contenu spécifique, qui leur permet d'utiliser des annotations pour promouvoir du contenu dans des vidéos mises en ligne par des utilisateurs et revendiquées. Par exemple, un propriétaire de contenu peut créer une campagne qui ajoute des liens vers la page de lecture d'un film pour toutes les vidéos mises en ligne par des utilisateurs qui contiennent des scènes de ce film et sont revendiquées.

  L'API prend en charge les méthodes pour les ressources get, list, insert, update, patch et delete campaign.

• L'API prend en charge plusieurs nouvelles erreurs pour les nouvelles méthodes campaigns.get, campaigns.insert, campaigns.update et campaigns.delete.

30 mars 2015

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • Le nouveau paramètre isrcs de la méthode assetSearch.list vous permet de spécifier une liste de 50 codes ISRC maximum. La réponse de l'API inclura les éléments associés à ces codes ISRC.

  • La propriété event[].reason de la ressource claimHistory accepte les nouvelles valeurs suivantes. Chaque motif explique pourquoi un événement particulier lié à la réclamation s'est produit:

    • closed_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • closed_reference_conflict

  • Le nouveau paramètre sort de la méthode claimSearch.list spécifie la méthode qui sera utilisée pour organiser les ressources dans la réponse de l'API. Par défaut, les ressources sont triées dans l'ordre chronologique inverse (de la plus récente à la plus ancienne) en fonction de la date de leur création. Vous pouvez également trier les ressources du contenu revendiqué par ordre croissant du nombre de vues.

    Notez que si la requête claimSearch.list définit également la valeur du paramètre status sur appealed, disputed, pending, potential ou routedForReview, les résultats sont triés en fonction de l'expiration de la période d'examen de la revendication.

  • Les méthodes ownership.update et ownership.patch répertorient désormais correctement toutes les propriétés pouvant être mises à jour lors de l'appel de ces méthodes. Cette modification représente une correction de la documentation de l'API et n'identifie aucune modification de la fonctionnalité de l'API.

  • Les paramètres fetchMatchPolicy des méthodes assets.get et assets.list indiquent désormais effective comme valeur acceptée. Cette valeur indique au serveur de l'API de récupérer la règle de correspondance que YouTube applique à l'élément.

  • Les paramètres id des méthodes assets.list, claims.list, contentOwners.list, policies.list, publishers.list et references.list indiquent désormais que leurs valeurs de paramètre peuvent contenir un maximum de 50 ID séparés par une virgule.

• Nouvelles erreurs et mises à jour d'erreurs

  Le tableau ci-dessous identifie les nouvelles erreurs compatibles avec l'API et les méthodes pouvant renvoyer chacune d'elles. Notez qu'une méthode peut renvoyer plusieurs erreurs ayant le même type d'erreur.

  Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

  Type d'erreur	Détail de l'erreur	Description
  badRequest (400)	tooManyIsrcs	La méthode assetSearch.list renvoie cette erreur si le paramètre isrcs spécifie plus de 50 codes ISRC.
  badRequest (400)	videoIsPrivate	La méthode claims.insert renvoie cette erreur si vous essayez de revendiquer une vidéo privée. Vous ne pouvez revendiquer une vidéo que si son état de confidentialité est public ou unlisted.
  notModified (304)	blockOutsideOwnershipUnchanged	La méthode claims.update renvoie cette erreur si la modification de l'indicateur blockOutsideOwnership de la revendication n'a pas abouti. Plusieurs raisons peuvent expliquer cette erreur. Par exemple, si la modification spécifiée n'a aucun effet sur la vidéo revendiquée.

7 novembre 2014

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • Le paramètre status de la méthode claimSearch.list accepte désormais la valeur routedForReview. Cette valeur limite les résultats aux revendications nécessitant un examen manuel, en fonction d'une règle de la règle de correspondance d'un composant.

  • La propriété event[].reason de la ressource claimHistory accepte les nouvelles valeurs suivantes. Chaque motif explique pourquoi un événement particulier lié à la réclamation s'est produit:

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • La propriété origin.source de la ressource claim, qui identifie la source d'une revendication, accepte désormais la valeur melodyMatch. Une revendication de correspondance de mélodie indique que la vidéo revendiquée partage une composition musicale avec une référence.

  • La documentation de la méthode references.insert a été mise à jour pour refléter correctement que l'API utilise deux points de terminaison différents pour cette méthode. Il ne s'agit pas d'un changement de la fonctionnalité de l'API, mais d'une correction de la documentation existante.

    • Si la requête importe un nouveau fichier de référence, le point de terminaison approprié est le suivant:

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

    • Si la requête crée une référence à l'aide d'une vidéo revendiquée comme contenu de référence, le point de terminaison approprié est le suivant:

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

• Nouvelles erreurs et mises à jour d'erreurs

  Le tableau ci-dessous identifie les nouvelles erreurs compatibles avec l'API et les méthodes pouvant renvoyer chacune d'elles. Notez qu'une méthode peut renvoyer plusieurs erreurs ayant le même type d'erreur.

  Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

  Type d'erreur	Détail de l'erreur	Description
  badRequest (400)	invalidLabelName	Les méthodes assets.insert, assets.update et assetLabels.insert renvoient cette erreur si le nom d'un libellé d'élément n'est pas valide. Les noms des étiquettes doivent comporter entre 2 et 30 caractères. Les chevrons, les virgules, les deux-points, les esperluettes et les barres verticales (|) ne sont pas autorisés.
  badRequest (400)	ownerHaveMaximumNumberOfLabels	Les méthodes assets.insert, assets.update et assetLabels.insert renvoient cette erreur si un propriétaire de contenu a déjà défini 2 500 libellés d'éléments uniques, ce qui correspond au nombre maximal actuellement autorisé.
  badRequest (400)	tooManyLabelsOnOneAsset	Les méthodes assets.insert et assets.update renvoient cette erreur si un élément est déjà associé à 30 libellés d'éléments, ce qui correspond au nombre maximal actuellement autorisé.
  badRequest (400)	channelMonetizationSuspended	Les méthodes claims.insert et claims.update renvoient cette erreur si la chaîne d'une vidéo est suspendue en raison de revendications de partenaires.
  badRequest (400)	channelNotActive	La méthode claims.update renvoie cette erreur si la chaîne d'une vidéo n'est pas active.

• Les méthodes assets.insert et assets.update ne renvoient plus d'erreur badRequest pour certains composants si la ressource du corps de la requête ne contient pas la propriété metadataMine.contentType.

23 septembre 2014

Cette mise à jour inclut les changements suivants :

• Modifications de l'ID de propriétaire de contenu

  Les modifications apportées à l'ID du propriétaire du contenu annoncées dans l'historique des modifications le 9 juillet 2014 sont entrées en vigueur. En raison de ce changement, l'API renvoie désormais un ID unique généré pour identifier le propriétaire du contenu associé à l'utilisateur authentifié ou à une ressource gérée via l'API. Auparavant, l'API renvoyait un nom lisible par l'humain comme ID, par exemple "qrs_network".

  Cette modification affecte la fonctionnalité d'API suivante et aura probablement un impact sur les partenaires qui ont des codes partenaire codés en dur dans leurs applications.

  • L'API renvoie désormais le nouvel ID comme valeur des propriétés de ressources qui renvoyaient auparavant le code partenaire, comme la propriété id de la ressource contentOwner.
  • Toutes les méthodes de l'API acceptent le paramètre onBehalfOfContentOwner, qui identifie le propriétaire du contenu pour le compte duquel la requête API est effectuée. Après ce changement, le paramètre doit être défini sur le nouvel ID au lieu du code partenaire. Pour éviter les erreurs de code, le paramètre accepte l'une ou l'autre valeur pendant une période de transition.
  • Après ce changement, le paramètre contentOwnerId de la méthode contentOwners.list doit spécifier le nouvel ID au lieu du code partenaire.

• Mises à jour des ressources et méthodes existantes

  • Le nouveau paramètre metadataSearchFields de la méthode assetSearch.list vous permet de spécifier les champs de métadonnées des composants que vous souhaitez rechercher, ainsi que les valeurs que vous souhaitez rechercher dans ces champs. La valeur du paramètre est une liste de paires de champs et de valeurs séparées par une virgule. Dans une paire, le champ et la valeur sont séparés par un deux-points.

  • Le nouvel objet appliedPolicy de la ressource claim spécifie la stratégie que YouTube applique réellement pour la revendication. La valeur de l'objet est une ressource policy. Cette ressource contient des informations sur les règles applicables dans les pays où le propriétaire du contenu ayant envoyé la demande est propriétaire de l'élément revendiqué.

    La règle appliquée peut différer de celle définie par le propriétaire du contenu de deux manières:

    1. Il tient compte des règles définies par d'autres propriétaires qui détiennent une partie de la propriété de l'élément revendiqué dans certains des mêmes territoires que le propriétaire de contenu ayant envoyé la requête API.

    2. Il tient compte des règles administratives de YouTube qui s'appliquent dans les territoires où le propriétaire du contenu est propriétaire de l'élément revendiqué.

  • La nouvelle propriété uploaderChannelId de la ressource claimHistory identifie l'ID de la chaîne sur laquelle la vidéo revendiquée a été mise en ligne.

8 septembre 2014

Cette mise à jour inclut les changements suivants :

• Nouvelles ressources et méthodes

  • La nouvelle ressource assetLabel identifie un libellé textuel pouvant être attribué à un élément. Les libellés d'éléments vous permettent de classer vos éléments dans des catégories personnalisées, ce qui facilite l'organisation de votre bibliothèque d'éléments. Vous pouvez rechercher des éléments en fonction de leur libellé, ce qui vous permet également de modifier facilement des groupes spécifiques d'éléments.

    • La méthode assetLabels.list vous permet de récupérer la liste des libellés d'un propriétaire de contenu.
    • La méthode assetLabels.insert vous permet de créer un libellé d'élément. Vous pouvez également créer des libellés en appelant la méthode assets.update et en mettant à jour les libellés d'un élément. Le serveur de l'API crée automatiquement une ressource assetLabel pour tout libellé non défini précédemment.

• Mises à jour des ressources et méthodes existantes

  • La propriété label[] de la ressource asset a été mise à jour pour indiquer que vous pouvez appeler la méthode assets.update pour mettre à jour les libellés d'un composant. Toutefois, vous ne pouvez pas définir les libellés d'un composant lorsque vous appelez la méthode assets.insert.

    Le nouveau guide Utiliser les libellés d'éléments explique comment créer et récupérer des libellés d'éléments, ainsi que comment mettre à jour les libellés d'un élément ou rechercher des éléments associés à des libellés spécifiques.

• Nouvelles erreurs et mises à jour d'erreurs

  L'API prend en charge plusieurs nouvelles erreurs pour les nouvelles méthodes assetLabels.list et assetLabels.insert.

9 juillet 2014

Cette mise à jour inclut les changements suivants :

• Modifications de l'ID de propriétaire de contenu

  Par le passé, l'API utilisait un code partenaire lisible par l'humain, tel que "qrs_network", pour identifier de manière unique le propriétaire du contenu associé à l'utilisateur authentifié ou à une ressource gérée via l'API. Au troisième trimestre 2014, l'API utilisera un identifiant unique de 22 caractères pour identifier les propriétaires de contenu. Cette modification affecte la fonctionnalité d'API suivante et aura probablement un impact sur les partenaires qui ont des codes partenaire codés en dur dans leurs applications.

  • L'API renverra l'ID à 22 caractères comme valeur des propriétés de ressources qui renvoyaient auparavant le code partenaire, comme la propriété id de la ressource contentOwner.
  • Toutes les méthodes de l'API acceptent le paramètre onBehalfOfContentOwner, qui identifie le propriétaire du contenu pour le compte duquel la requête API est effectuée. Après ce changement, le paramètre doit être défini sur l'ID à 22 caractères au lieu du code partenaire. Pour éviter les erreurs de code, le paramètre accepte l'une ou l'autre valeur pendant une période de transition.
  • Après ce changement, le paramètre contentOwnerId de la méthode contentOwners.list doit spécifier l'ID à 22 caractères au lieu du code partenaire.

• Mises à jour des ressources et méthodes existantes

  • Une ressource asset est désormais compatible avec la propriété label, qui spécifie une liste de libellés d'éléments associés à l'élément. Vous pouvez appliquer un libellé à plusieurs éléments pour les regrouper. Vous pouvez utiliser les libellés comme filtres de recherche pour effectuer des mises à jour groupées, télécharger des rapports ou filtrer YouTube Analytics.

  • La méthode assetSearch.list accepte désormais les paramètres facultatifs suivants:

    • labels: limite les résultats aux composants associés aux libellés spécifiés. Par défaut, l'API renvoie les éléments correspondant à tous les libellés spécifiés. Toutefois, vous pouvez utiliser le paramètre includeAnyProvidedLabel pour demander à l'API de renvoyer les éléments correspondant à l'un des libellés spécifiés.
    • includeAnyProvidedLabel: utilisé conjointement avec le paramètre labels, ce paramètre indique à l'API de renvoyer les éléments associés à l'un des libellés spécifiés dans la valeur du paramètre labels.

  • Une ressource claimHistory contient désormais les nouvelles propriétés suivantes:

    • La propriété event[].source.userEmail fournit l'adresse e-mail de l'utilisateur à l'origine de l'événement.
    • La propriété event[].typeDetails.disputeNotes contient des notes de contestation pour un événement dispute_create.

  • La méthode claimSearch.list accepte désormais les paramètres facultatifs suivants:

    • createdAfter: limite les résultats aux revendications créées après la date spécifiée.
    • createdBefore: limite les résultats aux revendications créées avant la date spécifiée.
    • includeThirdPartyClaims: utilisé avec le paramètre videoId, ce paramètre indique si les revendications tierces doivent être incluses dans les résultats de l'API.

• Informations d'erreur plus détaillées

  La documentation sur les erreurs indique désormais le code de réponse HTTP pour chaque type d'erreur.

• Nouvelles erreurs et mises à jour d'erreurs

  Le tableau ci-dessous identifie les nouvelles erreurs compatibles avec l'API et les méthodes pouvant renvoyer chacune d'elles. Notez qu'une méthode peut renvoyer plusieurs erreurs ayant le même type d'erreur. Par exemple, une erreur required est renvoyée si vous essayez d'insérer une ressource asset dont un champ de métadonnées obligatoire est manquant. En fait, il peut y avoir plusieurs champs de métadonnées obligatoires, chacun renvoyant une erreur avec un message légèrement différent.

  Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

  Méthode	Erreurs
  assetSearch.list	invalidValue : l'API ne permet pas de rechercher des éléments d'émission ou de saison. Remplacez la valeur du paramètre type par une valeur acceptée.
  assets.insert	conflict : trop d'éléments associés au même identifiant (ID personnalisé, code ISRC, etc.) existent déjà. conflict : trop de copies de l'élément spécifié existent déjà. invalidValue : l'utilisateur qui appelle l'API n'est pas autorisé à créer des composants du type spécifié.
  assets.patch assets.update	badRequest : l'API n'est pas compatible avec la conversion de type d'asset que vous avez tentée.
  claimSearch.list	badRequest : le paramètre includeThirdPartyClaims ne peut être utilisé qu'avec le filtre videoId.
  ownership.patch ownership.update	badRequest : vous ne pouvez pas modifier la propriété d'un élément de piste d'illustration.
  references.patch references.update	badRequest : la référence est dans un état non valide pour l'opération que vous essayez d'effectuer.

3 février 2014

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • Une ressource asset peut désormais avoir une valeur type de art_track_video.

  • Une ressource claimSearch inclut désormais les nouvelles propriétés suivantes:

    • L'objet origin contient des informations qui décrivent la manière dont la revendication a été créée.
    • La propriété thirdPartyClaim contient une valeur booléenne indiquant si la revendication a été effectuée par un propriétaire de contenu autre que celui associé à l'utilisateur effectuant la recherche.

  • La méthode claimSearch.list accepte désormais les paramètres facultatifs suivants:

    • contentType: limite les résultats aux revendications audio uniquement, vidéo uniquement ou audiovisuelles.
    • origin: spécifie une ou plusieurs origines de revendications, telles que descriptiveSearch ou videoMatch, pour lesquelles vous souhaitez rechercher des revendications.
    • status: limite les résultats aux seules revendications dont l'état est spécifié.

  • La propriété status de la ressource claim accepte désormais les valeurs supplémentaires suivantes: appealed, disputed, potential, takedown et unknown.

  • La nouvelle propriété blockOutsideOwnership de la ressource claim indique si la vidéo revendiquée doit être bloquée dans les territoires où elle n'est pas explicitement détenue. Par défaut, les utilisateurs situés dans les pays où les données de propriété n'avaient pas été définies pour l'élément associé à la revendication pouvaient toujours regarder la vidéo revendiquée.

  • La nouvelle propriété allowedOptions.autoGeneratedBreaks de la ressource contentOwnerAdvertisingOption indique si le partenaire peut choisir de diffuser des annonces mid-roll InStream à des moments automatiquement définis par YouTube.

  • La méthode contentOwners.list peut désormais être appelée avec un jeton d'autorisation qui spécifie le champ d'application https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

  • La nouvelle propriété timeUpdated de la ressource policy spécifie l'heure à laquelle la stratégie a été mise à jour pour la dernière fois.

  • La méthode policies.list accepte désormais un paramètre sort facultatif, qui permet de spécifier que les résultats doivent être triés par ordre croissant ou décroissant de la date et de l'heure de leur dernière mise à jour.

  • La nouvelle propriété expiryTime de la ressource referenceConflict spécifie l'heure à laquelle la période d'examen du conflit de référence se terminera, ce qui entraînera son expiration.

  • La nouvelle propriété autoGeneratedBreaks de la ressource videoAdvertisingOption indique si la vidéo doit diffuser des annonces mid-roll InStream à des moments automatiquement définis par YouTube.

• Nouvelles erreurs et mises à jour d'erreurs

  Le tableau ci-dessous identifie les nouvelles erreurs compatibles avec l'API et les méthodes pouvant renvoyer chacune d'elles. Notez qu'une méthode peut renvoyer plusieurs erreurs ayant le même type d'erreur. Par exemple, une erreur required est renvoyée si vous essayez d'insérer une ressource asset dont un champ de métadonnées obligatoire est manquant. En fait, il peut y avoir plusieurs champs de métadonnées obligatoires, chacun renvoyant une erreur avec un message légèrement différent.

  Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

  Méthode	Erreurs
  assets.insert assets.update	badRequest : l'API n'est pas compatible avec les opérations d'écriture sur les composants Art Track.
  claimSearch.list	invalidValue : le paramètre pageToken de la requête spécifie un jeton de page non valide.
  claims.insert	badRequest : la revendication que vous essayez de créer n'est pas valide, car la chaîne de la vidéo n'est pas active. badRequest : la vidéo que vous essayez de revendiquer est exemptée d'une règle de retrait. Pour toute question, veuillez contacter copyright@youtube.com. badRequest : votre demande ne peut pas être traitée, car vous ne pouvez pas créer de revendication de tiers pour la vidéo spécifiée. conflict : YouTube ne peut pas créer la réclamation demandée, car la vidéo a fait l'objet d'une demande de retrait. conflict : YouTube ne peut pas créer la revendication demandée, car une revendication de retrait est active pour la vidéo.
  references.insert	badRequest : la vidéo revendiquée que vous essayez d'utiliser a été supprimée ou refusée, ou son traitement a échoué.

• Les erreurs contentOwnerNotProvided et internalError, qui ne sont pas spécifiques à une méthode d'API particulière, ne sont plus listées sur chaque page de méthode. Vous pouvez toujours consulter leur description dans la section Erreurs générales de la documentation sur les erreurs de l'API.

12 septembre 2013

Cette mise à jour inclut les changements suivants :

• Nouvelles ressources et méthodes

  • La nouvelle ressource referenceConflict identifie un conflit entre deux fichiers de référence et liste les correspondances qui existaient entre ces fichiers au moment où le conflit a été identifié. La méthode referenceConflicts.list vous permet de récupérer la liste des conflits de référence non résolus associés au propriétaire de contenu autorisé. La méthode referenceConflicts.get vous permet de récupérer un conflit de référence en spécifiant son ID de conflit de référence unique.

  Mises à jour des ressources et méthodes existantes

  • L'API permet désormais de récupérer la règle de correspondance effective d'un composant. Cette modification est semblable à celle publiée le 16 juillet 2013, qui incluait la possibilité de récupérer l'ensemble canonique de métadonnées et de données de propriété d'un élément.

    Pour récupérer la stratégie de correspondance effective d'un composant, définissez la valeur du paramètre fetchMatchPolicy sur effective lorsque vous appelez les méthodes assets.get ou assets.list. Dans la réponse de l'API, l'objet matchPolicyEffective de chaque ressource asset renvoyée contient la stratégie de correspondance effective pour cet élément.

  • Le nouvel objet ownershipConflicts de la ressource asset contient des informations sur les conflits de propriété de l'asset. La structure de l'objet est semblable à celle d'une ressource ownership, qui identifie chaque type de droits qu'un propriétaire d'éléments peut détenir. (Pour la plupart des types d'éléments, les propriétaires ne peuvent être que propriétaires généraux, mais pour les éléments de composition, ils peuvent indiquer leur propriété des droits d'exécution, des droits de synchronisation ou des droits de reproduction mécanique.)

    De même, l'objet ownershipConflicts contient des listes distinctes qui identifient les conflits pour les droits de propriété généraux, les droits d'exécution, les droits de synchronisation et les droits de reproduction mécanique. Pour chaque conflit, les données identifient les territoires concernés, les propriétaires qui ont fourni des données de propriété contradictoires et le pourcentage de l'élément que chaque propriétaire en conflit revendique.

  • Les méthodes assets.get et assets.get sont désormais compatibles avec le nouveau paramètre fetchOwnershipConflicts. Le paramètre comporte une valeur booléenne qui indique si la requête API doit récupérer les conflits de propriété pour les composants de la réponse de l'API. La valeur par défaut est false, ce qui signifie que les conflits de propriété ne sont pas renvoyés.

  • La définition du paramètre q de la méthode assetSearch.list a été mise à jour pour identifier les champs de métadonnées que YouTube recherche.

  • La documentation du corps de la requête pour une méthode references.insert indique désormais que vous devez définir la valeur de la propriété contentType. Cette modification met à jour la documentation pour refléter correctement les fonctionnalités réelles de l'API, mais ne modifie pas les fonctionnalités de l'API.

• Nouvelles erreurs et mises à jour d'erreurs

  • L'API accepte une nouvelle erreur forbidden, qui n'est pas spécifique à une méthode donnée, qui indique que l'opération demandée ne peut pas être autorisée par un compte de service.

  • La méthode assets.insert identifie désormais les erreurs de métadonnées comme se produisant dans les propriétés de l'objet metadataMine plutôt que dans l'objet metadata, qui a été abandonné depuis la mise à jour de l'API le 16 juillet 2013.

  • La page errors a été mise à jour afin que, pour chaque ressource compatible avec les méthodes update et patch, elle contienne un tableau qui liste les erreurs renvoyées par ces deux méthodes. Auparavant, la page listait les erreurs pour chaque méthode séparément, même si les listes étaient toujours les mêmes.

16 juillet 2013

Cette mise à jour inclut les changements suivants :

• Nouvelles ressources et méthodes

  • La nouvelle méthode claimHistory.get vous permet d'identifier et de récupérer des informations sur une revendication spécifique. La ressource claimHistory renvoyée contient une liste d'événements liés à la réclamation, tels que la création, la mise à jour, le litige ou la clôture de la réclamation.

  • La nouvelle méthode claimSearch.list vous permet de rechercher des revendications qui répondent à l'un ou à tous des critères suivants:

    • Les revendications sont associées à un élément spécifique.
    • Les revendications sont associées à une vidéo spécifique.
    • Les revendications correspondent à une chaîne de requête fournie dans la requête.

    Chaque ressource claimSnippet de la réponse de l'API contient des informations sur une revendication, y compris son ID unique, son état, son type (audio, video ou audiovisual), ainsi que l'asset et la vidéo associés à la revendication. Elle indique également le nombre de vues de la vidéo revendiquée et son titre.

• Mises à jour des ressources et méthodes existantes

  • La documentation liste désormais les valeurs acceptées pour les propriétés qui comportent un ensemble de valeurs énumérées. Ces propriétés incluent la propriété type de la ressource asset et la propriété status de la ressource claim.

  • Pour les méthodes assets.get et assets.list, l'API accepte désormais les valeurs séparées par des virgules pour les paramètres de requête fetchMetadata et fetchOwnership, ce qui vous permet de récupérer plusieurs ensembles de métadonnées ou de données de propriété.

    La liste ci-dessous explique les modifications correspondantes apportées à la structure de la ressource asset, ainsi que les conséquences de ces modifications sur les méthodes d'API qui utilisent les ressources get, list, insert, update ou patch asset.

    • L'objet metadata a été abandonné et remplacé par les objets metadataMine et metadataEffective. Les nouveaux objets permettent à une ressource asset d'inclure à la fois l'ensemble de métadonnées fourni par le propriétaire du contenu qui envoie la requête d'API, ainsi que l'ensemble canonique de métadonnées que YouTube a déterminé comme étant l'ensemble le plus précis et le plus complet pour l'élément.

    • De même, l'objet ownership a été remplacé par les objets ownershipMine et ownershipEffective.

    • L'objet matchPolicy a été remplacé par l'objet matchPolicyMine. (L'API ne permet pas actuellement de récupérer la règle de correspondance effective d'un composant.)

    Remarque:Pour assurer la rétrocompatibilité, si une seule version de métadonnées, un seul ensemble de données de propriété ou une seule règle de correspondance est demandée pour un composant, la réponse de l'API inclura l'objet obsolète ainsi que le nouvel objet compatible. Par exemple, si une requête définit le paramètre fetchMetadata sur mine, la réponse de l'API contiendra un objet metadata et un objet metadataMine, qui contiendraient tous les deux les mêmes données. (La possibilité de définir fetchMetadata=mine était disponible avant la mise à jour de la fonctionnalité permettant de récupérer plusieurs versions de métadonnées.)
    
    Toutefois, si le paramètre fetchMetadata est défini sur mine,effective, la réponse de l'API contiendra des objets metadataMine et metadataEffective, mais pas d'objet metadata. (La possibilité de définir fetchMetadata=mine,effective n'était pas prise en charge avant cette mise à jour de fonctionnalité. Il n'est donc pas nécessaire de renvoyer l'objet metadata pour assurer la rétrocompatibilité.) Le même principe s'applique également aux paramètres fetchOwnership et fetchMatchPolicy.
    
    De même, pour assurer la rétrocompatibilité, une requête envoyée à insert, update ou patch une ressource asset peut inclure l'objet metadataMine ou l'objet metadata. Le même principe s'applique au paramétrage des données de propriété ou de la stratégie de correspondance d'une ressource asset.

  • Les paramètres assetId, q et videoId de la méthode claims.list ont été abandonnés. Pour rechercher des revendications à l'aide de l'un de ces critères, utilisez la méthode claimSearch.list, qui accepte tous ces paramètres.

  • Dans une ressource ownership, les valeurs des propriétés general[].ratio, performance[].ratio, synchronization[].ratio et mechanical[].ratio ont désormais toutes un format de contenu double au lieu de integer.

  • La définition de la propriété rules[].action de la ressource policy liste désormais les valeurs valides pour cette propriété: block, monetize, takedown et track. Notez toutefois que vous ne pouvez pas utiliser l'API pour appliquer une règle de retrait à une réclamation.

  • La nouvelle propriété claimId de la ressource reference est présente si la référence a été créée en associant un composant à une vidéo YouTube existante mise en ligne sur une chaîne YouTube associée à votre compte CMS. Dans ce cas, ce champ contient l'ID de la revendication qui représente l'association résultante entre l'élément et la vidéo.

  • La nouvelle propriété excludedIntervals[] de la ressource reference spécifie une liste d'intervalles de temps pendant la référence que YouTube doit ignorer lorsqu'il tente de la faire correspondre. Chaque intervalle spécifie une heure de début et de fin mesurée en secondes à partir du début de la vidéo.

  • L'API ne nécessite plus que la propriété status soit définie dans la ressource reference envoyée dans le corps d'une requête references.update ou references.patch.

  • La documentation a été corrigée pour décrire correctement le format de réponse de l'API pour la méthode videoAdvertisingOptions.getEnabledAds. La réponse, qui est une ressource youtubePartner#videoAdvertisingOptionGetEnabledAds, contient les informations suivantes:

    • id : ID que YouTube utilise pour identifier de manière unique la vidéo revendiquée associée aux paramètres.

    • adBreaks : liste d'objets dans lesquels chaque objet contient des informations sur un point avant, pendant ou après la lecture de la vidéo où les annonces peuvent être diffusées. Chaque objet peut également spécifier d'autres attributs de la coupure publicitaire, tels que les espaces publicitaires qui apparaissent pendant la coupure et les types d'annonces autorisés à être diffusés dans chaque espace.

    • adsOnEmbeds : champ booléen indiquant si YouTube peut diffuser des annonces lorsque la vidéo est lue dans un lecteur intégré.

    • countriesRestriction : liste d'objets dans lesquels chaque objet identifie une liste de territoires et les formats d'annonces utilisés lors de la lecture de la vidéo dans ces territoires.

• Nouvelles erreurs et mises à jour d'erreurs

  • Le tableau ci-dessous identifie les nouvelles erreurs compatibles avec l'API et les méthodes pouvant renvoyer chacune d'elles. Il identifie également les erreurs qui ont changé. Notez qu'une méthode peut renvoyer plusieurs erreurs ayant le même type d'erreur. Par exemple, une erreur required est renvoyée si vous essayez d'insérer une ressource asset dont un champ de métadonnées obligatoire est manquant. En fait, il peut y avoir plusieurs champs de métadonnées obligatoires, chacun renvoyant une erreur avec un message légèrement différent.

    Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

    Méthode	Erreurs
    assets.insert assets.update assets.patch	Les erreurs invalidValue et required précédemment associées aux propriétés enfants de l'objet metadata sont désormais associées aux mêmes propriétés enfants dans l'objet metadataMine.
    claimHistory.get	notFound : la revendication pour laquelle vous essayez de récupérer l'historique est introuvable. required : la requête ne spécifie aucune valeur pour le paramètre claimId.
    claimSearch.list claims.list	badRequest : la requête spécifie des critères non valides. Vous ne pouvez spécifier qu'un seul des paramètres de filtre suivants: q, assetId ou videoId.
    claims.insert	badRequest : la revendication que vous essayez de créer n'est pas valide, car le titulaire du contenu demandé n'est pas le propriétaire de l'élément associé à la revendication. badRequest : le propriétaire de contenu pour lequel vous agissez n'est pas autorisé à créer des règles avec l'action spécifiée. invalidValue : le propriétaire du contenu pour lequel vous agissez n'est pas autorisé à revendiquer des vidéos mises en ligne par des utilisateurs via l'API.
    contentOwners.list	badRequest : la requête spécifie des critères non valides. Vous devez spécifier exactement l'un des paramètres de filtre suivants: fetchMine, id. (Auparavant, l'erreur listait un autre ensemble de paramètres de filtre : has_conflicts_with, restrict_to_user, name_prefix et id.)
    ownership.update ownership.patch	badRequest : une requête qui met à jour les données de propriété d'un composant de composition doit spécifier des données de propriété précises (droits mechanical, performance, synchronization et/ou lyric) plutôt que des droits de propriété general. Le type de droits lyric est désormais accepté.
    policies.insert policies.update policies.patch	invalidValue : la requête contient une règle de stratégie non valide, car l'API n'est pas compatible avec la création ou la modification de stratégies spécifiant une action takedown. Cette erreur, qui indique la raison invalidPolicyTakedownAction, remplace l'erreur invalidPolicyConditionalTakedown obsolète.
    references.insert	badRequest : la requête doit envoyer un fichier multimédia ou spécifier une valeur pour le paramètre de requête claimId. Toutefois, une requête peut ne pas envoyer de fichier multimédia et spécifier une valeur pour le paramètre de requête claimId. badRequest : une référence pour le même contenu a déjà été créée à partir d'une autre revendication pour la même vidéo YouTube. badRequest : l'API ne permet pas de définir une valeur pour la propriété fpDirect lors de la création d'une référence. internalError : problème avec le fichier multimédia importé. invalidValue : la valeur du paramètre de requête contentType, assetId ou claimId n'est pas valide. L'erreur identifie la valeur non valide. notFound : l'asset ou la revendication que vous avez spécifiés sont introuvables. Veuillez vérifier les valeurs des paramètres assetId et claimId dans votre requête. required : la requête doit spécifier une valeur pour le paramètre contentType.
    references.insert references.update references.patch	invalidValue : les excludedIntervals spécifiés pour la référence ne sont pas valides. Notez que vous ne pouvez pas spécifier d'intervalles d'exclusion lorsque vous désactivez une référence.

10 mai 2013

Cette mise à jour inclut les changements suivants :

• YouTube n'identifie plus les fonctionnalités et services API expérimentaux. Nous fournissons désormais une liste des API YouTube soumises au règlement relatif aux abandons.

8 avril 2013

Cette mise à jour inclut les changements suivants :

• L'API a été renommée "API YouTube Content ID".

• Plusieurs propriétés ont changé dans la ressource assetMatchPolicy:

  • La valeur de la propriété kind est passée de youtubePartner#policy à youtubePartner#assetMatchPolicy.
  • La nouvelle propriété policyId contient une valeur qui identifie de manière unique une ressource de règles enregistrée.
  • La valeur de la propriété rules[].subaction est désormais une liste de chaînes plutôt qu'une chaîne.
  • La valeur de la propriété rules[].conditions.contentMatchType est désormais une liste de chaînes plutôt qu'une chaîne.
  • Les propriétés id, name et description ont été supprimées.

• La documentation de la méthode assetMatchPolicy.update a été mise à jour pour indiquer que vous pouvez définir des valeurs pour la propriété policyId ou l'objet rules[] lorsque vous appelez la méthode.

• La ressource claims est désormais compatible avec plusieurs nouvelles propriétés:

  Nom de propriété	Valeur	Description
  timeCreated	datetime	Date et heure de création de la revendication.
  matchInfo	object	L'objet matchInfo contient des informations sur le contenu correspondant qui a généré la revendication. Ces informations ne sont incluses dans une ressource claim que si la revendication a été générée automatiquement, car une vidéo mise en ligne correspondait à un fichier de référence existant.
  matchInfo.referenceId	string	Identifiant unique que YouTube utilise pour identifier la référence reference ayant généré la correspondance.
  matchInfo.longestMatch	object	L'objet longestMatch contient des informations sur la correspondance la plus longue entre la référence et la vidéo mise en ligne.
  matchInfo.longestMatch.durationSecs	unsigned long	Durée de la correspondance, en secondes.
  matchInfo.longestMatch.userVideoOffset	unsigned long	Décalage temporel au début du match, mesuré en secondes à partir du début de la vidéo mise en ligne.
  matchInfo.longestMatch.referenceOffset	unsigned long	Décalage temporel au début de la correspondance, mesuré en secondes à partir du début de la référence.
  matchInfo.totalMatch	object	L'objet totalMatch contient des informations sur la durée totale de la vidéo mise en ligne qui correspond à la référence et sur la durée totale de la référence qui correspond à la vidéo mise en ligne. Ces valeurs peuvent différer si le contenu correspondant est diffusé en boucle dans la vidéo mise en ligne ou dans la vidéo de référence. Par exemple, si une vidéo importée inclut un extrait de 10 secondes d'une référence, mais que cet extrait est répété six fois, la durée totale du contenu correspondant dans la vidéo importée est de 60 secondes, mais celle du contenu correspondant dans la référence n'est que de 10 secondes.
  matchInfo.totalMatch.userVideoDurationSecs	unsigned long	Durée totale, en secondes, du contenu de la vidéo mise en ligne qui correspond à la référence.
  matchInfo.totalMatch.referenceDurationSecs	unsigned long	Durée totale, en secondes, du contenu de référence qui correspond à la vidéo mise en ligne.
  origin	object	L'objet origin contient des informations décrivant la source de la revendication.
  origin.source	string	Source de la revendication.

• La propriété policy de la ressource claims a été mise à jour pour indiquer que la valeur ne peut pas être modifiée pour une réclamation AudioSwap.

• La propriété timeProvidedMs de la ressource metadataHistory a été renommée timeProvided.

• La propriété timeProvidedMs de la ressource ownershipHistory a été renommée timeProvided.

• La définition de la méthode ownershipHistory.list a été modifiée pour indiquer qu'elle ne récupère que les données de propriété les plus récentes pour chaque propriétaire de contenu. Toutefois, si le propriétaire du contenu a envoyé des données de propriété via plusieurs sources de données (API, flux de contenu, etc.), la liste contiendra les données les plus récentes pour chaque propriétaire de contenu et chaque source de données.

• Plusieurs propriétés ont changé dans la ressource policy:

  • La propriété rule a été renommée rules (règles).
  • La valeur de la propriété rules[].subaction est désormais une liste de chaînes plutôt qu'une chaîne.
  • La valeur de la propriété rules[].conditions.contentMatchType est désormais une liste de chaînes plutôt qu'une chaîne.

• La documentation des méthodes policies.insert et policies.update a été mise à jour pour indiquer que vous pouvez définir des valeurs pour l'objet rules[] lorsque vous appelez ces méthodes.

• Plusieurs méthodes d'API sont compatibles avec de nouveaux types d'erreurs. Le tableau ci-dessous identifie la méthode et les types d'erreurs nouvellement pris en charge. Dans de nombreux cas, il peut y avoir plusieurs erreurs pour un type donné. Par exemple, une erreur required est renvoyée si vous essayez d'insérer une ressource asset dont un champ de métadonnées obligatoire est manquant. En fait, il peut y avoir plusieurs champs de métadonnées obligatoires, chacun renvoyant une erreur avec un message légèrement différent.

  Pour en savoir plus, consultez la documentation sur les erreurs de chaque méthode ou la page Erreurs.

  Méthode	Erreurs
  assets.insert	invalidValue : un champ de métadonnées d'asset contient une valeur non valide. required : un champ de métadonnées d'asset obligatoire est manquant.
  assets.update assets.patch	forbidden : l'élément mis à jour n'appartient pas au partenaire qui tente de le mettre à jour. invalidValue : un champ de métadonnées d'asset contient une valeur non valide. notFound : l'élément est associé à un élément de saison ou d'émission introuvable. required : un champ de métadonnées d'asset obligatoire est manquant.
  claims.insert	badRequest : la demande tente de revendiquer une vidéo, mais la revendication n'est pas autorisée.
  ownership.update ownership.patch	badRequest : la requête définit une propriété totale supérieure à 100 % dans un territoire.
  policies.insert policies.patch policies.update	conflictingPolicyRules : la stratégie contient des règles de stratégie en conflit.

• La nouvelle page Erreurs répertorie les erreurs que l'API peut renvoyer. La page inclut des erreurs générales, qui peuvent se produire pour plusieurs méthodes d'API différentes, ainsi que des erreurs spécifiques à une méthode.

18 janvier 2013

Cette mise à jour inclut les changements suivants :

• La méthode videoAdvertisingOptions.getEnabledAds, récemment documentée, vous permet de récupérer des informations sur les types d'annonces autorisés pour une vidéo mise en ligne par un partenaire ou un utilisateur spécifié.

• La définition du paramètre ownershipRestriction de la méthode assetSearch.list a été mise à jour pour indiquer que la valeur par défaut du paramètre est mine, ce qui signifie que l'API ne doit récupérer que les composants appartenant à l'utilisateur actuel.

• La documentation de la méthode assets.list reflète les modifications suivantes:

  • Le paramètre id est désormais obligatoire.

  • Le nouveau paramètre fetchMatchPolicy vous permet d'indiquer si la requête API doit également récupérer la stratégie de correspondance que vous avez définie pour l'asset.

  • Le nouveau paramètre fetchOwnership vous permet d'indiquer si la requête d'API doit également récupérer les données de propriété de l'élément.

  • La liste des composants renvoyés par l'API ne contient plus de données de pagination. Par conséquent, la propriété nextPageToken et l'objet pageInfo ont tous deux été supprimés de la réponse de l'API. L'objet pageInfo contenait les propriétés totalResults, resultsPerPage et startIndex.

• La documentation de la ressource claims a été mise à jour pour indiquer que vous devez spécifier une règle lorsque vous créez une revendication. (YouTube n'applique actuellement pas votre règle d'utilisation par défaut si une revendication insérée ne spécifie pas de règle, même si la documentation indiquait auparavant que c'était le cas.)

• La propriété hasUnpublishedDraft de la ressource policy est obsolète.

• Le nouveau paramètre id de la méthode policies.list vous permet d'identifier les règles enregistrées que la requête API doit récupérer. Seules les règles appartenant au propriétaire du contenu actuellement authentifié peuvent être récupérées.

• La définition du paramètre releaseClaims pour les méthodes references.patch et references.update a été modifiée pour indiquer que le paramètre ne fonctionne que lorsque l'état de la revendication est mis à jour sur inactive. Dans ce cas, vous pouvez également définir la valeur du paramètre releaseClaims sur true pour libérer toutes les revendications de correspondance générées par la référence.

• Les méthodes references.patch et references.update ont été mises à jour pour indiquer que vous devez spécifier l'état de la référence lorsque vous effectuez l'une de ces opérations.

• Plusieurs méthodes d'API sont compatibles avec de nouveaux types d'erreurs. Le tableau ci-dessous identifie la méthode et les nouvelles erreurs compatibles:

  Méthode	Type d'erreur	Détail de l'erreur	Description
  guideCategories.list	notFound	Unavailable	L'élément pour lequel vous essayez de récupérer la règle de correspondance est introuvable.
  claims.get	notFound	Unavailable	La revendication que vous essayez de récupérer est introuvable.
  ownership.patch	invalidValue	Unavailable	Les données de propriété que vous avez fournies contiennent une valeur non valide.
  ownership.update	invalidValue	Unavailable	Les données de propriété que vous avez fournies contiennent une valeur non valide.