Activities

Un recurso activity contiene información sobre una acción que un canal o usuario en particular realizó en YouTube. Las acciones informadas en los feeds de actividad incluyen compartir un video, subir un video, etcétera. Cada recurso activity identifica el tipo de acción, el canal asociado con la acción y los recursos asociados con la acción, como el video que se calificó o subió.

Métodos

La API admite los siguientes métodos para los recursos activities:

list

Muestra una lista de eventos de actividad del canal que coinciden con los criterios de la solicitud. Por ejemplo, puedes recuperar eventos asociados con un canal en particular o con el canal del usuario. Pruébala ahora.

Representación de recursos

La siguiente estructura JSON muestra el formato de un recurso 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": {
      }
    },
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind	string Identifica el tipo de recurso de la API. El valor será youtube#activity.
etag	etag Es el Etag de este recurso.
id	string Es el ID que YouTube usa para identificar de forma exclusiva la actividad.
snippet	object El objeto snippet contiene detalles básicos sobre la actividad, incluido el tipo de actividad y el ID de grupo.
snippet.publishedAt	datetime Es la fecha y hora en que ocurrió la actividad. El valor se especifica en formato ISO 8601.
snippet.channelId	string Es el ID que YouTube usa para identificar de forma exclusiva el canal asociado con la actividad.
snippet.title	string Es el título del recurso asociado principalmente con la actividad.
snippet.description	string Es la descripción del recurso asociado principalmente con la actividad.
snippet.thumbnails	object Es un mapa de imágenes en miniatura asociadas con el recurso que está asociado principalmente con la actividad. Para cada objeto en el mapa, la clave es el nombre de la imagen en miniatura, y el valor es un objeto que contiene otra información sobre la viñeta.
snippet.thumbnails.(key)	object Los valores de clave válidos son los siguientes: default: Es la imagen en miniatura predeterminada. La miniatura predeterminada para un video (o un recurso que hace referencia a un video, como un elemento de playlist o un resultado de búsqueda) es de 120 px de ancho y 90 px de alto. La viñeta predeterminada para un canal es de 88 píxeles de ancho y 88 píxeles de alto. medium: Es una versión de mayor resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 320 píxeles de ancho y 180 píxeles de alto. Para un canal, esta imagen es de 240 píxeles de ancho y 240 píxeles de alto. high: Es una versión de alta resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 480 píxeles de ancho y 360 píxeles de alto. Para un canal, esta imagen es de 800 píxeles de ancho y 800 píxeles de alto. standard: Es una versión de resolución aún más alta de la imagen en miniatura que la imagen de resolución high. Esta imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de playlist o resultados de búsqueda. Esta imagen es de 640 píxeles de ancho y 480 píxeles de alto. maxres: Es la versión de mayor resolución de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de playlist o resultados de búsqueda. Esta imagen es de 1280 píxeles de ancho y 720 píxeles de alto.
snippet.thumbnails.(key).url	string Es la URL de la imagen.
snippet.thumbnails.(key).width	unsigned integer Es el ancho de la imagen.
snippet.thumbnails.(key).height	unsigned integer Es la altura de la imagen.
snippet.channelTitle	string Es el título del canal responsable de esta actividad.
snippet.type	string Es el tipo de actividad que describe el recurso. Los valores válidos para esta propiedad son los siguientes: channelItem comment (no se muestra actualmente) playlistItem promotedItem recommendation social upload
snippet.groupId	string Es el ID de grupo asociado con la actividad. Un ID de grupo identifica los eventos de usuarios que están asociados con el mismo usuario y los recursos. Por ejemplo, si un usuario sube un video y mira el mismo video, las entradas de esos eventos tendrían el mismo ID de grupo en el feed de actividad del usuario. En la interfaz de usuario, puedes evitar la repetición agrupando eventos con el mismo valor groupId.
contentDetails	object El objeto contentDetails contiene información sobre el contenido asociado con la actividad. Por ejemplo, si el valor snippet.type es videoRated, el contenido del objeto contentDetails identifica el video calificado.
contentDetails.upload	object El objeto upload contiene información sobre el video subido. Esta propiedad solo está presente si snippet.type es upload.
contentDetails.upload.videoId	string Es el ID que YouTube usa para identificar de forma exclusiva el video subido.
contentDetails.comment	object El objeto comment contiene información sobre un recurso que recibió un comentario. Esta propiedad solo está presente si snippet.type es comment.
contentDetails.comment.resourceId	object El objeto resourceId contiene información que identifica el recurso asociado con el comentario.
contentDetails.comment.resourceId.kind	string Es el tipo de recurso de la API.
contentDetails.comment.resourceId.videoId	string Es el ID que YouTube usa para identificar de forma exclusiva el video asociado con un comentario. Esta propiedad solo está presente si resourceId.kind es youtube#video.
contentDetails.comment.resourceId.channelId	string Es el ID que YouTube usa para identificar de forma exclusiva el canal asociado con un comentario. Esta propiedad solo está presente si resourceId.kind es youtube#channel.
contentDetails.playlistItem	object El objeto playlistItem contiene información sobre un nuevo elemento de playlist. Esta propiedad solo está presente si snippet.type es playlistItem.
contentDetails.playlistItem.resourceId	object El objeto resourceId contiene información que identifica el recurso que se agregó a la playlist.
contentDetails.playlistItem.resourceId.kind	string Es el tipo de recurso de la API.
contentDetails.playlistItem.resourceId.videoId	string Es el ID que YouTube usa para identificar de forma exclusiva el video que se agregó a la playlist. Esta propiedad solo está presente si resourceId.kind es youtube#video.
contentDetails.playlistItem.playlistId	string Es el valor que YouTube usa para identificar de forma exclusiva la playlist.
contentDetails.playlistItem.playlistItemId	string Es el valor que YouTube usa para identificar de forma exclusiva el elemento de la playlist.
contentDetails.recommendation	object El objeto recommendation contiene información sobre un recurso recomendado. Esta propiedad solo está presente si snippet.type es recommendation.
contentDetails.recommendation.resourceId	object El objeto resourceId contiene información que identifica el recurso recomendado.
contentDetails.recommendation.resourceId.kind	string Es el tipo de recurso de la API.
contentDetails.recommendation.resourceId.videoId	string Es el ID que YouTube usa para identificar de forma exclusiva el video, si el recurso recomendado es un video. Esta propiedad solo está presente si resourceId.kind es youtube#video.
contentDetails.recommendation.resourceId.channelId	string Es el ID que YouTube usa para identificar de forma exclusiva el canal, si el recurso recomendado es un canal. Esta propiedad solo está presente si resourceId.kind es youtube#channel.
contentDetails.recommendation.reason	string Es el motivo por el que se recomienda el recurso al usuario. Los valores válidos para esta propiedad son los siguientes: videoWatched
contentDetails.recommendation.seedResourceId	object El objeto seedResourceId contiene información sobre el recurso que causó la recomendación.
contentDetails.recommendation.seedResourceId.kind	string Es el tipo de recurso de la API.
contentDetails.recommendation.seedResourceId.videoId	string Es el ID que YouTube usa para identificar de forma exclusiva el video, si la recomendación fue causada por un video en particular. Esta propiedad solo está presente si seedResourceId.kind es youtube#video.
contentDetails.recommendation.seedResourceId.channelId	string Es el ID que YouTube usa para identificar de forma exclusiva el canal, si la recomendación fue causada por un canal en particular. Esta propiedad solo está presente si seedResourceId.kind es youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string Es el ID que YouTube usa para identificar de forma exclusiva la playlist, si la recomendación fue causada por una playlist en particular. Esta propiedad solo está presente si seedResourceId.kind es youtube#playlist.
contentDetails.social	object El objeto social contiene detalles sobre una publicación de red social. Esta propiedad solo está presente si snippet.type es social.
contentDetails.social.type	string Es el nombre de la red social. Los valores válidos para esta propiedad son los siguientes: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object El objeto resourceId encapsula información que identifica el recurso asociado con una publicación de red social.
contentDetails.social.resourceId.kind	string Es el tipo de recurso de la API.
contentDetails.social.resourceId.videoId	string Es el ID que YouTube usa para identificar de forma exclusiva el video que aparece en una publicación de red social, si la publicación hace referencia a un video. Esta propiedad solo estará presente si el valor de la propiedad social.resourceId.kind es youtube#video.
contentDetails.social.resourceId.channelId	string Es el ID que YouTube usa para identificar de forma exclusiva el canal que aparece en una publicación de red social, si la publicación hace referencia a un canal. Esta propiedad solo estará presente si el valor de la propiedad social.resourceId.kind es youtube#channel.
contentDetails.social.resourceId.playlistId	string Es el ID que YouTube usa para identificar de forma exclusiva la playlist que aparece en una publicación de red social, si la publicación hace referencia a una playlist. Esta propiedad solo estará presente si el valor de la propiedad social.resourceId.kind es youtube#playlist.
contentDetails.social.author	string Es el autor de la publicación de red social.
contentDetails.social.referenceUrl	string Es la URL de la publicación de red social.
contentDetails.social.imageUrl	string Es una imagen del autor de la publicación.
contentDetails.channelItem	object El objeto channelItem contiene detalles sobre un recurso que se agregó a un canal. Esta propiedad solo está presente si snippet.type es channelItem.
contentDetails.channelItem.resourceId	object El objeto resourceId contiene información que identifica el recurso que se agregó al canal.