Activities

Um recurso activity contém informações sobre uma ação que um determinado canal ou usuário realizou no YouTube. As ações relatadas nos feeds de atividades incluem classificar e compartilhar um vídeo, marcar um vídeo como favorito, comentar sobre um vídeo, fazer upload de um vídeo, e assim por diante. Cada recurso activity identifica o tipo de ação, o canal associado à ação e o(s) recurso(s) associado(s) com a ação, como o vídeo que foi avaliado ou carregado.

Métodos

A API suporta os seguintes métodos para recursos activities:

list: Retorna uma lista de eventos de atividade do canal que correspondem aos critérios da solicitação. Por exemplo, você pode recuperar eventos associados a um determinado canal, eventos associados a inscrições do usuário e amigos do Google+ ou o feed da página inicial do YouTube, que é personalizado para cada usuário. Faça um teste agora.
insert: Mensagens de um boletim para um canal específico. O usuário que envia a solicitação deve estar autorizado a agir em nome do canal.

Observação: embora um recurso de activity possa conter informações sobre ações, como classificar um vídeo de um usuário ou marcar um vídeo como favorito, você precisa usar outros métodos de API para gerar esses recursos activity. Por exemplo, você pode usar o método videos.rate() da API para classificar um vídeo e o método playlistItems.insert() para marcar um vídeo como favorito.

Faça um teste agora.

Representação de recurso

