activities.list
ainda não retorna boletins de canais, e o
método activities.insert
não é mais
compatível. 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 classificar um vídeo, compartilhar um vídeo, marcar um vídeo como favorito, enviar um vídeo e assim por diante. Cada recurso activity
identifica o tipo de ação, o canal associado à ação e os recursos associados a ela, 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 determinado canal ou ao próprio canal do usuário. Faça um teste agora.
O método activities.insert
não tem mais suporte.
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 de recurso da API. O valor será youtube#activity . |
etag |
etag A Etag desse recurso. |
id |
string O ID que o YouTube usa para identificar de forma exclusiva a atividade. |
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 primariamente associado à atividade. |
snippet.description |
string A descrição do recurso primariamente associada à atividade. |
snippet.thumbnails |
object 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 As chaves-valor válidas são:
|
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 O título do canal responsável por essa atividade |
snippet.type |
string O tipo de atividade descrito pelo recurso. Os valores válidos para essa propriedade são:
|
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 sua 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 com classificação. |
contentDetails.upload |
object O objeto upload contém informações sobre o vídeo enviado. Essa propriedade só estará presente se 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 (gostei). Essa propriedade só estará presente se snippet.type for like . |
contentDetails.like.resourceId |
object O objeto resourceId contém informações que identificam o recurso classificado. |
contentDetails.like.resourceId.kind |
string O tipo de recurso da API. |
contentDetails.like.resourceId.videoId |
string O ID que o YouTube usa para identificar de forma exclusiva o vídeo, se o recurso avaliado for um vídeo. Essa propriedade só estará presente se resourceId.kind for youtube#video . |
contentDetails.favorite |
object O objeto favorite contém informações sobre um vídeo que foi marcado como favorito. Essa propriedade só estará presente se 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 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 O objeto comment contém informações sobre um recurso que recebeu um comentário. Essa propriedade só estará presente se 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 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 resourceId.kind for youtube#channel . |
contentDetails.subscription |
object O objeto subscription contém informações sobre um canal em que um usuário se inscreveu. Essa propriedade só estará presente se snippet.type for subscription . |
contentDetails.subscription.resourceId |
object O objeto resourceId contém informações que identificam o recurso em 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 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 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 resourceId.kind for youtube#video . |
contentDetails.playlistItem.playlistId |
string O valor que o YouTube usa para identificar de forma exclusiva a playlist. |
contentDetails.playlistItem.playlistItemId |
string O valor que o YouTube usa para identificar de forma exclusiva o item na playlist. |
contentDetails.recommendation |
object O objeto recommendation contém informações sobre um recurso recomendado. Essa propriedade só estará presente se 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 de forma exclusiva o vídeo, se o recurso recomendado for um vídeo. Essa propriedade só estará presente se resourceId.kind for youtube#video . |
contentDetails.recommendation.resourceId.channelId |
string O ID que o YouTube usa para identificar de forma exclusiva o canal, caso o recurso recomendado seja um canal. Essa propriedade só estará presente se resourceId.kind for youtube#channel . |
contentDetails.recommendation.reason |
string O motivo pelo qual o recurso é recomendado ao usuário. Valores válidos para essa propriedade são:
|
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 de forma exclusiva o vídeo, se a recomendação tiver sido causada por um vídeo específico. Essa propriedade só estará presente se 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 seedResourceId.kind for youtube#channel . |
contentDetails.recommendation.seedResourceId.playlistId |
string 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. Essa propriedade só estará presente se 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 snippet.type for social . |
contentDetails.social.type |
string O nome da rede social. Os valores válidos para essa propriedade são:
|
contentDetails.social.resourceId |
object O objeto resourceId encapsula informações que identificam o recurso associado a uma postagem na 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 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 O ID que o YouTube usa para identificar de forma exclusiva o canal em destaque em uma postagem de 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 O ID que o YouTube usa para identificar de forma exclusiva a playlist em destaque em uma postagem de 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 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 snippet.type for channelItem . |
contentDetails.channelItem.resourceId |
object O objeto resourceId contém informações que identificam o recurso adicionado ao canal. |