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 avaliar, compartilhar, marcar como favorito, enviar 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 é 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
    },
    "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": {
      }
    },
  }
}

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 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 da imagem em miniatura com resolução ainda maior do que a 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: 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 da pesquisa. Esta imagem tem 1.280 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)
  • favorite
  • like
  • 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 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. 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.like object
O objeto like contém informações sobre um recurso que recebeu uma classificação positiva (como um like). Essa propriedade só estará presente se o snippet.type for like.
contentDetails.like.resourceId object
O objeto resourceId contém informações que identificam o recurso avaliado.
contentDetails.like.resourceId.kind string
O tipo de recurso da API.
contentDetails.like.resourceId.videoId string
O ID que o YouTube usa para identificar o vídeo de forma exclusiva, se o recurso classificado for um vídeo. Essa propriedade só estará presente se o resourceId.kind for youtube#video.
contentDetails.favorite object
O objeto favorite contém informações sobre um vídeo marcado como favorito. Essa propriedade só estará presente se o 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 de recurso da API.
contentDetails.favorite.resourceId.videoId string
O ID que o YouTube usa para identificar o vídeo favorito de forma exclusiva. Essa propriedade só está presente se o resourceId.kind for youtube#video.

Observação:no momento, o método activities.list não retorna recursos para novos comentários.
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 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. 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 de 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 de 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 de 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 exclusivamente 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:
  • 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 de 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 de 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.