Activities: list

O YouTube suspendeu o uso desse recurso. O método 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.

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.

Impacto da cota: uma chamada para esse método tem um custo de cota de 1 unidade.

Casos de uso comuns

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/youtube/v3/activities

Parâmetros

A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.

Parâmetros
Parâmetros obrigatórios
part string
O parâmetro part especifica uma lista separada por vírgulas de uma ou mais propriedades de recurso activity que serão incluídas pela resposta da API.

Se o parâmetro identificar uma propriedade que contém propriedades filhas, elas serão incluídas na resposta. Por exemplo, em um recurso activity, a propriedade snippet contém outras propriedades que identificam o tipo de atividade, um título de exibição para a atividade e assim por diante. Se você definir part=snippet, a resposta da API também vai conter todas essas propriedades aninhadas.

A lista a seguir contém os nomes de part que podem ser incluídos no valor do parâmetro:
  • contentDetails
  • id
  • snippet
Filtros (especifique exatamente um dos parâmetros a seguir)
channelId string
O parâmetro channelId especifica um ID exclusivo do canal do YouTube. A API retornará uma lista das atividades desse canal.
home boolean
Observação:o uso desse parâmetro foi descontinuado.
Para solicitações que definem esse parâmetro, a resposta da API contém itens semelhantes aos que um usuário não conectado pode ver na página inicial do YouTube. Esse parâmetro só pode ser usado em uma solicitação autorizada corretamente.
mine boolean
Esse parâmetro só pode ser usado em uma solicitação autorizada corretamente. Defina o valor desse parâmetro como true para recuperar um feed de atividades do usuário autenticado.
Parâmetros opcionais
maxResults unsigned integer
O parâmetro maxResults especifica o número máximo de itens que precisam ser retornados no conjunto de resultados. Os valores aceitáveis são de 0 a 50, inclusive. O valor padrão é 5.
pageToken string
O parâmetro pageToken identifica uma página específica no conjunto de resultados que será retornado. Em uma resposta da API, as propriedades nextPageToken e prevPageToken identificam outras páginas que podem ser recuperadas.
publishedAfter datetime
O parâmetro publishedAfter especifica a data e a hora mais antigas em que uma atividade poderia ter ocorrido para ela ser incluída na resposta da API. Se o valor do parâmetro especifica um dia, mas não um horário, todas as atividades ocorridas nesse dia serão incluídas no conjunto de resultados. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
publishedBefore datetime
O parâmetro publishedBefore especifica a data e a hora antes das quais uma atividade precisa ter ocorrido para ela ser incluída na resposta da API. Se o valor do parâmetro especifica um dia, mas não um horário, todas as atividades ocorridas nesse dia serão excluídas do conjunto de resultados. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
regionCode string
O parâmetro regionCode instrui a API a retornar resultados para o país especificado. O valor do parâmetro é um código de país ISO 3166-1 alfa-2. O YouTube usa esse valor quando a atividade anterior do usuário autorizado no YouTube não fornece informações suficientes para gerar o feed de atividade.

Corpo da solicitação

Não forneça um corpo de solicitação ao chamar este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "youtube#activityListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    activity Resource
  ]
}

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#activityListResponse.
etag etag
A Etag desse recurso.
nextPageToken string
O token que pode ser usado como o valor do parâmetro pageToken para recuperar a próxima página do conjunto de resultados.
prevPageToken string
O token que pode ser usado como o valor do parâmetro pageToken para recuperar a página anterior do conjunto de resultados.
pageInfo object
O objeto pageInfo encapsula informações de paginação para o conjunto de resultados.
pageInfo.totalResults integer
O número total de resultados no conjunto de resultados.
pageInfo.resultsPerPage integer
O número de resultados incluídos na resposta da API.
items[] list
Uma lista de atividades ou eventos que correspondem aos critérios da solicitação.

Erros

A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden A solicitação não está devidamente autorizada.
forbidden (403) homeParameterDeprecated Os dados de atividade do usuário na página inicial não estão disponíveis por meio dessa API. Esse erro pode ocorrer se você definir o parâmetro home como true em uma solicitação não autorizada.
notFound (404) channelNotFound O ID do canal identificado pelo parâmetro channelId da solicitação não foi encontrado.
notFound (404) homeChannelNotFound O feed da página inicial do YouTube não pode ser encontrado para o usuário autenticado no momento.
unauthorized (401) authorizationRequired A solicitação usa o parâmetro home, mas não está devidamente autorizada.

Confira!

Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.