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

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 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 les ressources associées à l'action, comme la vidéo qui a été évaluée ou mise en ligne.

Méthodes

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

liste: Renvoie la liste des é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 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
    },
    "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 de l'API. La valeur sera `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 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` Map des miniatures associées à la ressource principalement associée à l'activité. Pour chaque objet de la carte, la clé correspond au nom de la 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 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 x 88 pixels. `medium` : 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 320 px de large et 180 px de haut. Pour une chaîne, cette image doit mesurer 240 x 240 pixels. `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 doit avoir une largeur et une hauteur de 800 px. `standard` : version de la miniature avec une résolution encore plus élevée que celle de l'image `high`. Cette image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme les éléments de playlist ou les résultats de recherche. Cette image mesure 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 qui font référence à des vidéos, comme les éléments de playlist ou les 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é actuellement) `favorite` `like` `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload`
`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 favorite, 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 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 manière unique la vidéo mise en ligne.
`contentDetails.like`	`object` L'objet `like` contient des informations sur une ressource qui a reçu une évaluation 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 d'API.
`contentDetails.like.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier de manière 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 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 ressource d'API.
`contentDetails.favorite.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier de manière unique la vidéo ajoutée aux favoris. Cette propriété n'est présente que si `resourceId.kind` est défini sur `youtube#video`. Remarque : La méthode `activities.list` ne renvoie actuellement 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 d'API.
`contentDetails.comment.resourceId.videoId`	`string` ID utilisé par YouTube 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 défini sur `youtube#video`.
`contentDetails.comment.resourceId.channelId`	`string` ID utilisé par YouTube 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 défini sur `youtube#channel`.
`contentDetails.subscription`	`object` L'objet `subscription` contient des informations sur une chaîne à laquelle un utilisateur s'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 d'API.
`contentDetails.subscription.resourceId.channelId`	`string` ID utilisé par YouTube pour identifier de manière unique la chaîne à laquelle l'utilisateur s'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 d'API.
`contentDetails.playlistItem.resourceId.videoId`	`string` ID utilisé par YouTube 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 défini sur `youtube#video`.
`contentDetails.playlistItem.playlistId`	`string` Valeur utilisée par YouTube pour identifier de manière unique la playlist.
`contentDetails.playlistItem.playlistItemId`	`string` Valeur utilisée par YouTube 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 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 d'API.
`contentDetails.recommendation.resourceId.videoId`	`string` ID utilisé par YouTube 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 défini sur `youtube#video`.
`contentDetails.recommendation.resourceId.channelId`	`string` ID utilisé par YouTube 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 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 qui a généré la recommandation.
`contentDetails.recommendation.seedResourceId.kind`	`string` Type de ressource d'API.
`contentDetails.recommendation.seedResourceId.videoId`	`string` ID utilisé par YouTube 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 défini sur `youtube#video`.
`contentDetails.recommendation.seedResourceId.channelId`	`string` ID utilisé par YouTube pour identifier de manière unique la chaîne, si la recommandation a été générée par une chaîne spécifique. 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 de manière unique la playlist, si la recommandation a été générée par 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 informations sur un post de 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 les réseaux sociaux.
`contentDetails.social.resourceId.kind`	`string` Type de ressource d'API.
`contentDetails.social.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier de manière unique la vidéo présentée dans un post sur les réseaux sociaux, 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 utilisé par YouTube pour identifier de manière unique la chaîne mentionnée dans un post sur les réseaux sociaux, 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 utilisé par YouTube pour identifier de manière unique la playlist présentée dans un post sur les réseaux sociaux, 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 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 qui a été ajoutée à une chaîne. 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 à la chaîne.

Activities Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Méthodes

Représentation de la ressource

Propriétés

Activities