Gmail API

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

L'API Gmail 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, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile dal 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 potrebbe 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
Recupera il profilo Gmail dell'utente corrente.
stop POST /gmail/v1/users/{userId}/stop
Non ricevere più notifiche push per la casella di posta dell'utente specificata.
watch POST /gmail/v1/users/{userId}/watch
Configura o aggiorna un orologio 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}
Visualizza 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 specificata esistente 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
Visualizza 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 in modo definitivo l'etichetta specificata e la rimuove dai messaggi e dai thread a cui è applicata.
get GET /gmail/v1/users/{userId}/labels/{id}
Visualizza 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 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}
Riceve 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 delle email standard simili a quelle ricevute via SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Inserisci direttamente un messaggio nella casella di posta di questo utente in modo simile a IMAP APPEND, ignorando la maggior parte dei casi di scansione e classificazione.
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 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}
Riceve l'allegato del messaggio specificato.

Risorsa REST: v1.users.settings

Metodi
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Scarica l'impostazione di inoltro automatico per l'account specificato.
getImap GET /gmail/v1/users/{userId}/settings/imap
Riceve le impostazioni IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Riceve le impostazioni della lingua.
getPop GET /gmail/v1/users/{userId}/settings/pop
Riceve le impostazioni POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Riceve 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à 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 una configurazione dell'identità di 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 di chiave pubblica S/MIME di crittografia lato client e i metadati della chiave privata dell'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 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 un'email di verifica.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Rimuove il delegato specificato (che può essere in qualsiasi stato di verifica) e revoca le eventuali verifiche necessarie per il suo utilizzo.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Visualizza il delegato specificato.
list GET /gmail/v1/users/{userId}/settings/delegates
Elenca i delegati per l'account specificato.

Risorsa REST: v1.users.settings.filter

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}
Visualizza 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 l'eventuale verifica eventualmente richiesta.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
riceve 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 di invio personalizzato da.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Elimina l'alias di invio specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Visualizza 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 specificato.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Aggiorna un alias mittente.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Invia un'email di verifica all'indirizzo dell'alias mittente 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 di invio specificato.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Visualizza la configurazione S/MIME specificata per l'alias di invio specificato.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Inserisci (carica) la configurazione S/MIME specificata per l'alias di invio specificato.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Elenca le configurazioni S/MIME per l'alias di invio specificato.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Consente di impostare la configurazione S/MIME predefinita per l'alias di invio 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}
Visualizza 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.