Gmail API

L'API Gmail ti consente di visualizzare e gestire i dati della casella di posta di Gmail, come thread, messaggi ed etichette.

Servizio: gmail.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, utilizza le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile da computer per descrivere e utilizzare le API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI riportati di seguito sono relativi a questo endpoint di servizio:

  • https://gmail.googleapis.com

Risorsa REST: v1.users

Metodi
getProfile GET /gmail/v1/users/{userId}/profile
Recupera il profilo Gmail dell'utente corrente.
stop POST /gmail/v1/users/{userId}/stop
Interrompi la ricezione di notifiche push per la casella di posta dell'utente specificata.
watch POST /gmail/v1/users/{userId}/watch
Configura o aggiorna un orologio con notifiche push nella casella di posta dell'utente specificato.

Risorsa REST: v1.users.drafts

Metodi
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
Crea una nuova bozza con l'etichetta DRAFT.
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
Elimina immediatamente e definitivamente la bozza specificata.
get GET /gmail/v1/users/{userId}/drafts/{id}
Recupera la bozza specificata.
list GET /gmail/v1/users/{userId}/drafts
Elenca le bozze nella posta in arrivo dell'utente.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
Invia la bozza esistente specificata ai destinatari nelle intestazioni To, Cc e Bcc.
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
Sostituisce i contenuti di una bozza.

Risorsa REST: v1.users.history

Metodi
list GET /gmail/v1/users/{userId}/history
Elenca la cronologia di tutte le modifiche alla cassetta postale specificata.

Risorsa REST: v1.users.labels

Metodi
create POST /gmail/v1/users/{userId}/labels
Crea una nuova etichetta.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Elimina immediatamente e definitivamente l'etichetta specificata e la rimuove da tutti i messaggi e i thread a cui è applicata.
get GET /gmail/v1/users/{userId}/labels/{id}
Recupera l'etichetta specificata.
list GET /gmail/v1/users/{userId}/labels
Elenca tutte le etichette nella casella di posta dell'utente.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Esegui il patch dell'etichetta specificata.
update PUT /gmail/v1/users/{userId}/labels/{id}
Aggiorna l'etichetta specificata.

Risorsa REST: v1.users.messages

Metodi
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
Elimina molti messaggi in base all'ID messaggio.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Modifica le etichette dei messaggi specificati.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
Elimina immediatamente e definitivamente il messaggio specificato.
get GET /gmail/v1/users/{userId}/messages/{id}
Recupera il messaggio specificato.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
Importa un messaggio solo nella cassetta di posta di questo utente, con scansione e classificazione standard dell'invio di email, simile alla ricezione tramite SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Inserisce direttamente un messaggio solo nella cassetta di posta di questo utente, in modo simile a IMAP APPEND, bypassando la maggior parte delle analisi e delle classificazioni.
list GET /gmail/v1/users/{userId}/messages
Elenca i messaggi nella casella di posta dell'utente.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Modifica le etichette del messaggio specificato.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
Invia il messaggio specificato ai destinatari nelle intestazioni To, Cc e Bcc.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Sposta il messaggio specificato nel cestino.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
Rimuove il messaggio specificato dal cestino.

Risorsa REST: v1.users.messages.attachments

Metodi
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
Recupera l'allegato del messaggio specificato.

Risorsa REST: v1.users.settings

Metodi
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Recupera l'impostazione di inoltro automatico per l'account specificato.
getImap GET /gmail/v1/users/{userId}/settings/imap
Recupera le impostazioni IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Recupera le impostazioni della lingua.
getPop GET /gmail/v1/users/{userId}/settings/pop
Recupera le impostazioni POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Recupera le impostazioni del risponditore automatico.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
Aggiorna l'impostazione di inoltro automatico per l'account specificato.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
Aggiorna le impostazioni IMAP.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
Aggiorna le impostazioni della lingua.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Aggiorna le impostazioni POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Aggiorna le impostazioni del risponditore automatico.

