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.