- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- HistoryType
- Storia
- MessageAdded
- MessageDeleted
- LabelAdded
- LabelRemoved
- Prova!
Visualizza la cronologia di tutte le modifiche apportate alla casella di posta specificata. I risultati della cronologia vengono restituiti in ordine cronologico (con un aumento di historyId
).
Richiesta HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
userId |
L'indirizzo email dell'utente. Il valore speciale |
Parametri di query
Parametri | |
---|---|
maxResults |
Numero massimo di record della cronologia da restituire. Il valore predefinito di questo campo è 100. Il valore massimo consentito per questo campo è 500. |
pageToken |
Token pagina per recuperare una pagina specifica di risultati nell'elenco. |
startHistoryId |
Obbligatorio. Restituisce i record della cronologia dopo il valore |
labelId |
Restituisci solo i messaggi con un'etichetta corrispondente all'ID. |
historyTypes[] |
Tipi di cronologia che la funzione deve restituire |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"history": [
{
object ( |
Campi | |
---|---|
history[] |
Elenco dei record della cronologia. In genere, per qualsiasi |
nextPageToken |
Token pagina per recuperare la pagina successiva di risultati nell'elenco. |
historyId |
L'ID del record della cronologia attuale della casella di posta. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti 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
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
HistoryType
Enum | |
---|---|
messageAdded |
|
messageDeleted |
|
labelAdded |
|
labelRemoved |
Cronologia
Un record di una modifica alla casella di posta dell'utente. Ogni modifica alla cronologia può interessare più messaggi in diversi modi.
Rappresentazione JSON |
---|
{ "id": string, "messages": [ { object ( |
Campi | |
---|---|
id |
L'ID sequenza della casella di posta. |
messages[] |
Elenco dei messaggi modificato in questo record della cronologia. I campi per tipi di modifica specifici, ad esempio |
messagesAdded[] |
Messaggi aggiunti alla casella di posta in questo record della cronologia. |
messagesDeleted[] |
Messaggi eliminati (non spostati nel cestino) dalla casella di posta in questo record della cronologia. |
labelsAdded[] |
Etichette aggiunte ai messaggi in questo record della cronologia. |
labelsRemoved[] |
Etichette rimosse dai messaggi in questo record della cronologia. |
MessageAdded
Rappresentazione JSON |
---|
{
"message": {
object ( |
Campi | |
---|---|
message |
|
MessageDeleted
Rappresentazione JSON |
---|
{
"message": {
object ( |
Campi | |
---|---|
message |
|
LabelAdded
Rappresentazione JSON |
---|
{
"message": {
object ( |
Campi | |
---|---|
message |
|
labelIds[] |
ID etichetta aggiunti al messaggio. |
LabelRemoved
Rappresentazione JSON |
---|
{
"message": {
object ( |
Campi | |
---|---|
message |
|
labelIds[] |
ID etichetta rimossi dal messaggio. |