Gmail API

L'API Gmail consente di visualizzare e gestire i dati delle caselle 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, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile dalle macchine per la descrizione e l'utilizzo delle 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 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
Consente di acquisire il profilo Gmail dell'utente corrente.
stop POST /gmail/v1/users/{userId}/stop
Interrompi la ricezione delle notifiche push per la casella di posta dell'utente specificata.
watch POST /gmail/v1/users/{userId}/watch
Configura o aggiorna uno smartwatch per le notifiche push nella casella di posta dell'utente specificata.

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}
Consente di ottenere 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 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}
Consente di ottenere 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 in base all'ID messaggio.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Modifica le etichette nei 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}
Consente di ottenere 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 una scansione e una classificazione per la consegna delle email standard analoga alla ricezione tramite SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Inserisce direttamente un messaggio solo nella casella di posta dell'utente, simile a IMAP APPEND, ignorando la maggior parte dell'analisi e della classificazione.
list GET /gmail/v1/users/{userId}/messages
Elenca i messaggi presenti nella casella di posta dell'utente.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Modifica le etichette nel 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}
Consente di ottenere l'allegato del messaggio specificato.

Risorsa REST: v1.users.settings

Metodi
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Consente di ottenere l'impostazione di inoltro automatico per l'account specificato.
getImap GET /gmail/v1/users/{userId}/settings/imap
Consente di recuperare le impostazioni IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Visualizza le impostazioni della lingua.
getPop GET /gmail/v1/users/{userId}/settings/pop
Consente di recuperare le impostazioni POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Visualizza 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
Consente di aggiornare le impostazioni della lingua.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Consente di aggiornare le impostazioni POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Consente di aggiornare 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à di crittografia lato client autorizzata a inviare email 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 la configurazione di un'identità crittografia lato client.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Elenca le identità con crittografia lato client di 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 con 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 è 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 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 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 le verifiche necessarie per il suo utilizzo.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Ottieni 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}
Ottieni 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 le verifiche necessarie.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Consente di ottenere l'indirizzo di inoltro specificato.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Elenca gli indirizzi di inoltro dell'account specificato.

Risorsa REST: v1.users.settings.sendAs

Metodi
create POST /gmail/v1/users/{userId}/settings/sendAs
Crea un alias del mittente personalizzato.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Elimina l'alias di invio specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Consente di ottenere l'alias di invio 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}
Applica la patch all'alias di invio come specificato.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Aggiorna un alias di invio 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 send-as specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Consente di ottenere la configurazione S/MIME specificata per l'alias send-as specificato.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Inserisci (carica) la configurazione S/MIME specificata per l'alias send-as specificato.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Elenca le configurazioni S/MIME per l'alias send-as specificato.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Consente di impostare la configurazione S/MIME predefinita per l'alias send-as 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}
Ottiene il thread specificato.
list GET /gmail/v1/users/{userId}/threads
Elenca i thread 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.