Risorsa REST: v1.users.settings.cse.identities

Metodi
create POST /gmail/v1/users/{userId}/settings/cse/identities
Crea e configura un'identità con crittografia lato client autorizzata a inviare posta dall'account utente.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Elimina un'identità di crittografia lato client.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Recupera una configurazione dell'identità della crittografia lato client.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Elenca le identità con crittografia lato client per un utente autenticato.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Associa una coppia di chiavi diversa a un'identità di crittografia lato client esistente.

Risorsa REST: v1.users.settings.cse.keypairs

Metodi
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
Crea e carica una catena di certificati S/MIME della chiave pubblica e i metadati della chiave privata per la crittografia lato client per l'utente autenticato.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
Disattiva una coppia di chiavi di crittografia lato client.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
Attiva una coppia di chiavi di crittografia lato client disattivata.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
Recupera una coppia di chiavi di crittografia lato client esistente.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
Elenca le coppie di chiavi di crittografia lato client per un utente autenticato.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Elimina una coppia di chiavi di crittografia lato client in modo definitivo e immediato.

Risorsa REST: v1.users.settings.delegates

Metodi
create POST /gmail/v1/users/{userId}/settings/delegates
Aggiunge un delegato con lo stato di verifica impostato direttamente su accepted, senza inviare alcuna email di verifica.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Rimuove il delegato specificato (che può avere qualsiasi stato di verifica) e revoca qualsiasi verifica che potrebbe essere stata richiesta per l'utilizzo.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Recupera il delegato specificato.
list GET /gmail/v1/users/{userId}/settings/delegates
Elenca i delegati per l'account specificato.

Risorsa REST: v1.users.settings.filters

Metodi
create POST /gmail/v1/users/{userId}/settings/filters
Crea un filtro.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
Elimina immediatamente e definitivamente il filtro specificato.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
Recupera un filtro.
list GET /gmail/v1/users/{userId}/settings/filters
Elenca i filtri dei messaggi di un utente di Gmail.

Risorsa REST: v1.users.settings.forwardingAddresses

Metodi
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
Crea un indirizzo di inoltro.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Elimina l'indirizzo di inoltro specificato e revoca qualsiasi verifica che potrebbe essere stata richiesta.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Recupera l'indirizzo di inoltro specificato.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Elenca gli indirizzi di inoltro per l'account specificato.

Risorsa REST: v1.users.settings.sendAs

Metodi
create POST /gmail/v1/users/{userId}/settings/sendAs
Crea un alias personalizzato per l'invio come "da".
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Elimina l'alias di invio come specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Recupera l'alias di invio come specificato.
list GET /gmail/v1/users/{userId}/settings/sendAs
Elenca gli alias di invio per l'account specificato.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Esegui il patching dell'alias di invio come specificato.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Aggiorna un alias per l'invio come.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Invia un'email di verifica all'indirizzo dell'alias di invio specificato.

Risorsa REST: v1.users.settings.sendAs.smimeInfo

Metodi
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Elimina la configurazione S/MIME specificata per l'alias Invia come specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Recupera la configurazione S/MIME specificata per l'alias Invia come specificato.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Inserisci (carica) la configurazione S/MIME specificata per l'alias Invia come specificato.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Elenca le configurazioni S/MIME per l'alias Invia come specificato.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Imposta la configurazione S/MIME predefinita per l'alias Invia come specificato.

Risorsa REST: v1.users.threads

Metodi
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Elimina immediatamente e definitivamente il thread specificato.
get GET /gmail/v1/users/{userId}/threads/{id}
Recupera il thread specificato.
list GET /gmail/v1/users/{userId}/threads
Elenca i thread nella posta in arrivo dell'utente.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
Modifica le etichette applicate al thread.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Sposta il thread specificato nel cestino.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Rimuove il thread specificato dal cestino.