Activities

Une ressource activity contient des informations sur une action qu'une chaîne ou un utilisateur spécifique a effectuée sur YouTube. Les actions signalées dans les flux d'activité incluent le partage d'une vidéo, 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 les ressources associées à l'action, comme la vidéo qui a été évaluée ou mise en ligne.

Méthodes

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

liste

Renvoie une liste d'événements d'activité de la chaîne qui correspondent aux critères de la requête. Par exemple, vous pouvez récupérer les événements associés à une chaîne spécifique ou à la propre chaîne de l'utilisateur. Essayer.

Représentation de la ressource

La structure JSON suivante montre 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
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": 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 de l'API. La valeur sera youtube#activity.
etag	etag Etag de cette ressource.
id	string ID que YouTube utilise 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 auxquelles l'activité s'est produite. La valeur est spécifiée au format ISO 8601.
snippet.channelId	string ID que YouTube utilise pour identifier de manière 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 Mappage des images miniatures associées à la ressource principalement associée à l'activité. Pour chaque objet du mappage, la clé correspond au nom de l'image miniature, et la valeur est un objet contenant d'autres informations sur la miniature.
snippet.thumbnails.(key)	object Les valeurs de clé valides sont les suivantes : default : image miniature par défaut. La miniature 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 px de large et 90 px de haut. La miniature par défaut d'une chaîne mesure 88 px de large et 88 px de haut. medium : version haute résolution de l'image miniature. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 320 px de large et 180 px de haut. Pour une chaîne, cette image mesure 240 px de large et 240 px de haut. high : version haute résolution de l'image 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 mesure 800 px de large et 800 px de haut. standard : version de l'image miniature avec une résolution encore plus élevée que l'image high résolution. Cette image est disponible pour certaines vidéos et 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 px de large et 480 px de haut. maxres : version de l'image miniature avec la résolution la plus élevée. Cette taille d'image est disponible pour certaines vidéos et 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 1 280 px de large et 720 px 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 responsable 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 (non renvoyé pour le moment) playlistItem promotedItem recommendation social upload
snippet.groupId	string ID de groupe associé à l'activité. Un ID de groupe identifie les événements utilisateur associés au même utilisateur et à la même ressource. Par exemple, si un utilisateur met en ligne une vidéo et la regarde, les entrées de ces événements auront le même ID de groupe dans le flux d'activité de l'utilisateur. Dans votre interface utilisateur, vous pouvez éviter les répétitions en regroupant les événements avec 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 upload.
contentDetails.upload.videoId	string ID que YouTube utilise pour identifier de manière unique la vidéo mise en ligne.
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 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 la ressource de l'API.
contentDetails.comment.resourceId.videoId	string ID que YouTube utilise pour identifier de manière unique la vidéo associée à un commentaire. Cette propriété n'est présente que si resourceId.kind est youtube#video.
contentDetails.comment.resourceId.channelId	string ID que YouTube utilise pour identifier de manière unique la chaîne associée à un commentaire. Cette propriété n'est présente que si resourceId.kind est 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 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 la ressource de l'API.
contentDetails.playlistItem.resourceId.videoId	string ID que YouTube utilise pour identifier de manière unique la vidéo ajoutée à la playlist. Cette propriété n'est présente que si resourceId.kind est youtube#video.
contentDetails.playlistItem.playlistId	string Valeur que YouTube utilise pour identifier de manière unique la playlist.
contentDetails.playlistItem.playlistItemId	string Valeur que YouTube utilise pour identifier de manière 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 recommendation.
contentDetails.recommendation.resourceId	object L'objet resourceId contient des informations qui identifient la ressource recommandée.
contentDetails.recommendation.resourceId.kind	string Type de la ressource de l'API.
contentDetails.recommendation.resourceId.videoId	string ID que YouTube utilise pour identifier de manière unique la vidéo, si la ressource recommandée est une vidéo. Cette propriété n'est présente que si resourceId.kind est youtube#video.
contentDetails.recommendation.resourceId.channelId	string ID que YouTube utilise pour identifier de manière unique la chaîne, si la ressource recommandée est une chaîne. Cette propriété n'est présente que si resourceId.kind est 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 : videoWatched
contentDetails.recommendation.seedResourceId	object L'objet seedResourceId contient des informations sur la ressource qui a entraîné la recommandation.
contentDetails.recommendation.seedResourceId.kind	string Type de la ressource de l'API.
contentDetails.recommendation.seedResourceId.videoId	string ID que YouTube utilise pour identifier de manière unique la vidéo, si la recommandation a été causée par une vidéo spécifique. Cette propriété n'est présente que si seedResourceId.kind est youtube#video.
contentDetails.recommendation.seedResourceId.channelId	string ID que YouTube utilise pour identifier de manière unique la chaîne, si la recommandation a été causée par une chaîne spécifique. Cette propriété n'est présente que si seedResourceId.kind est youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string ID que YouTube utilise pour identifier de manière unique la playlist, si la recommandation a été causée par une playlist spécifique. Cette propriété n'est présente que si seedResourceId.kind est youtube#playlist.
contentDetails.social	object L'objet social contient des informations sur un post de réseau social. Cette propriété n'est présente que si snippet.type est 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 de réseau social.
contentDetails.social.resourceId.kind	string Type de la ressource de l'API.
contentDetails.social.resourceId.videoId	string ID que YouTube utilise pour identifier de manière unique la vidéo présentée dans un post de réseau social, si le post 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 que YouTube utilise pour identifier de manière unique la chaîne présentée dans un post de réseau social, si le post 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 que YouTube utilise pour identifier de manière unique la playlist présentée dans un post de réseau social, si le post 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 de réseau social.
contentDetails.social.referenceUrl	string URL du post de 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 à une chaîne. Cette propriété n'est présente que si snippet.type est channelItem.
contentDetails.channelItem.resourceId	object L'objet resourceId contient des informations qui identifient la ressource ajoutée à la chaîne.