Channels

L'API permet désormais de marquer votre chaîne ou vos vidéos comme "conçues pour les enfants". De plus, les ressources channel et video contiennent désormais une propriété qui indique si la chaîne ou la vidéo est conçue pour les enfants. Les conditions d'utilisation des services d'API YouTube et le règlement pour les développeurs ont également été mis à jour le 10 janvier 2020. Pour en savoir plus, consultez l'historique des révisions de l'API YouTube Data et des Conditions d'utilisation des services d'API YouTube.

Une ressource channel contient des informations sur une chaîne YouTube.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources channels :

liste
renvoie une collection de zéro ou plusieurs ressources channel correspondant aux critères de la requête. Essayez-le maintenant.
update
Met à jour les métadonnées d'une chaîne. Notez que cette méthode n'est actuellement compatible qu'avec les mises à jour des objets brandingSettings et invideoPromotion de la ressource channel, ainsi que de leurs propriétés enfants. Essayer maintenant

Représentation des ressources

La structure JSON suivante montre le format d'une ressource channels :

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource :

Propriétés
kind string
Identifie le type de ressource d'API. La valeur sera youtube#channel.
etag etag
Etag de cette ressource.
id string
ID utilisé par YouTube pour identifier de manière unique la chaîne.
snippet object
L'objet snippet contient des informations de base sur la chaîne, telles que son titre, sa description et ses miniatures.
snippet.title string
Titre de la chaîne.
snippet.description string
Description de la chaîne. La valeur de la propriété ne doit pas dépasser 1 000 caractères.
snippet.customUrl string
URL personnalisée de la chaîne. Le Centre d'aide YouTube explique les critères d'éligibilité pour obtenir une URL personnalisée, ainsi que la procédure à suivre pour la configurer.
snippet.publishedAt datetime
Date et heure de création du canal. La valeur est spécifiée au format ISO 8601.
snippet.thumbnails object
Mappage des images miniatures associées à la chaîne. Pour chaque objet du mappage, la clé est le nom de l'image de la miniature, et la valeur est un objet contenant d'autres informations sur la miniature.

Lorsque vous affichez des miniatures dans votre application, assurez-vous que votre code utilise les URL d'image exactement telles qu'elles sont renvoyées dans les réponses de l'API. Par exemple, votre application ne doit pas utiliser le domaine http au lieu du domaine https dans une URL renvoyée dans une réponse de l'API.

Les URL des miniatures de chaîne ne sont disponibles que dans le domaine https, qui correspond à la façon dont les URL apparaissent dans les réponses de l'API. Des images corrompues peuvent s'afficher dans votre application si elle tente de charger des images YouTube à partir du domaine http. Les vignettes peuvent être vides pour les chaînes qui viennent d'être créées et peuvent mettre jusqu'à un jour à se remplir.
snippet.thumbnails.(key) object
Les valeurs de clé valides sont les suivantes :
  • default : image miniature par défaut. La vignette par défaut d'une vidéo (ou d'une ressource qui fait référence à une vidéo, comme un élément de playlist ou un résultat de recherche) mesure 120 pixels de large et 90 pixels de haut. La miniature par défaut d'une chaîne mesure 88 px de large et 88 px de haut.
  • medium : version de la miniature en plus haute résolution. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 320 pixels de large et 180 pixels de haut. Pour une chaîne, cette image mesure 240 px de large sur 240 px de haut.
  • high : version haute résolution de la miniature. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 480 px de large et 360 px de haut. Pour une chaîne, cette image fait 800 px de large et 800 px de haut.
