Method: users.history.list

Lista o histórico de todas as mudanças feitas na caixa de correio especificada. Os resultados do histórico são retornados em ordem cronológica (aumento de historyId).

Solicitação HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
userId

string

O endereço de e-mail do usuário. O valor especial me pode ser usado para indicar o usuário autenticado.

Parâmetros de consulta

Parâmetros
maxResults

integer (uint32 format)

Número máximo de registros de histórico a serem retornados. O padrão desse campo é 100. O valor máximo permitido para esse campo é 500.
pageToken

string

Token de página para recuperar uma página específica de resultados na lista.
startHistoryId

string

Obrigatório. Retorna registros de histórico após o startHistoryId especificado. O startHistoryId fornecido precisa ser obtido do historyId de uma mensagem, conversa ou resposta list anterior. Os IDs de histórico aumentam em ordem cronológica, mas não são contíguos, com lacunas aleatórias entre IDs válidos. Fornecer um startHistoryId inválido ou desatualizado geralmente retorna um código de erro HTTP 404. Um historyId geralmente é válido por pelo menos uma semana, mas, em algumas circunstâncias raras, pode ser válido por apenas algumas horas. Se você receber uma resposta de erro HTTP 404, o aplicativo vai precisar fazer uma sincronização completa. Se você não receber um nextPageToken na resposta, não há atualizações para recuperar, e você pode armazenar o historyId retornado para uma solicitação futura.
labelId

string

Retorna apenas mensagens com um rótulo que corresponda ao ID.
historyTypes[]

enum (HistoryType)

Tipos de histórico a serem retornados pela função

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON 
{
  "history": [
    {
      object (History)
    }
  ],
  "nextPageToken": string,
  "historyId": string
}
Campos
history[]

object (History)

Lista de registros do histórico. Qualquer messages contido na resposta geralmente tem apenas os campos id e threadId preenchidos.
nextPageToken

string

Token da página para recuperar a próxima página de resultados na lista.
historyId

string

O ID do registro de histórico atual da caixa de correio.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Para mais informações, consulte OAuth 2.0 Overview.

HistoryType

Tipos enumerados
messageAdded
messageDeleted
labelAdded
labelRemoved

Histórico

Um registro de uma mudança na caixa de e-mails do usuário. Cada mudança no histórico pode afetar várias mensagens de várias maneiras.

Representação JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "messagesAdded": [
    {
      object (MessageAdded)
    }
  ],
  "messagesDeleted": [
    {
      object (MessageDeleted)
    }
  ],
  "labelsAdded": [
    {
      object (LabelAdded)
    }
  ],
  "labelsRemoved": [
    {
      object (LabelRemoved)
    }
  ]
}
Campos
id

string

O ID da sequência da caixa de e-mails.
messages[]

object (Message)

Lista de mensagens alteradas neste registro do histórico. Os campos para tipos de mudança específicos, como messagesAdded, podem duplicar mensagens neste campo. Recomendamos usar os campos específicos de tipo de mudança em vez disso.
messagesAdded[]

object (MessageAdded)

Mensagens adicionadas à caixa de correio neste registro de histórico.
messagesDeleted[]

object (MessageDeleted)

Mensagens excluídas (não movidas para a lixeira) da caixa de correio neste registro de histórico.
labelsAdded[]

object (LabelAdded)

Marcadores adicionados às mensagens neste registro de histórico.
labelsRemoved[]

object (LabelRemoved)

Marcadores removidos das mensagens neste registro do histórico.

MessageAdded

Representação JSON 
{
  "message": {
    object (Message)
  }
}
Campos
message

object (Message)

MessageDeleted

Representação JSON 
{
  "message": {
    object (Message)
  }
}
Campos
message

object (Message)

LabelAdded

Representação JSON 
{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}
Campos
message

object (Message)
labelIds[]

string

IDs de rótulo adicionados à mensagem.

LabelRemoved

Representação JSON 
{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}
Campos
message

object (Message)
labelIds[]

string

IDs de marcador removidos da mensagem.