activities.list
todavía no muestra boletines de canales, y ya no se admite el método activities.insert
. Para obtener más información, consulta el Centro de ayuda de YouTube.
Un recurso activity
contiene información sobre una acción que un canal o usuario específico realizó en YouTube. Las acciones informadas en los feeds de actividad incluyen calificar un video, compartirlo, marcarlo como favorito, subir un video, etcétera. Cada recurso activity
identifica el tipo de acción, el canal asociado a 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 propio canal del usuario. Pruébala ahora.
Ya no se admite el método activities.insert
.
Representación de recursos
En la siguiente estructura JSON, se 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 Identifica el tipo de recurso de la API. El valor será youtube#activity . |
etag |
etag La 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 actividad y el ID de grupo. |
snippet.publishedAt |
datetime Fecha y hora en que ocurrió la actividad. El valor se especifica en el formato ISO 8601. |
snippet.channelId |
string ID que YouTube utiliza para identificar de forma exclusiva el canal asociado con la actividad. |
snippet.title |
string Corresponde al título del recurso asociado principalmente con la actividad. |
snippet.description |
string Descripción del recurso asociado principalmente con la actividad. |
snippet.thumbnails |
object Mapa de imágenes en miniatura asociadas con el recurso 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 información adicional sobre la viñeta. |
snippet.thumbnails.(key) |
object Los valores de clave válidos son los siguientes:
|
snippet.thumbnails.(key).url |
string La URL de la imagen. |
snippet.thumbnails.(key).width |
unsigned integer El ancho de la imagen. |
snippet.thumbnails.(key).height |
unsigned integer La altura de la imagen. |
snippet.channelTitle |
string Título del canal responsable de esta actividad |
snippet.type |
string El tipo de actividad que describe el recurso. Los valores válidos para esta propiedad son los siguientes:
|
snippet.groupId |
string Es el 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 mediante la agrupación de eventos con el mismo valor de 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 que se subió. Esta propiedad solo está presente si el snippet.type es upload . |
contentDetails.upload.videoId |
string Es el ID que YouTube usa para identificar de forma exclusiva el video que se subió. |
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 Corresponde al tipo de recurso de la API. |
contentDetails.like.resourceId.videoId |
string Es el ID que YouTube usa para identificar de forma exclusiva el video, si el recurso calificado es un video. Esta propiedad solo está presente 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 Corresponde al 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 .Nota: Por el momento, el método activities.list no muestra recursos para comentarios nuevos. |
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 Corresponde al 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 usa 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 Corresponde al 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 Corresponde al 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 única la lista de reproducción. |
contentDetails.playlistItem.playlistItemId |
string Valor que YouTube usa para identificar de forma única el elemento de 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 Corresponde al tipo de recurso de la API. |
contentDetails.recommendation.resourceId.videoId |
string Es el ID que YouTube utiliza para identificar de forma exclusiva el video, si el recurso recomendado es un video. Esta propiedad solo está presente si el resourceId.kind es youtube#video . |
contentDetails.recommendation.resourceId.channelId |
string Es el ID que YouTube utiliza para identificar de forma exclusiva el canal, si el recurso recomendado es uno. Esta propiedad solo está presente si el resourceId.kind es youtube#channel . |
contentDetails.recommendation.reason |
string El motivo por el que se recomienda el recurso al usuario. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.recommendation.seedResourceId |
object El objeto seedResourceId contiene información sobre el recurso que causó la recomendación. |
contentDetails.recommendation.seedResourceId.kind |
string Corresponde al tipo de recurso de la API. |
contentDetails.recommendation.seedResourceId.videoId |
string Es el 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 Es el ID que YouTube utiliza para identificar de forma única 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 Es el 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.social |
object El objeto social contiene detalles sobre una publicación de red social. Esta propiedad solo está presente si el snippet.type es social . |
contentDetails.social.type |
string Corresponde al nombre de la red social. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.social.resourceId |
object El objeto resourceId contiene información que identifica el recurso asociado con una publicación de red social. |
contentDetails.social.resourceId.kind |
string Corresponde al tipo de recurso de la API. |
contentDetails.social.resourceId.videoId |
string Es el ID que YouTube utiliza para identificar de forma exclusiva el video que aparece en la publicación de una red social, si esta 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 ID que YouTube utiliza para identificar de forma inequívoca el canal destacado en una 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 La URL de la publicación en la red social. |
contentDetails.social.imageUrl |
string 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 el snippet.type es channelItem . |
contentDetails.channelItem.resourceId |
object El objeto resourceId contiene información que identifica el recurso que se agregó al canal. |