Activities

YouTube dio de baja la función de boletín de canal. El método activities.list hace lo siguiente: aún no devolverá los boletines de canales, y el El método activities.insert es "no" que ya no sean compatibles. Para obtener más información, consulta la Centro de ayuda de YouTube.

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 calificar un video, compartir un video, marcar un video como favorito, subir un video, etc. Cada recurso activity identifica el tipo de acción, el canal asociado a ella y los recursos asociados a ella, 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 propio del usuario. Pruébala ahora.

Ya no se admite el método activities.insert.

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
    },
    "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": {
      }
    },
  }
}

Propiedades

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

Propiedades
kind string de
Identifica el tipo de recurso de la API. El valor será youtube#activity.
etag etag de
Etag de este recurso.
id string de
ID que YouTube utiliza para identificar de forma exclusiva la actividad.
snippet object de
El objeto snippet contiene detalles básicos sobre la actividad, como su tipo y el ID de grupo.
snippet.publishedAt datetime de
Fecha y hora en que se produjo la actividad. El valor se especifica en el formato ISO 8601.
snippet.channelId string de
ID que YouTube utiliza para identificar de forma exclusiva el canal asociado con la actividad.
snippet.title string de
Título del recurso asociado principalmente con la actividad.
snippet.description string de
Descripción del recurso asociado principalmente con la actividad.
snippet.thumbnails object de
Mapa de imágenes en miniatura asociadas con el recurso que está principalmente asociado 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 de
Los pares clave-valor válidos son los siguientes:
  • default: es 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: 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 con resolución high. Esta imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de playlists 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 relacionados con videos, como los elementos de las playlists o los resultados de la búsqueda. Esta imagen es de 1280 píxeles de ancho y 720 píxeles de alto.
snippet.thumbnails.(key).url string de
URL de la imagen.
snippet.thumbnails.(key).width unsigned integer de
El ancho de la imagen.
snippet.thumbnails.(key).height unsigned integer de
La altura de la imagen.
snippet.channelTitle string de
Título del canal responsable de esta actividad
snippet.type string de
El tipo de actividad que describe el recurso.

Los valores válidos para esta propiedad son los siguientes:
  • channelItem
  • comment – (no se muestra actualmente)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
  • bulletin (obsoleto)
snippet.groupId string de
ID del 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 de groupId.
contentDetails object de
El objeto contentDetails incluye información sobre el contenido asociado con la actividad. Por ejemplo, si el valor de snippet.type es videoRated, el contenido del objeto contentDetails identifica el video calificado.
contentDetails.upload object de
El objeto upload contiene información sobre el video que se subió. Esta propiedad solo está presente si snippet.type es upload.
contentDetails.upload.videoId string de
ID que YouTube utiliza para identificar de forma exclusiva el video que se subió.
contentDetails.like object de
El objeto like contiene información sobre un recurso que recibió una calificación positiva (Me gusta). Esta propiedad solo está presente si snippet.type es like.
contentDetails.like.resourceId object de
El objeto resourceId contiene información que identifica el recurso calificado.
contentDetails.like.resourceId.kind string de
Tipo de recurso de API.
contentDetails.like.resourceId.videoId string de
ID que YouTube utiliza para identificar de forma exclusiva el video, si el recurso calificado es un video. Esta propiedad solo está presente si resourceId.kind es youtube#video.
contentDetails.favorite object de
El objeto favorite contiene información sobre un video que se marcó como favorito. Esta propiedad solo está presente si snippet.type es favorite.
contentDetails.favorite.resourceId object de
El objeto resourceId contiene información que identifica el recurso que se marcó como favorito.
contentDetails.favorite.resourceId.kind string de
Tipo de recurso de API.
contentDetails.favorite.resourceId.videoId string de
ID que YouTube utiliza para identificar de forma exclusiva el video favorito. Esta propiedad solo está presente si resourceId.kind es youtube#video.

Nota: Por el momento, el método activities.list no muestra recursos para comentarios nuevos.
contentDetails.comment object de
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 de
El objeto resourceId contiene información que identifica el recurso asociado con el comentario.
contentDetails.comment.resourceId.kind string de
Tipo de recurso de API.
contentDetails.comment.resourceId.videoId string de
ID que YouTube utiliza 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 de
ID que YouTube utiliza para identificar de forma exclusiva el canal asociado con un comentario. Esta propiedad solo está presente si resourceId.kind es youtube#channel.
contentDetails.subscription object de
El objeto subscription contiene información sobre un canal al que se suscribió un usuario. Esta propiedad solo está presente si snippet.type es subscription.
contentDetails.subscription.resourceId object de
El objeto resourceId contiene información que identifica el recurso al que se suscribió el usuario.
contentDetails.subscription.resourceId.kind string de
Tipo de recurso de API.
contentDetails.subscription.resourceId.channelId string de
ID que YouTube utiliza para identificar de forma exclusiva el canal al que se suscribió el usuario. Esta propiedad solo está presente si resourceId.kind es youtube#channel.
contentDetails.playlistItem object de
El objeto playlistItem contiene información sobre un nuevo elemento de la playlist. Esta propiedad solo está presente si snippet.type es playlistItem.
contentDetails.playlistItem.resourceId object de
El objeto resourceId contiene información que identifica el recurso que se agregó a la playlist.
contentDetails.playlistItem.resourceId.kind string de
Tipo de recurso de API.
contentDetails.playlistItem.resourceId.videoId string de
ID que YouTube utiliza 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 de
Valor que YouTube utiliza para identificar de forma exclusiva la playlist.
contentDetails.playlistItem.playlistItemId string de
Valor que YouTube utiliza para identificar de forma exclusiva el elemento en la playlist.
contentDetails.recommendation object de
El objeto recommendation contiene información sobre un recurso recomendado. Esta propiedad solo está presente si snippet.type es recommendation.
contentDetails.recommendation.resourceId object de
El objeto resourceId contiene información que identifica el recurso recomendado.
contentDetails.recommendation.resourceId.kind string de
Tipo de recurso de API.
contentDetails.recommendation.resourceId.videoId string de
ID que YouTube utiliza 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 de
ID que YouTube utiliza 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 de
Es el motivo por el que se recomienda el recurso al usuario.

Los valores válidos para esta propiedad son los siguientes:
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation.seedResourceId object de
El objeto seedResourceId contiene información sobre el recurso que causó la recomendación.
contentDetails.recommendation.seedResourceId.kind string de
Tipo de recurso de API.
contentDetails.recommendation.seedResourceId.videoId string de
ID que YouTube utiliza para identificar de forma exclusiva el video, si la recomendación se debió a un video específico. Esta propiedad solo está presente si seedResourceId.kind es youtube#video.
contentDetails.recommendation.seedResourceId.channelId string de
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 seedResourceId.kind es youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId string de
ID que YouTube utiliza para identificar de forma exclusiva la playlist, si la recomendación se debió a una playlist en particular. Esta propiedad solo está presente si seedResourceId.kind es youtube#playlist.
contentDetails.social object de
El objeto social contiene detalles sobre una publicación de una red social. Esta propiedad solo está presente si snippet.type es social.
contentDetails.social.type string de
El nombre de la red social.

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