snippet.thumbnails.(key).url string
URL de l'image. Pour obtenir des consignes supplémentaires sur l'utilisation des URL de miniatures dans votre application, consultez la définition de la propriété snippet.thumbnails.
snippet.thumbnails.(key).width unsigned integer
Largeur de l'image.
snippet.thumbnails.(key).height unsigned integer
Hauteur de l'image.
snippet.defaultLanguage string
Langue du texte dans les propriétés snippet.title et snippet.description de la ressource channel.
snippet.localized object
L'objet snippet.localized contient un titre et une description localisés pour la chaîne, ou le titre et la description de la chaîne dans la langue par défaut pour les métadonnées de la chaîne.
  • Le texte localisé est renvoyé dans l'extrait de ressource si la requête channels.list a utilisé le paramètre hl pour spécifier une langue pour laquelle le texte localisé doit être renvoyé, si la valeur de paramètre hl identifie une langue de l'application YouTube et si le texte localisé est disponible dans cette langue.
  • Les métadonnées de la langue par défaut sont renvoyées si aucune valeur de paramètre hl n'est spécifiée ou si une valeur est spécifiée, mais qu'aucune métadonnée localisée n'est disponible pour la langue spécifiée.
La propriété contient une valeur en lecture seule. Utilisez l'objet localizations pour ajouter, mettre à jour ou supprimer des métadonnées localisées.
snippet.localized.title string
Titre localisé de la chaîne.
snippet.localized.description string
Description localisée de la chaîne.
snippet.country string
Pays auquel la chaîne est associée. Pour définir la valeur de cette propriété, modifiez la valeur de la propriété brandingSettings.channel.country.
contentDetails object
L'objet contentDetails encapsule des informations sur le contenu de la chaîne.
contentDetails.relatedPlaylists object
L'objet relatedPlaylists est une carte qui identifie les playlists associées à la chaîne, comme les vidéos mises en ligne ou les vidéos "J'aime" de la chaîne. Vous pouvez récupérer l'une de ces playlists à l'aide de la méthode playlists.list.
contentDetails.relatedPlaylists.likes string
ID de la playlist contenant les vidéos "J'aime" de la chaîne. Utilisez les méthodes playlistItems.insert et playlistItems.delete pour ajouter ou supprimer des éléments de cette liste.
contentDetails.relatedPlaylists.favorites string
Cette propriété est obsolète.

ID de la playlist contenant les vidéos favorites de la chaîne. Utilisez les méthodes playlistItems.insert et playlistItems.delete pour ajouter ou supprimer des éléments de cette liste.

Notez que YouTube a abandonné la fonctionnalité de vidéos favorites. Par exemple, la propriété statistics.favoriteCount de la ressource video est obsolète depuis le 28 août 2015. Par conséquent, pour des raisons historiques, cette valeur de propriété peut contenir un ID de playlist qui fait référence à une playlist vide et qui ne peut donc pas être récupéré.
contentDetails.relatedPlaylists.uploads string
ID de la playlist contenant les vidéos mises en ligne par la chaîne. Utilisez la méthode videos.insert pour importer de nouvelles vidéos et la méthode videos.delete pour supprimer les vidéos précédemment importées.
statistics object
L'objet statistics encapsule les statistiques de la chaîne.
statistics.viewCount unsigned long

Somme du nombre de fois où toutes les vidéos de tous les formats d'une chaîne ont été regardées.

À partir du 24 août 2026, pour tous les formats vidéo (vidéos longues, diffusions en direct et Shorts) d'une chaîne, viewCount sera mis à jour pour comptabiliser les vues dès qu'une vidéo commencera à être lue (y compris en lecture automatique, en maintenant le pointeur sur la vidéo et en cliquant/appuyant pour la lire).
statistics.commentCount unsigned long
Cette propriété est obsolète.

Nombre de commentaires pour la chaîne.
statistics.subscriberCount unsigned long
Nombre d'abonnés de la chaîne. Cette valeur est arrondie à trois chiffres significatifs. Pour en savoir plus sur l'arrondi du nombre d'abonnés, consultez l'historique des révisions ou le Centre d'aide YouTube.
statistics.hiddenSubscriberCount boolean
Indique si le nombre d'abonnés de la chaîne est visible publiquement.
statistics.videoCount unsigned long
Nombre de vidéos publiques mises en ligne sur la chaîne. Notez que la valeur reflète uniquement le nombre de vidéos publiques de la chaîne, même pour les propriétaires. Ce comportement est cohérent avec les nombres affichés sur le site Web YouTube.
topicDetails object
L'objet topicDetails encapsule les informations sur les thèmes associés à la chaîne.

