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 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 ela e os recursos associados, como o vídeo que foi avaliado ou enviado.

Métodos

A API oferece suporte aos 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,
      }
    },
    "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 de 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 o canal associado à atividade de forma exclusiva.
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 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 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 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. 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 de pesquisa. Essa imagem tem 640 px de largura e 480 px de altura. maxres: a versão de maior resolução da imagem em 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 de pesquisa. Essa imagem tem 1280 px de largura e 720 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 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 fizer upload de um vídeo e assistir ao mesmo vídeo, as entradas desses eventos terão o mesmo ID de grupo no feed de atividades do usuário. Na interface do usuário, é possível 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 avaliado.
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 o vídeo enviado de forma exclusiva.
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 de recurso da API.
contentDetails.comment.resourceId.videoId	string O ID que o YouTube usa para identificar o vídeo associado a um comentário de forma exclusiva. 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 o canal associado a um comentário de forma exclusiva. 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 de 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 que foi adicionado à playlist.
contentDetails.playlistItem.resourceId.kind	string O tipo de recurso da API.
contentDetails.playlistItem.resourceId.videoId	string O ID que o YouTube usa para identificar o vídeo que foi adicionado à playlist de forma exclusiva. 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 de recurso da API.
contentDetails.recommendation.resourceId.videoId	string O ID que o YouTube usa para identificar o vídeo de forma exclusiva, 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 o canal de forma exclusiva, 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 de recurso da API.
contentDetails.recommendation.seedResourceId.videoId	string O ID que o YouTube usa para identificar o vídeo de forma exclusiva, se a recomendação foi 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 o canal de forma exclusiva, 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 a playlist de forma exclusiva, se a recomendação foi 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 de 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 de rede social.
contentDetails.social.resourceId.kind	string O tipo de recurso da API.
contentDetails.social.resourceId.videoId	string O ID que o YouTube usa para identificar o vídeo apresentado em uma postagem de rede social, se a postagem se referir a um vídeo. Essa 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 o canal apresentado em uma postagem de rede social, se a postagem se referir a um canal. Essa 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 a playlist apresentada em uma postagem de rede social, se a postagem se referir a uma playlist. Essa propriedade só estará presente se o valor da propriedade social.resourceId.kind for youtube#playlist.
contentDetails.social.author	string O autor da postagem de rede social.
contentDetails.social.referenceUrl	string O URL da postagem de rede social.
contentDetails.social.imageUrl	string Uma imagem do autor da postagem.
contentDetails.channelItem	object O objeto channelItem contém detalhes sobre um recurso que foi 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 que foi adicionado ao canal.