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

Activities

YouTube a abandonné la fonctionnalité Bulletin de chaîne. La méthode activities.list effectue mais pas les bulletins de chaîne, La méthode activities.insert n'est pas n'est plus pris en charge. Pour en savoir plus, consultez les 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 consignées dans les flux d'activité incluent l'évaluation d'une vidéo, son partage, son ajout aux favoris, sa mise en ligne, 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 évaluée ou mise en ligne.

Méthodes

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

liste: Renvoie une liste d'é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 à la chaîne d'un utilisateur. Essayer

La méthode activities.insert n'est plus acceptée.

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 sera `youtube#activity`.
`etag`	`etag` ETag de cette ressource.
`id`	`string` ID utilisé par YouTube pour identifier l'activité de façon 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, et la valeur à un objet contenant d'autres informations sur la vignette.
`snippet.thumbnails.(key)`	`object` Les valeurs des clés valides sont les suivantes: `default` : vignette 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 une 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 pixels de large et 88 pixels de haut. `medium` : version haute résolution de la vignette. 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, cette image mesure 240 pixels de large et 240 pixels de haut. `high` : version haute résolution de la vignette. 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, cette image mesure 800 pixels de large et 800 pixels de haut. `standard` : version de l'image miniature encore plus haute que 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 mesure 640 pixels de large et 480 pixels de haut. `maxres` : version avec la plus haute résolution de la vignette. Cette taille d'image est disponible pour certaines vidéos et autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image mesure 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 à l'origine de cette activité
`snippet.type`	`string` Type d'activité décrit par la ressource. Les valeurs acceptées pour cette propriété sont les suivantes: <ph type="x-smartling-placeholder"> </ph> `channelItem` `comment` – (pas de retour actuellement) `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 donne son avis sur 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 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`, alors 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 (like). 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 la vidéo de manière 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é définie 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 ressource d'API.
`contentDetails.favorite.resourceId.videoId`	`string` ID utilisé par YouTube pour identifier de façon unique la vidéo préférée. 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 aucune ressource 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 ressource d'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 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 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 la 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 qui a été 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 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 façon 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 ressource d'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: <ph type="x-smartling-placeholder"> </ph> `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 d'API.
`contentDetails.recommendation.seedResourceId.videoId`	`string` ID utilisé par YouTube pour identifier de façon unique la vidéo, si la recommandation a été créée pour 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 manière unique, si la recommandation a été créée pour 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 de façon 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 détails sur un post publié 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 acceptées pour cette propriété sont les suivantes: <ph type="x-smartling-placeholder"> </ph> `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 d'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 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 façon unique la chaîne présentée dans un post sur un 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 utilisé par YouTube pour identifier de façon unique la playlist utilisée dans un post sur un 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 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 qui a été ajoutée au canal.