Activities

O YouTube suspendeu o uso do recurso de boletim de canais. O método activities.list faz ainda não retornar boletins do canal, e os O método activities.insert é "não" suporte. Para mais detalhes, consulte a Central de Ajuda do YouTube.

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 atividade incluem classificação, compartilhamento, marcação de um vídeo como favorito, envio de um vídeo e assim por diante. Cada recurso activity identifica o tipo de ação, o canal e os recursos associados a ela, 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, você pode recuperar eventos associados a um determinado canal ou ao próprio canal do usuário. Faça um teste agora.

O método activities.insert não é mais compatível.

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 e Identifica o tipo de recurso da API. O valor será youtube#activity.
etag	etag e A Etag deste recurso.
id	string e O ID que o YouTube usa para identificar de forma exclusiva a atividade.
snippet	object e O objeto snippet contém detalhes básicos sobre a atividade, incluindo o tipo e o ID do grupo.
snippet.publishedAt	datetime e A data e a hora em que a atividade ocorreu. O valor é especificado no formato ISO 8601.
snippet.channelId	string e O ID que o YouTube usa para identificar de forma exclusiva o canal associado à atividade.
snippet.title	string e O título do recurso primariamente associado à atividade.
snippet.description	string e É a descrição do recurso primariamente associada à atividade.
snippet.thumbnails	object e 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 e Os valores-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 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. standard: uma versão da imagem em miniatura com resolução ainda mais alta do que a imagem com resolução high. Essa imagem está disponível para alguns vídeos e outros recursos que se referem a vídeos, como itens da playlist ou resultados de pesquisa. Esta imagem tem 640 px de largura e 480 px de altura. maxres – A versão de resolução mais alta 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 da playlist ou resultados de pesquisas. Esta imagem tem 1280 px de largura e 720 px de altura.
snippet.thumbnails.(key).url	string e O URL da imagem.
snippet.thumbnails.(key).width	unsigned integer e A largura da imagem.
snippet.thumbnails.(key).height	unsigned integer e A altura da imagem.
snippet.channelTitle	string e Título do canal responsável por essa atividade
snippet.type	string e 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 bulletin (descontinuado)
snippet.groupId	string e 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, é possível evitar repetições agrupando eventos com o mesmo valor de groupId.
contentDetails	object e 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 e 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 e O ID que o YouTube usa para identificar de forma exclusiva o vídeo enviado.
contentDetails.like	object e 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 e O objeto resourceId contém informações que identificam o recurso classificado.
contentDetails.like.resourceId.kind	string e O tipo do recurso da API.
contentDetails.like.resourceId.videoId	string e 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 e O objeto favorite contém informações sobre um vídeo que foi marcado como favorito. Esta propriedade só estará presente se snippet.type for favorite.
contentDetails.favorite.resourceId	object e O objeto resourceId contém informações que identificam o recurso marcado como favorito.
contentDetails.favorite.resourceId.kind	string e O tipo do recurso da API.
contentDetails.favorite.resourceId.videoId	string e O ID que o YouTube usa para identificar de forma exclusiva o vídeo favorito. Essa propriedade só estará presente se 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 e 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 e O objeto resourceId contém informações que identificam o recurso associado ao comentário.
contentDetails.comment.resourceId.kind	string e O tipo do recurso da API.
contentDetails.comment.resourceId.videoId	string e 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 e O ID que o YouTube usa para identificar de forma exclusiva o canal associado a um comentário. Esta propriedade só estará presente se resourceId.kind for youtube#channel.
contentDetails.subscription	object e 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 e O objeto resourceId contém informações que identificam o recurso ao qual o usuário se inscreveu.
contentDetails.subscription.resourceId.kind	string e O tipo do recurso da API.
contentDetails.subscription.resourceId.channelId	string e 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 e 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 e O objeto resourceId contém informações que identificam o recurso adicionado à playlist.
contentDetails.playlistItem.resourceId.kind	string e O tipo do recurso da API.
contentDetails.playlistItem.resourceId.videoId	string e O ID que o YouTube usa para identificar de forma exclusiva o vídeo que foi adicionado à playlist. Esta propriedade só estará presente se resourceId.kind for youtube#video.
contentDetails.playlistItem.playlistId	string e O valor que o YouTube usa para identificar a playlist de forma exclusiva.
contentDetails.playlistItem.playlistItemId	string e O valor que o YouTube usa para identificar de forma exclusiva o item na playlist.
contentDetails.recommendation	object e 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 e O objeto resourceId contém informações que identificam o recurso recomendado.
contentDetails.recommendation.resourceId.kind	string e O tipo do recurso da API.
contentDetails.recommendation.resourceId.videoId	string e 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 e 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 e 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 e O objeto seedResourceId contém informações sobre o recurso que causou a recomendação.
contentDetails.recommendation.seedResourceId.kind	string e O tipo do recurso da API.
contentDetails.recommendation.seedResourceId.videoId	string e 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 e 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 e 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.social	object e O objeto social contém detalhes sobre uma postagem em uma rede social. Esta propriedade só estará presente se snippet.type for social.
contentDetails.social.type	string e O nome da rede social. Os valores válidos para essa propriedade são: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object e O objeto resourceId encapsula informações que identificam o recurso associado a uma postagem em rede social.
contentDetails.social.resourceId.kind	string e O tipo do recurso da API.
contentDetails.social.resourceId.videoId	string e 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ó vai estar presente se o valor da propriedade social.resourceId.kind for youtube#video.
contentDetails.social.resourceId.channelId	string e 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ó vai estar presente se o valor da propriedade social.resourceId.kind for youtube#channel.
contentDetails.social.resourceId.playlistId	string e 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ó vai estar presente se o valor da propriedade social.resourceId.kind for youtube#playlist.
contentDetails.social.author	string e O autor da postagem na rede social.
contentDetails.social.referenceUrl	string e O URL da postagem na rede social.
contentDetails.social.imageUrl	string e Uma imagem do autor da postagem.
contentDetails.channelItem	object e O objeto channelItem contém detalhes sobre um recurso que foi adicionado a um canal. Esta propriedade só estará presente se snippet.type for channelItem.
contentDetails.channelItem.resourceId	object e O objeto resourceId contém informações que identificam o recurso adicionado ao canal.