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 que se informan 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 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 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 usa para identificar de manera inequívoca 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 Fecha y hora en que se produjo 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 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 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 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 Indica 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 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 de 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 ID que YouTube utiliza para identificar de forma inequívoca 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 Es el tipo de recurso de la API. |
contentDetails.like.resourceId.videoId |
string El ID que YouTube utiliza para identificar de forma inequívoca 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 Es el 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 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 Es el 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 Es el 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 Es el tipo de recurso de la API. |
contentDetails.subscription.resourceId.channelId |
string ID que YouTube utiliza para identificar de forma inequívoca 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 playlist. 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 playlist. |
contentDetails.playlistItem.resourceId.kind |
string Es el 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 playlist. Esta propiedad solo está presente si el resourceId.kind es youtube#video . |
contentDetails.playlistItem.playlistId |
string Valor que YouTube utiliza para identificar de manera inequívoca la playlist. |
contentDetails.playlistItem.playlistItemId |
string Valor que YouTube usa para identificar de forma única el elemento en la playlist. |
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 Es el tipo de recurso de la API. |
contentDetails.recommendation.resourceId.videoId |
string Es el ID que YouTube utiliza para identificar de manera inequívoca 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 Corresponde al ID que YouTube utiliza para identificar de forma inequívoca 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 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 Es el tipo de recurso de la API. |
contentDetails.recommendation.seedResourceId.videoId |
string Es el ID que YouTube utiliza para identificar de forma inequívoca 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 inequívoca 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 inequívoca la playlist, si la recomendación se debió a una playlist 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 en una red social. Esta propiedad solo está presente si el snippet.type es social . |
contentDetails.social.type |
string El 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 en una red social. |
contentDetails.social.resourceId.kind |
string Es el tipo de recurso de la API. |
contentDetails.social.resourceId.videoId |
string ID que YouTube utiliza para identificar de forma inequívoca el video que aparece en una publicación en una red social, si 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 Es el ID que YouTube utiliza para identificar de forma inequívoca el canal que aparece 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 Es el ID que YouTube utiliza para identificar de forma exclusiva la playlist que aparece en una 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 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 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. |