A estrutura JSON abaixo mostra o formato de um 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
      }
    },
    "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": {
      }
    },
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
`kind`	`string` O tipo do recurso da API. O valor será `youtube#activity`.
`etag`	`etag` A Etag deste recurso.
`id`	`string` O ID que o YouTube usa para identificar a atividade de forma exclusiva.
`snippet`	`object` O objeto `snippet` contém detalhes básicos sobre a atividade, incluindo o tipo da atividade e o ID do grupo.
`snippet.publishedAt`	`datetime` A data e a hora em que a atividade ocorreu. O valor é especificado no formato ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal associado à atividade.
`snippet.title`	`string` O título do recurso primariamente associado à atividade.
`snippet.description`	`string` A descrição do recurso primariamente associada à atividade.
`snippet.thumbnails`	`object` Um mapa de imagens em miniatura associadas ao recurso primariamente associado à atividade. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura.
`snippet.thumbnails.(key)`	`object` Os valores de chave válidos são: `default` – A imagem em miniatura padrão. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura. `medium` – Uma versão de resolução mais alta da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura. `high` – Uma versão de alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
`snippet.thumbnails.(key).url`	`string` O URL da imagem.
`snippet.thumbnails.(key).width`	`unsigned integer` A largura da imagem.
`snippet.thumbnails.(key).height`	`unsigned integer` A altura da imagem.
`snippet.channelTitle`	`string` O título do canal responsável por essa atividade
`snippet.type`	`string` O tipo de atividade descrita pelo recurso. Os valores válidos para esta propriedade são: `bulletin` `channelItem` `comment` `favorite` `like` `playlistItem` `recommendation` `social` `subscription` `upload`
`snippet.groupId`	`string` O ID do grupo associado à atividade. O ID do grupo identifica os eventos de usuários associados ao mesmo usuário e recurso. Por exemplo, se um usuário classificar um vídeo e o marca como favorito, as entradas para esses eventos terão o mesmo ID do grupo no feed de atividades do usuário. Em sua interface do usuário, você pode evitar a repetição agrupando eventos com o mesmo valor `groupId`.
`contentDetails`	`object` O objeto `contentDetails` contém informações sobre o conteúdo associado à atividade. Por exemplo, se o valor `snippet.type` for `videoRated`, o conteúdo do objeto `contentDetails` identificará o vídeo classificado.
`contentDetails.upload`	`object` O objeto `upload` contém informações sobre o vídeo enviado. Esta propriedade só estará presente se `snippet.type` for `upload`.
`contentDetails.upload.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo enviado.
`contentDetails.like`	`object` O objeto `like` contém informações sobre um recurso que recebeu uma classificação positiva (gostei). Esta propriedade só estará presente se `snippet.type` for `like`.
`contentDetails.like.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso classificado.
`contentDetails.like.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.like.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo se o recurso classificado for um vídeo. Esta propriedade só estará presente se `resourceId.kind` for `youtube#video`.
`contentDetails.favorite`	`object` O objeto `favorite` contém informações sobre um vídeo marcado como favorito. Esta propriedade só estará presente se `snippet.type` for `favorite`.
`contentDetails.favorite.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso marcado como favorito.
`contentDetails.favorite.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.favorite.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo favorito. Esta propriedade só estará presente se `resourceId.kind` for `youtube#video`.
`contentDetails.comment`	`object` O objeto `comment` contém informações sobre um recurso que recebeu um comentário. Esta propriedade só estará presente se `snippet.type` for `comment`.
`contentDetails.comment.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso associado ao comentário.
`contentDetails.comment.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.comment.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo associado a um comentário. Esta propriedade só estará presente se `resourceId.kind` for `youtube#video`.
`contentDetails.comment.resourceId.channelId`	`string` O ID que o YouTube usa para identificar o canal associado a um comentário. Esta propriedade só estará presente se `resourceId.kind` for `youtube#channel`.
`contentDetails.subscription`	`object` O objeto `subscription` contém informações sobre um canal ao qual um usuário se inscreveu. Esta propriedade só estará presente se `snippet.type` for `subscription`.
`contentDetails.subscription.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso ao qual o usuário se inscreveu.
`contentDetails.subscription.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.subscription.resourceId.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal ao qual o usuário se inscreveu. Esta propriedade só estará presente se `resourceId.kind` for `youtube#channel`.
`contentDetails.playlistItem`	`object` O objeto `playlistItem` contém informações sobre um novo item da playlist. Esta propriedade só estará presente se `snippet.type` for `playlistItem`.
`contentDetails.playlistItem.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso adicionado à playlist.
`contentDetails.playlistItem.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.playlistItem.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo adicionado à playlist. Esta propriedade só estará presente se `resourceId.kind` for `youtube#video`.
`contentDetails.playlistItem.playlistId`	`string` O valor que o YouTube usa para identificar de forma exclusiva a playlist.
`contentDetails.playlistItem.playlistItemId`	`string` O valor que o YouTube usa para identificar de forma exclusiva o item na playlist.
`contentDetails.recommendation`	`object` O objeto `recommendation` contém informações sobre um recurso recomendado. Esta propriedade só estará presente se `snippet.type` for `recommendation`.
`contentDetails.recommendation.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso recomendado.
`contentDetails.recommendation.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.recommendation.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo se o recurso recomendado for um vídeo. Esta propriedade só estará presente se `resourceId.kind` for `youtube#video`.
`contentDetails.recommendation.resourceId.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal se o recurso recomendado for um canal. Esta propriedade só estará presente se `resourceId.kind` for `youtube#channel`.
`contentDetails.recommendation.reason`	`string` O motivo pelo qual o recurso é recomendado ao usuário. Os valores válidos para esta propriedade são: `unspecified` `videoFavorited` `videoLiked` `videoWatched`
`contentDetails.recommendation.seedResourceId`	`object` O objeto `seedResourceId` contém informações sobre o recurso que causou a recomendação.
`contentDetails.recommendation.seedResourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.recommendation.seedResourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo se a recomendação tiver sido causada por um vídeo específico. Esta propriedade só estará presente se `seedResourceId.kind` for `youtube#video`.
`contentDetails.recommendation.seedResourceId.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal se a recomendação tiver sido causada por um canal específico. Esta propriedade só estará presente se `seedResourceId.kind` for `youtube#channel`.
`contentDetails.recommendation.seedResourceId.playlistId`	`string` O ID que o YouTube usa para identificar de forma exclusiva a playlist se a recomendação tiver sido causada por uma playlist específica. Esta propriedade só estará presente se `seedResourceId.kind` for `youtube#playlist`.
`contentDetails.bulletin`	`object` O objeto `bulletin` contém detalhes sobre uma postagem no boletim do canal. Este objeto só estará presente se `snippet.type` for `bulletin`.
`contentDetails.bulletin.resourceId`	`object` O objeto `resourceId` contém informações que identificam o recurso associado a uma postagem no boletim.
`contentDetails.bulletin.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.bulletin.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo em destaque em uma postagem no boletim se ela se referir a um vídeo. Esta propriedade só estará presente se o valor da propriedade `bulletin.resourceId.kind` for `youtube#video`.
`contentDetails.bulletin.resourceId.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal em destaque em uma postagem no boletim se ela se referir a um canal. Esta propriedade só estará presente se o valor da propriedade `bulletin.resourceId.kind` for `youtube#channel`.
`contentDetails.bulletin.resourceId.playlistId`	`string` O ID que o YouTube usa para identificar de forma exclusiva a playlist em destaque em uma postagem no boletim se ela se referir a uma playlist. Esta propriedade só estará presente se o valor da propriedade `bulletin.resourceId.kind` for `youtube#playlist`.
`contentDetails.social`	`object` O objeto `social` contém detalhes sobre a postagem na rede `social`. Esta propriedade só estará presente se `snippet.type` for `social`.
`contentDetails.social.type`	`string` O nome da rede social. Os valores válidos para esta propriedade são: `facebook` `googlePlus` `twitter` `unspecified`
`contentDetails.social.resourceId`	`object` O objeto `resourceId` encapsula informações que identificam o recurso associado a uma postagem na rede social.
`contentDetails.social.resourceId.kind`	`string` O tipo do recurso da API.
`contentDetails.social.resourceId.videoId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o vídeo em destaque em uma postagem na rede social se ela se referir a um vídeo. Esta propriedade só estará presente se o valor da propriedade `social.resourceId.kind` for `youtube#video`.
`contentDetails.social.resourceId.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal em destaque em uma postagem na rede social se ela se referir a um canal. Esta propriedade só estará presente se o valor da propriedade `social.resourceId.kind` for `youtube#channel`.
`contentDetails.social.resourceId.playlistId`	`string` O ID que o YouTube usa para identificar de forma exclusiva a playlist em destaque em uma postagem na rede social se ela se referir a uma playlist. Esta propriedade só estará presente se o valor da propriedade `social.resourceId.kind` for `youtube#playlist`.
`contentDetails.social.author`	`string` O autor da postagem na rede social.
`contentDetails.social.referenceUrl`	`string` O URL da postagem na rede social.
`contentDetails.social.imageUrl`	`string` Uma imagem do autor da postagem.
`contentDetails.channelItem`	`object` O objeto `channelItem` contém detalhes sobre um recurso adicionado a um canal. Esta propriedade só estará presente se `snippet.type` for `channelItem`.
`contentDetails.channelItem.resourceId`	`object` O objeto `resourceId` contém informação que identificam o recurso adicionado ao canal.