Cette page a été traduite par l'API Cloud Translation.

Activities

YouTube a abandonné le 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 acceptée. 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 sur YouTube. Les actions enregistrées dans les flux d'activités comprennent 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 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 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 particulier ou au canal de l'utilisateur. Essayer

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

Représentation des ressources

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
    },
    "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 d'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 le type et l'ID du 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 des vignettes associées à la ressource principalement associée à l'activité. Pour chaque objet de la carte, la clé est le nom de la vignette et 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 et 90 pixels de haut. La miniature par défaut d'une chaîne fait 88 pixels de large et 88 pixels de haut. `medium` : version de la miniature dans une résolution plus élevée. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 pixels de large et 180 pixels de haut. Pour une chaîne, elle mesure 240 pixels de large et 240 pixels de haut. `high` : version haute résolution de l'image miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 pixels de large et 360 pixels de haut. Pour une chaîne, elle mesure 800 pixels de large et 800 pixels de haut. `standard` : version de l'image miniature dans une résolution encore supérieure à celle de l'image avec une résolution `high`. Cette image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 640 pixels de large et 480 pixels de haut. `maxres` : version de la miniature avec la résolution la plus élevée. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 1 280 pixels de large et 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 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) `favorite` `like` `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload` `bulletin` (obsolète)
`snippet.groupId`	`string` ID du 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 évalue une vidéo et la marque comme favori, les entrées correspondant à 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 la ressource API.
`contentDetails.like.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier de façon unique la vidéo, 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 marquée comme vidéo favorite. 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 la ressource API.
`contentDetails.favorite.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier la vidéo préférée de manière unique. 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 ayant 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 la 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 est abonné.
`contentDetails.subscription.resourceId.kind`	`string` Type de la 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 la 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 la playlist de manière unique.
`contentDetails.playlistItem.playlistItemId`	`string` Valeur utilisée par YouTube pour identifier de façon unique l'élément dans 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 la ressource API.
`contentDetails.recommendation.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier la vidéo de manière 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 la ressource API.
`contentDetails.recommendation.seedResourceId.videoId`	`string` ID utilisé par YouTube pour identifier la vidéo de façon unique, si la recommandation a été créée par 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 en particulier. 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 informations 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 la ressource API.
`contentDetails.social.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier de façon unique la vidéo figurant 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 celui-ci 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 celui-ci 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 les réseaux sociaux.
`contentDetails.social.referenceUrl`	`string` URL du post sur le réseau social.
`contentDetails.social.imageUrl`	`string` Image de l'auteur de l'article.
`contentDetails.channelItem`	`object` L'objet `channelItem` contient des informations sur une ressource qui a été 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 qui a été ajoutée au canal.