Important : Pour en savoir plus sur les modifications apportées aux ID de thèmes, consultez la définition de la propriété topicDetails.topicIds[] et l'historique des révisions.
topicDetails.topicIds[] list
Liste des ID de thèmes associés à la chaîne.

Cette propriété a été abandonnée le 10 novembre 2016. Elle sera compatible jusqu'au 10 novembre 2017.

Important : En raison de l'abandon de Freebase et de l'API Freebase, les ID de sujet fonctionnent différemment depuis le 27 février 2017. À cette date, YouTube a commencé à renvoyer un petit ensemble d'ID de thèmes sélectionnés.
topicDetails.topicCategories[] list
Liste d'URL Wikipédia décrivant le contenu de la chaîne.
status object
L'objet status encapsule des informations sur l'état de confidentialité de la chaîne.
status.privacyStatus string
État de confidentialité de la chaîne.

Les valeurs valides pour cette propriété sont les suivantes :
  • private
  • public
  • unlisted
status.isLinked boolean
Indique si les données de la chaîne identifient un utilisateur déjà associé à un nom d'utilisateur YouTube ou à un compte Google+. Un utilisateur qui dispose de l'un de ces liens possède déjà une identité YouTube publique, ce qui est un prérequis pour plusieurs actions, comme la mise en ligne de vidéos.
status.longUploadsStatus string
Indique si la chaîne est autorisée à mettre en ligne des vidéos de plus de 15 minutes. Cette propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête API. Pour en savoir plus sur cette fonctionnalité, consultez le Centre d'aide YouTube.

Les valeurs valides pour cette propriété sont les suivantes :
  • allowed : cette chaîne peut mettre en ligne des vidéos de plus de 15 minutes.
  • disallowed : cette chaîne ne peut pas ou n'est pas autorisée à mettre en ligne des vidéos de plus de 15 minutes. Une chaîne n'est autorisée à mettre en ligne des vidéos longues que si elle respecte le Règlement de la communauté YouTube et si son contenu ne fait l'objet d'aucun blocage Content ID mondial.

    Une fois que le propriétaire de la chaîne a résolu les problèmes qui empêchent la mise en ligne de vidéos plus longues, la chaîne revient à l'état allowed ou eligible.
  • eligible : cette chaîne est autorisée à mettre en ligne des vidéos de plus de 15 minutes. Toutefois, le propriétaire de la chaîne doit d'abord activer la mise en ligne de vidéos plus longues en validant son numéro de téléphone. Pour en savoir plus sur cette fonctionnalité, consultez le Centre d'aide YouTube.
