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: