Activities

Un recurso activity contiene información sobre una acción que un canal o usuario determinados han realizado en YouTube. Las acciones informadas en los feeds de actividad incluyen calificar un video, compartir un video, marcar un video como favorito, comentar un video, subir un video, etc. Cada recurso activity identifica el tipo de acción, el canal asociado a la acción y los recursos asociados a la acción, como el video que se calificó o subió.

Métodos

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

list
Muestra una lista de eventos de actividad del canal que cumplen con los criterios de la solicitud. Por ejemplo, puedes recuperar los eventos asociados a un canal en particular, los eventos relacionados con las suscripciones y los amigos de Google+ del usuario, o el feed de la página principal de YouTube, que personalizó para cada usuario. Pruébalo ahora.
insert
Publica un boletín para un canal específico. (El usuario que envía la solicitud debe estar autorizado para actuar en nombre del canal).

Nota: Si bien un recurso activity puede contener información sobre las acciones de un usuario, como calificar un video o marcar un video como favorito, es necesario utilizar otros métodos de la API para generar esos recursos activity. Por ejemplo, deberías utilizar el método videos.rate() de la API para calificar un video y el método playlistItems.insert() para marcar un video como favorito.

Pruébalo ahora.

Representación de recursos

La estructura JSON a continuación muestra el formato de un recurso de 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
      }
    },
    "bulletin": {
      "resourceId": {
        "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
Tipo de recurso de la API. El valor será youtube#activity.
etag etag
Etag de este recurso.
id string
ID que YouTube utiliza para identificar de forma exclusiva la actividad.
snippet object
El objeto snippet contiene información básica sobre la actividad, incluido el tipo de la actividad y el ID de grupo.
snippet.publishedAt datetime
Fecha y hora en que se produjo la actividad. El valor se especifica en el formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal asociado con la actividad.
snippet.title string
Título del recurso asociado principalmente con la actividad.
snippet.description string
Descripción de los recursos asociados principalmente con la actividad.
snippet.thumbnails object
Mapa de imágenes en miniatura asociadas con el recurso que se asocia 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:
  • default: La imagen en miniatura predeterminada. La viñeta predeterminada de un video, o de un recurso que se refiere a un video, como un elemento de una lista de reproducción o el resultado de una búsqueda, es de 120 píxeles de ancho y 90 píxeles de alto. La viñeta predeterminada para un canal es de 88 píxeles de ancho y 88 píxeles de alto.
  • medium: 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: 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.
snippet.thumbnails.(key).url string
URL de la imagen.
snippet.thumbnails.(key).width unsigned integer
Ancho de la imagen.
snippet.thumbnails.(key).height unsigned integer
Altura de la imagen.
snippet.channelTitle string
Título de canal para el canal responsable de esta actividad.
snippet.type string
Tipo de actividad que describe el recurso.

Los valores válidos para esta propiedad son:
  • bulletin
  • channelItem
  • comment
  • favorite
  • like
  • playlistItem
  • recommendation
  • social
  • subscription
  • upload
snippet.groupId string
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 clasifica un video y lo marca como favorito, las entradas para estos eventos tendrían el mismo ID de grupo en el feed de actividad del usuario. En tu interfaz de usuario, puedes evitar la repetición al agrupar los 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, entonces el contenido del objeto contentDetails identifica el video calificado.
contentDetails.upload object
El objeto upload contiene información sobre el video que se subió. Esta propiedad solo está presente si el snippet.type es upload.
contentDetails.upload.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video.
contentDetails.like object
El objeto like contiene información sobre un recurso que recibió una calificación positiva (Me gusta). Esta propiedad solo está presente si el snippet.type es like.
contentDetails.like.resourceId object
El objeto resourceId contiene información que identifica el recurso calificado.
contentDetails.like.resourceId.kind string
Tipo de recurso de la API.
contentDetails.like.resourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video, si el recurso calificado es un video. Esta propiedad solo está si el resourceId.kind es youtube#video.
contentDetails.favorite object
El objeto favorite contiene información sobre un video que se marcó como favorito. Esta propiedad solo está presente si el snippet.type es favorite.
contentDetails.favorite.resourceId object
El objeto resourceId contiene información que identifica el recurso que se marcó como favorito.
contentDetails.favorite.resourceId.kind string
Tipo de recurso de la API.
contentDetails.favorite.resourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video favorito. Esta propiedad solo está presente si el resourceId.kind es youtube#video.
contentDetails.comment object
El objeto comment contiene información sobre un recurso que recibió un comentario. Esta propiedad solo está presente si el 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
Tipo de recurso de la API.
contentDetails.comment.resourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video asociado con un comentario. Esta propiedad solo está presente si el resourceId.kind es youtube#video.
contentDetails.comment.resourceId.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal asociado con un comentario. Esta propiedad solo está presente si el resourceId.kind es youtube#channel.
contentDetails.subscription object
El objeto subscription contiene información sobre un canal al que se suscribió un usuario. Esta propiedad solo está presente si el snippet.type es subscription.
contentDetails.subscription.resourceId object
El objeto resourceId contiene información que identifica el recurso al que se suscribió el usuario.
contentDetails.subscription.resourceId.kind string
Tipo de recurso de la API.
contentDetails.subscription.resourceId.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal al que se suscribió el usuario. Esta propiedad solo está presente si el resourceId.kind es youtube#channel.
contentDetails.playlistItem object
El objeto playlistItem contiene información sobre un nuevo elemento de la lista de reproducción. Esta propiedad solo está presente si el snippet.type es playlistItem.
contentDetails.playlistItem.resourceId object
El objeto resourceId contiene información que identifica el recurso que se agregó a la lista de reproducción.
contentDetails.playlistItem.resourceId.kind string
Tipo de recurso de la API.
contentDetails.playlistItem.resourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video que se agregó a la lista de reproducción. Esta propiedad solo está presente si el resourceId.kind es youtube#video.
contentDetails.playlistItem.playlistId string
Valor que YouTube utiliza para identificar de forma exclusiva la lista de reproducción.
contentDetails.playlistItem.playlistItemId string
Valor que YouTube utiliza para identificar el elemento en la lista de reproducción.
contentDetails.recommendation object
El objeto recommendation contiene información sobre un recurso recomendado. Esta propiedad solo está presente si el snippet.type es recommendation.
contentDetails.recommendation.resourceId object
El objeto resourceId contiene información que identifica el recurso recomendado.
contentDetails.recommendation.resourceId.kind string
Tipo de recurso de la API.
contentDetails.recommendation.resourceId.videoId string
ID de que YouTube utiliza para identificar de forma exclusiva el video, si el recurso recomendado es de un video. Esta propiedad solo está presente si el resourceId.kind es youtube#video.
contentDetails.recommendation.resourceId.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal, si el recurso recomendado es un canal. Esta propiedad solo está presente si el resourceId.kind es youtube#channel.
contentDetails.recommendation.reason string
Razón por la que se recomienda el recurso al usuario.

Los valores válidos para esta propiedad son:
  • unspecified
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object
El objeto seedResourceId contiene información sobre el recurso que causó la recomendación.
contentDetails.recommendation.seedResourceId.kind string
Tipo de recurso de la API.
contentDetails.recommendation.seedResourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video, si la recomendación se debió a un video en particular. Esta propiedad solo está presente si el seedResourceId.kind es youtube#video.
contentDetails.recommendation.seedResourceId.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal, si la recomendación se debió a un canal en particular. Esta propiedad solo está presente si el seedResourceId.kind es youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId string
ID que YouTube utiliza para identificar de forma exclusiva la lista de reproducción, si la recomendación se debió a una lista de reproducción en particular. Esta propiedad solo está presente si el seedResourceId.kind es youtube#playlist.
contentDetails.bulletin object
El objeto bulletin contiene información acerca de la publicación de un boletín de canal. Este objeto solo está presente si la snippet.type es bulletin.
contentDetails.bulletin.resourceId object
El objeto resourceId contiene información que identifica el recurso asociado con la publicación de un boletín.
contentDetails.bulletin.resourceId.kind string
Tipo de recurso de la API.
contentDetails.bulletin.resourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video destacado en la publicación de un boletín, si la publicación se refiere a un video. Esta propiedad solo estará presente si el valor de la propiedad bulletin.resourceId.kind es youtube#video.
contentDetails.bulletin.resourceId.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal destacado en la publicación de un boletín, si la publicación se refiere a un canal. Esta propiedad solo estará presente si el valor de la propiedad bulletin.resourceId.kind es youtube#channel.
contentDetails.bulletin.resourceId.playlistId string
ID que YouTube utiliza para identificar de forma exclusiva la lista de reproducción destacada en la publicación de un boletín, si la publicación se refiere a una lista de reproducción. Esta propiedad solo estará presente si el valor de la propiedad bulletin.resourceId.kind es youtube#playlist.
contentDetails.social object
El objeto social contiene detalles acerca de una publicación en una red social. Esta propiedad solo está presente si el snippet.type es social.
contentDetails.social.type string
Nombre de la red social.

Los valores válidos para esta propiedad son:
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social.resourceId object
El objeto resourceId contiene información que identifica el recurso asociado con una publicación de una red social.
contentDetails.social.resourceId.kind string
Tipo de recurso de la API.
contentDetails.social.resourceId.videoId string
ID que YouTube utiliza para identificar de forma exclusiva el video destacado en la publicación de una red social, si la publicación se refiere 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
ID que YouTube utiliza para identificar de forma exclusiva el canal destacado en la publicación de una red social, si la publicación se refiere 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
ID que YouTube utiliza para identificar de forma exclusiva la lista de reproducción destacada en la publicación de una red social, si la publicación se refiere a una lista de reproducción. Esta propiedad solo estará presente si el valor de la propiedad social.resourceId.kind es youtube#playlist.
contentDetails.social.author string
Autor de la publicación en la red social.
contentDetails.social.referenceUrl string
URL de la publicación en la red social.
contentDetails.social.imageUrl string
Imagen del autor de la publicación.
contentDetails.channelItem object
El objeto channelItem contiene información acerca de un recurso que se agregó a un canal. Esta propiedad solo está presente si el snippet.type es channelItem.
contentDetails.channelItem.resourceId object
El objeto resourceId contiene información que identifica el recurso que se agregó al canal.