status.madeForKids boolean
Cette valeur indique si la chaîne est désignée comme destinée aux enfants et contient l'état actuel "conçue pour les enfants" de la chaîne. Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Pour en savoir plus sur la définition de l'audience de votre chaîne, de vos vidéos ou de vos diffusions, consultez le Centre d'aide YouTube .
status.selfDeclaredMadeForKids boolean
Dans une requête channels.update, cette propriété permet au propriétaire de la chaîne de désigner la chaîne comme étant destinée aux enfants. La valeur de la propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête API.
brandingSettings object
L'objet brandingSettings encapsule les informations sur l'image de marque de la chaîne.
brandingSettings.channel object
L'objet channel encapsule les propriétés de branding de la page de la chaîne.
brandingSettings.channel.title string
Titre de la chaîne. Le titre ne doit pas comporter plus de 30 caractères.
brandingSettings.channel.description string
La description de la chaîne, qui s'affiche dans l'encadré d'informations sur la page de votre chaîne. La valeur de la propriété ne doit pas comporter plus de 1 000 caractères.
brandingSettings.channel.keywords string
Mots clés associés à votre chaîne. La valeur est une liste de chaînes séparées par un espace. Les mots clés de la chaîne peuvent être tronqués s'ils dépassent la longueur maximale autorisée de 500 caractères ou s'ils contiennent des guillemets non échappés ("). Notez que la limite de 500 caractères ne s'applique pas à chaque mot clé, mais à la longueur totale de tous les mots clés.
brandingSettings.channel.trackingAnalyticsAccountId string
ID du compte Google Analytics que vous souhaitez utiliser pour suivre et mesurer le trafic vers votre chaîne.
brandingSettings.channel.unsubscribedTrailer string
Vidéo qui doit être lue dans le module de vidéo sélectionnée de la vue de navigation de la page de la chaîne pour les spectateurs non abonnés. Les spectateurs abonnés peuvent voir une autre vidéo qui met en avant l'activité récente de la chaîne.

Si elle est spécifiée, la valeur de la propriété doit être l'ID vidéo YouTube d'une vidéo publique ou non répertoriée appartenant au propriétaire de la chaîne.
brandingSettings.channel.defaultLanguage string
Langue du texte dans les propriétés snippet.title et snippet.description de la ressource channel.
brandingSettings.channel.country string
Pays auquel la chaîne est associée. Mettez à jour cette propriété pour définir la valeur de la propriété snippet.country.
brandingSettings.watch object
Remarque : Cet objet et toutes ses propriétés enfants ont été abandonnés.

 L'objet watch encapsule les propriétés de branding des pages de lecture des vidéos de la chaîne.
brandingSettings.watch.textColor string
Remarque : Cette propriété est maintenant obsolète.

Couleur du texte de la zone de branding de la page de lecture de la vidéo.
brandingSettings.watch.backgroundColor string
Remarque : Cette propriété est obsolète.

Couleur d'arrière-plan de la zone de branding de la page de lecture de la vidéo.
brandingSettings.watch.featuredPlaylistId string
Remarque : Cette propriété est obsolète. L'API renvoie une erreur si vous essayez de définir sa valeur.
brandingSettings.image object
Cette propriété et toutes ses propriétés enfants sont obsolètes.

L'objet image encapsule des informations sur les images qui s'affichent sur la page de la chaîne ou sur les pages de lecture des vidéos.
brandingSettings.image.bannerImageUrl string
Cette propriété est maintenant obsolète.

URL de l'image de bannière affichée sur la page de la chaîne sur le site Web YouTube. L'image mesure 1 060 x 175 px.
brandingSettings.image.bannerMobileImageUrl string
Cette propriété est maintenant obsolète.

URL de l'image de bannière affichée sur la page de la chaîne dans les applications mobiles. L'image mesure 640 x 175 px.
brandingSettings.image.watchIconImageUrl string
Cette propriété est obsolète.

URL de l'image qui s'affiche au-dessus du lecteur vidéo. Il s'agit d'une image de 25 pixels de haut, dont la largeur est flexible, mais ne peut pas dépasser 170 pixels. Si vous ne fournissez pas cette image, le nom de votre chaîne s'affichera à la place.
brandingSettings.image.trackingImageUrl string
Cette propriété est obsolète.

URL d'un pixel de suivi de 1 x 1 pixel pouvant être utilisé pour collecter des statistiques sur les vues des pages de la chaîne ou de la vidéo.
brandingSettings.image.bannerTabletLowImageUrl string
Cette propriété est maintenant obsolète.

URL d'une image de bannière basse résolution qui s'affiche sur la page de la chaîne dans les applications pour tablette. La taille maximale de l'image est de 1 138 x 188 pixels.
brandingSettings.image.bannerTabletImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière qui s'affiche sur la page de la chaîne dans les applications pour tablettes. L'image mesure 1 707 x 283 px.
brandingSettings.image.bannerTabletHdImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière haute résolution qui s'affiche sur la page de la chaîne dans les applications pour tablette. La taille maximale de l'image est de 2 276 x 377 px.
brandingSettings.image.bannerTabletExtraHdImageUrl string
Cette propriété est maintenant obsolète.

URL d'une image de bannière en très haute résolution qui s'affiche sur la page de chaîne dans les applications pour tablettes. La taille maximale de l'image est de 2 560 x 424 px.
brandingSettings.image.bannerMobileLowImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière basse résolution qui s'affiche sur la page de la chaîne dans les applications mobiles. La taille maximale de l'image est de 320 x 88 px.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière de résolution moyenne qui s'affiche sur la page de chaîne dans les applications mobiles. La taille maximale de l'image est de 960 x 263 px.
brandingSettings.image.bannerMobileHdImageUrl string
Cette propriété est maintenant obsolète.

URL d'une image de bannière haute résolution qui s'affiche sur la page de chaîne dans les applications mobiles. La taille maximale de l'image est de 1 280 x 360 px.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière très haute résolution qui s'affiche sur la page de chaîne dans les applications mobiles. La taille maximale de l'image est de 1 440 x 395 px.
brandingSettings.image.bannerTvImageUrl string
Cette propriété est maintenant obsolète.

URL d'une image de bannière en très haute résolution qui s'affiche sur la page de la chaîne dans les applications pour téléviseur. La taille maximale de l'image est de 2 120 x 1 192 pixels.
brandingSettings.image.bannerTvLowImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière basse résolution qui s'affiche sur la page de la chaîne dans les applications de télévision. La taille maximale de l'image est de 854 x 480 pixels.
brandingSettings.image.bannerTvMediumImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière de résolution moyenne qui s'affiche sur la page de chaîne dans les applications TV. La taille maximale de l'image est de 1 280 x 720 px.
brandingSettings.image.bannerTvHighImageUrl string
Cette propriété est obsolète.

URL d'une image de bannière haute résolution qui s'affiche sur la page de la chaîne dans les applications pour téléviseur. La taille maximale de l'image est de 1 920 x 1 080 px.
brandingSettings.image.bannerExternalUrl string
Cette propriété spécifie l'emplacement de l'image de bannière que YouTube utilise pour générer les différentes tailles d'image de bannière pour une chaîne.
brandingSettings.hints[] list
Cette propriété et toutes ses propriétés enfants sont obsolètes.

L'objet hints encapsule des propriétés de branding supplémentaires.
brandingSettings.hints[].property string
Cette propriété est maintenant obsolète.

Une propriété.
brandingSettings.hints[].value string
Cette propriété est obsolète.

Valeur de la propriété.
auditDetails object
L'objet auditDetails encapsule les données de chaîne qu'un réseau multichaîne évalue pour déterminer s'il doit accepter ou refuser une chaîne spécifique. Notez que toute requête API qui récupère cette partie de ressource doit fournir un jeton d'autorisation contenant le champ d'application https://www.googleapis.com/auth/youtubepartner-channel-audit. De plus, tout jeton utilisant ce champ d'application doit être révoqué lorsque le réseau multichaîne décide d'accepter ou de refuser la chaîne, ou dans les deux semaines suivant la date d'émission du jeton.
auditDetails.overallGoodStanding boolean
Ce champ indique si la chaîne présente des problèmes. Actuellement, ce champ représente le résultat de l'opération logique AND sur les propriétés communityGuidelinesGoodStanding, copyrightStrikesGoodStanding et contentIdClaimsGoodStanding. Cela signifie que cette propriété a une valeur de true si toutes les autres propriétés ont également une valeur de true. Toutefois, cette propriété aura une valeur de false si l'une de ces propriétés a une valeur de false. Notez toutefois que la méthodologie utilisée pour définir la valeur de cette propriété est susceptible de changer.
auditDetails.communityGuidelinesGoodStanding boolean
Indique si la chaîne respecte le règlement de la communauté YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
Indique si la chaîne a reçu des avertissements pour atteinte aux droits d'auteur.
auditDetails.contentIdClaimsGoodStanding boolean
Indique si la chaîne fait l'objet de revendications non résolues.
contentOwnerDetails object
L'objet contentOwnerDetails encapsule les données de chaîne qui ne sont visibles que par le partenaire YouTube ayant associé la chaîne à son Gestionnaire de contenu.
contentOwnerDetails.contentOwner string
ID du propriétaire de contenu associé à la chaîne.
contentOwnerDetails.timeLinked datetime
Date et heure auxquelles la chaîne a été associée au propriétaire de contenu. La valeur est spécifiée au format ISO 8601.
localizations object
L'objet localizations encapsule les traductions des métadonnées de la chaîne.
localizations.(key) object
Langue des métadonnées localisées associées à la valeur clé. La valeur est une chaîne contenant un code de langue BCP-47.
localizations.(key).title string
Titre localisé de la chaîne.
localizations.(key).description string
Description localisée de la chaîne.