Activities

YouTube a abandonné la fonctionnalité de bulletin de chaîne. La méthode activities.list ne renvoie toujours pas de bulletins de chaîne, et la méthode activities.insert n'est plus prise en charge. Pour en savoir plus, consultez le Centre d'aide YouTube.

Une ressource activity contient des informations sur une action effectuée par une chaîne ou un utilisateur spécifique sur YouTube. Les actions signalées dans les flux d'activité incluent l'évaluation d'une vidéo, le partage d'une vidéo, l'ajout d'une vidéo aux favoris, la mise en ligne d'une vidéo, etc. Chaque ressource activity identifie le type d'action, la chaîne associée à l'action et la ou les ressources associées à l'action, comme la vidéo notée ou mise en ligne.

Méthodes

L'API accepte les méthodes suivantes pour les ressources activities:

list

Renvoie la liste des événements d'activité de la chaîne correspondant aux critères de la requête. Par exemple, vous pouvez récupérer les événements associés à un canal spécifique ou au canal d'un utilisateur. Essayer

La méthode activities.insert n'est plus prise en charge.

Représentation des ressources

La structure JSON suivante illustre le format d'une ressource activities:

{
  "kind": "youtube#activity",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "type": string,
    "groupId": string
  },
  "contentDetails": {
    "upload": {
      "videoId": string
    },
    "like": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "favorite": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "subscription": {
      "resourceId": {
        "kind": string,
        "channelId": string,
      }
    },
    "playlistItem": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      },
      "playlistId": string,
      "playlistItemId": string
    },
    "recommendation": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      },
      "reason": string,
      "seedResourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "social": {
      "type": string,
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "author": string,
      "referenceUrl": string,
      "imageUrl": string
    },
    "channelItem": {
      "resourceId": {
      }
    },
  }
}

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 API. La valeur est youtube#activity.
etag	etag Etag de cette ressource.
id	string ID utilisé par YouTube pour identifier l'activité de manière unique.
snippet	object L'objet snippet contient des informations de base sur l'activité, y compris son type et son ID de groupe.
snippet.publishedAt	datetime Date et heure de l'activité. La valeur est spécifiée au format ISO 8601.
snippet.channelId	string ID utilisé par YouTube pour identifier de façon unique la chaîne associée à l'activité.
snippet.title	string Titre de la ressource principalement associée à l'activité.
snippet.description	string Description de la ressource principalement associée à l'activité.
snippet.thumbnails	object Carte de vignettes associées à la ressource principalement associée à l'activité. Pour chaque objet de la carte, la clé correspond au nom de la vignette, tandis que la valeur est un objet contenant d'autres informations sur la vignette.
snippet.thumbnails.(key)	object Les clés-valeurs valides sont les suivantes: default : vignette par défaut. La miniature par défaut d'une vidéo (ou d'une ressource faisant référence à une vidéo, comme un élément de playlist ou un résultat de recherche) mesure 120 pixels de large sur 90 pixels de haut. Par défaut, la miniature d'une chaîne mesure 88 pixels de large sur 88 pixels de haut. medium : version haute résolution de l'image de la miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 pixels de large sur 180 pixels de haut. Pour une chaîne, cette image mesure 240 pixels de large sur 240 pixels de haut. high : version haute résolution de l'image de la miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 pixels de large sur 360 pixels de haut. Pour une chaîne, cette image mesure 800 pixels de large sur 800 pixels de haut. standard : version encore plus élevée de l'image miniature que celle de la résolution high. Cette image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image mesure 640 pixels de large sur 480 pixels de haut. maxres : version avec la résolution la plus élevée de l'image de la miniature. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources qui se rapportent à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image mesure 1 280 pixels de large sur 720 pixels de haut.
snippet.thumbnails.(key).url	string URL de l'image.
snippet.thumbnails.(key).width	unsigned integer Largeur de l'image.
snippet.thumbnails.(key).height	unsigned integer Hauteur de l'image.
snippet.channelTitle	string Titre de la chaîne à l'origine de cette activité
snippet.type	string Type d'activité décrit par la ressource. Les valeurs valides pour cette propriété sont les suivantes : channelItem comment – (pas actuellement renvoyé) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (obsolète)
snippet.groupId	string ID de groupe associé à l'activité. Un ID de groupe identifie les événements utilisateur associés à un même utilisateur et à une même ressource. Par exemple, si un utilisateur évalue une vidéo et la marque comme favori, les entrées associées à ces événements auront le même identifiant de groupe dans le flux d'activités de l'utilisateur. Dans votre interface utilisateur, vous pouvez éviter les répétitions en regroupant les événements ayant la même valeur groupId.
contentDetails	object L'objet contentDetails contient des informations sur le contenu associé à l'activité. Par exemple, si la valeur snippet.type est videoRated, le contenu de l'objet contentDetails identifie la vidéo évaluée.
contentDetails.upload	object L'objet upload contient des informations sur la vidéo mise en ligne. Cette propriété n'est présente que si snippet.type est défini sur upload.
contentDetails.upload.videoId	string ID utilisé par YouTube pour identifier de façon unique la vidéo mise en ligne.
contentDetails.like	object L'objet like contient des informations sur une ressource ayant reçu une note positive (j'aime). Cette propriété n'est présente que si snippet.type est défini sur like.
contentDetails.like.resourceId	object L'objet resourceId contient des informations qui identifient la ressource évaluée.
contentDetails.like.resourceId.kind	string Type de ressource API.
contentDetails.like.resourceId.videoId	string ID utilisé par YouTube pour identifier la vidéo de façon unique, si la ressource évaluée est une vidéo. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#video.
contentDetails.favorite	object L'objet favorite contient des informations sur une vidéo qui a été marquée comme vidéo préférée. Cette propriété n'est présente que si snippet.type est défini sur favorite.
contentDetails.favorite.resourceId	object L'objet resourceId contient des informations qui identifient la ressource marquée comme favorite.
contentDetails.favorite.resourceId.kind	string Type de ressource API.
contentDetails.favorite.resourceId.videoId	string ID utilisé par YouTube pour identifier votre vidéo préférée. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#video. Remarque:Actuellement, la méthode activities.list ne renvoie pas de ressources pour les nouveaux commentaires.
contentDetails.comment	object L'objet comment contient des informations sur une ressource qui a reçu un commentaire. Cette propriété n'est présente que si snippet.type est défini sur comment.
contentDetails.comment.resourceId	object L'objet resourceId contient des informations qui identifient la ressource associée au commentaire.
contentDetails.comment.resourceId.kind	string Type de ressource API.
contentDetails.comment.resourceId.videoId	string ID utilisé par YouTube pour identifier de façon unique la vidéo associée à un commentaire. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#video.
contentDetails.comment.resourceId.channelId	string ID utilisé par YouTube pour identifier de façon unique la chaîne associée à un commentaire. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#channel.
contentDetails.subscription	object L'objet subscription contient des informations sur une chaîne à laquelle un utilisateur est abonné. Cette propriété n'est présente que si snippet.type est défini sur subscription.
contentDetails.subscription.resourceId	object L'objet resourceId contient des informations qui identifient la ressource à laquelle l'utilisateur s'est abonné.
contentDetails.subscription.resourceId.kind	string Type de ressource API.
contentDetails.subscription.resourceId.channelId	string ID utilisé par YouTube pour identifier de façon unique la chaîne à laquelle l'utilisateur est abonné. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#channel.
contentDetails.playlistItem	object L'objet playlistItem contient des informations sur un nouvel élément de playlist. Cette propriété n'est présente que si snippet.type est défini sur playlistItem.
contentDetails.playlistItem.resourceId	object L'objet resourceId contient des informations qui identifient la ressource ajoutée à la playlist.
contentDetails.playlistItem.resourceId.kind	string Type de ressource API.
contentDetails.playlistItem.resourceId.videoId	string ID utilisé par YouTube pour identifier de façon unique la vidéo ajoutée à la playlist. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#video.
contentDetails.playlistItem.playlistId	string Valeur utilisée par YouTube pour identifier de façon unique la playlist.
contentDetails.playlistItem.playlistItemId	string Valeur utilisée par YouTube pour identifier de façon unique l'élément de la playlist.
contentDetails.recommendation	object L'objet recommendation contient des informations sur une ressource recommandée. Cette propriété n'est présente que si snippet.type est défini sur recommendation.
contentDetails.recommendation.resourceId	object L'objet resourceId contient des informations qui identifient la ressource recommandée.
contentDetails.recommendation.resourceId.kind	string Type de ressource API.
contentDetails.recommendation.resourceId.videoId	string ID utilisé par YouTube pour identifier la vidéo de façon unique, si la ressource recommandée est une vidéo. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#video.
contentDetails.recommendation.resourceId.channelId	string ID utilisé par YouTube pour identifier la chaîne de manière unique, si la ressource recommandée est une chaîne. Cette propriété n'est présente que si resourceId.kind est défini sur youtube#channel.
contentDetails.recommendation.reason	string Raison pour laquelle la ressource est recommandée à l'utilisateur. Les valeurs valides pour cette propriété sont les suivantes : videoFavorited videoLiked videoWatched
contentDetails.recommendation.seedResourceId	object L'objet seedResourceId contient des informations sur la ressource à l'origine de la recommandation.
contentDetails.recommendation.seedResourceId.kind	string Type de ressource API.
contentDetails.recommendation.seedResourceId.videoId	string ID utilisé par YouTube pour identifier la vidéo de façon unique si la recommandation provient d'une vidéo en particulier. Cette propriété n'est présente que si seedResourceId.kind est défini sur youtube#video.
contentDetails.recommendation.seedResourceId.channelId	string ID utilisé par YouTube pour identifier la chaîne de façon unique si la recommandation a été créée par une chaîne en particulier. Cette propriété n'est présente que si seedResourceId.kind est défini sur youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string ID utilisé par YouTube pour identifier la playlist de façon unique si la recommandation provient d'une playlist spécifique. Cette propriété n'est présente que si seedResourceId.kind est défini sur youtube#playlist.
contentDetails.social	object L'objet social contient des détails sur un post sur un réseau social. Cette propriété n'est présente que si snippet.type est défini sur social.
contentDetails.social.type	string Nom du réseau social. Les valeurs valides pour cette propriété sont les suivantes : facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object L'objet resourceId encapsule les informations qui identifient la ressource associée à un post sur un réseau social.
contentDetails.social.resourceId.kind	string Type de ressource API.
contentDetails.social.resourceId.videoId	string ID utilisé par YouTube pour identifier de façon unique la vidéo présentée dans un post sur un réseau social, si celui-ci fait référence à une vidéo. Cette propriété n'est présente que si la valeur de la propriété social.resourceId.kind est youtube#video.
contentDetails.social.resourceId.channelId	string ID utilisé par YouTube pour identifier de façon unique la chaîne présentée dans un post sur un réseau social, si ce dernier fait référence à une chaîne. Cette propriété n'est présente que si la valeur de la propriété social.resourceId.kind est youtube#channel.
contentDetails.social.resourceId.playlistId	string ID utilisé par YouTube pour identifier de façon unique la playlist présentée dans un post sur un réseau social, si ce dernier fait référence à une playlist. Cette propriété n'est présente que si la valeur de la propriété social.resourceId.kind est youtube#playlist.
contentDetails.social.author	string Auteur du post sur le réseau social.
contentDetails.social.referenceUrl	string URL du post sur le réseau social.
contentDetails.social.imageUrl	string Image de l'auteur du post.
contentDetails.channelItem	object L'objet channelItem contient des informations sur une ressource ajoutée à un canal. Cette propriété n'est présente que si snippet.type est défini sur channelItem.
contentDetails.channelItem.resourceId	object L'objet resourceId contient des informations qui identifient la ressource ajoutée au canal.