Gmail API

L'API Gmail ti consente di visualizzare e gestire i dati della casella di posta 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 una macchina 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 potrebbe 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 attuale.
stop POST /gmail/v1/users/{userId}/stop
Disattiva la ricezione delle notifiche push per la casella di posta dell'utente specificato.
watch POST /gmail/v1/users/{userId}/watch
Configura o aggiorna una notifica push sull'orologio 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 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 casella di posta 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 apportate alla casella di posta specificata.

Risorsa REST: v1.users.labels

Metodi
create POST /gmail/v1/users/{userId}/labels
Crea un'etichetta.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Elimina immediatamente e definitivamente l'etichetta specificata e la rimuove da tutti i messaggi e le conversazioni 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}
Applica la patch all'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 per 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 casella di posta di questo utente, con scansione e classificazione standard della distribuzione delle email simili alla ricezione tramite SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Inserisce direttamente un messaggio nella casella di posta di questo utente in modo simile a IMAP APPEND, ignorando la maggior parte delle scansioni 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à criptate 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 di chiave pubblica S/MIME per la crittografia lato client e i metadati della chiave privata 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 che era stata 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 permanente 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 utilizzarlo.
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 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}
Ottiene 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 "Da" per l'invio.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Elimina l'alias Invia come specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Recupera l'alias Invia come specificato.
list GET /gmail/v1/users/{userId}/settings/sendAs
Elenca gli alias Invia come per l'account specificato.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Applica la patch all'alias Invia come specificato.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Aggiorna un alias Invia come.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Invia un'email di verifica all'indirizzo alias Invia come 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.
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 le conversazioni nella casella di posta 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.