Activities

Um recurso activity contém informações sobre uma ação que um canal ou usuário específico realizou no YouTube. As ações informadas nos feeds de atividades incluem compartilhar e enviar vídeos, entre outras. Cada recurso activity identifica o tipo de ação, o canal associado a ela e os recursos associados, como o vídeo que foi avaliado ou enviado.

Métodos

A API é compatível com 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, é possível recuperar eventos associados a um canal específico ou ao canal do usuário. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir 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
    },
    "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": {
      }
    },
  }
}

Propriedades

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

Propriedades
kind	string Identifica 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 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.
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 associado principalmente à atividade.
snippet.description	string A descrição do recurso associado principalmente à atividade.
snippet.thumbnails	object Um mapa de imagens em miniatura associadas ao recurso que está principalmente 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 de 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 maior resolução 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 em alta resolução da imagem da 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. standard: uma versão de resolução ainda maior da imagem em miniatura do que a imagem de resolução high. Essa imagem está disponível para alguns vídeos e outros recursos que se referem a vídeos, como itens de playlist ou resultados da pesquisa. Esta imagem tem 640 px de largura e 480 px de altura. maxres: uma versão em alta resolução da imagem da miniatura. Esse tamanho de imagem está disponível para alguns vídeos e outros recursos que se referem a vídeos, como itens de playlist ou resultados da pesquisa. Esta imagem tem 1.280 px de largura e 720 px de altura. fhd: a versão em alta definição total (1080p) da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos. Esta imagem tem 1920 px de largura e 1080 px de altura. qhd: a versão quad HD (1440p / 2K) da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos. Esta imagem tem 2.560 px de largura e 1.440 px de altura. uhd: a versão em resolução ultra HD (4K) da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos. Esta imagem tem 3840 px de largura e 2160 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 Título do canal responsável por essa atividade
snippet.type	string O tipo de atividade que o recurso descreve. Os valores válidos para essa propriedade são: channelItem comment: (não retornado no momento) playlistItem promotedItem 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 enviar e assistir o mesmo vídeo, as entradas desses eventos terão o mesmo ID de grupo no feed de atividades dele. Na interface do usuário, você pode evitar a repetição agrupando eventos com o mesmo valor de groupId.
contentDetails	object O objeto contentDetails contém informações sobre o conteúdo associado à atividade. Por exemplo, se o valor de snippet.type for videoRated, o conteúdo do objeto contentDetails vai identificar o vídeo classificado.
contentDetails.upload	object O objeto upload contém informações sobre o vídeo enviado. Essa propriedade só estará presente se o snippet.type for upload.
contentDetails.upload.videoId	string O ID que o YouTube usa para identificar de forma exclusiva o vídeo enviado.
contentDetails.comment	object O objeto comment contém informações sobre um recurso que recebeu um comentário. Essa propriedade só estará presente se o 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. Essa propriedade só estará presente se o resourceId.kind for youtube#video.
contentDetails.comment.resourceId.channelId	string O ID que o YouTube usa para identificar de forma exclusiva o canal associado a um comentário. Essa propriedade só estará presente se o resourceId.kind for youtube#channel.
contentDetails.subscription	object O objeto subscription contém informações sobre um canal a que um usuário se inscreveu. Somente assinaturas públicas são retornadas. Essa propriedade só estará presente se o snippet.type for subscription.
contentDetails.subscription.resourceId	object O objeto resourceId contém informações que identificam o recurso a que 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 em que o usuário se inscreveu. Essa propriedade só estará presente se o resourceId.kind for youtube#channel.
contentDetails.playlistItem	object O objeto playlistItem contém informações sobre um novo item da playlist. Essa propriedade só estará presente se o 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. Essa propriedade só estará presente se o resourceId.kind for youtube#video.
contentDetails.playlistItem.playlistId	string O valor que o YouTube usa para identificar a playlist de forma exclusiva.
contentDetails.playlistItem.playlistItemId	string O valor que o YouTube usa para identificar o item na playlist de forma exclusiva.
contentDetails.recommendation	object O objeto recommendation contém informações sobre um recurso recomendado. Essa propriedade só estará presente se o 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 exclusivamente o vídeo, se o recurso recomendado for um vídeo. Essa propriedade só estará presente se o 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. Essa propriedade só estará presente se o resourceId.kind for youtube#channel.
contentDetails.recommendation.reason	string O motivo pelo qual o recurso é recomendado ao usuário. Os valores válidos para essa propriedade são: 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 o vídeo de forma exclusiva, caso a recomendação tenha sido causada por um vídeo específico. Essa propriedade só estará presente se o 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 foi causada por um canal específico. Essa propriedade só estará presente se o seedResourceId.kind for youtube#channel.
contentDetails.recommendation.seedResourceId.playlistId	string O ID que o YouTube usa para identificar de forma exclusiva a playlist, caso a recomendação tenha sido causada por uma playlist específica. Essa propriedade só estará presente se o seedResourceId.kind for youtube#playlist.
contentDetails.social	object O objeto social contém detalhes sobre uma postagem em rede social. Essa propriedade só estará presente se o snippet.type for social.
contentDetails.social.type	string O nome da rede social. Os valores válidos para essa 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 em 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 uma postagem de rede social, se a postagem se referir a um vídeo. Essa propriedade só vai 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 uma postagem de rede social, se a postagem se referir a um canal. Essa propriedade só vai 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 uma postagem de rede social, se a postagem se referir a uma playlist. Essa propriedade só vai 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. Essa propriedade só estará presente se o snippet.type for channelItem.
contentDetails.channelItem.resourceId	object O objeto resourceId contém informações que identificam o recurso adicionado ao canal.