Gmail Service

Gmail

Questo servizio ti consente di inviare email, comporre bozze, gestire etichette, contrassegnare messaggi e thread ed eseguire una serie di altre attività di gestione dell'account Gmail. Vedi anche Servizio di posta, un servizio più semplice che consente solo l'invio di email.

Corsi

Nome	Breve descrizione
GmailApp	Fornisce l'accesso a thread, messaggi ed etichette di Gmail.
GmailAttachment	Un allegato di Gmail.
GmailDraft	Una bozza di messaggio creata dall'utente nel suo account Gmail.
GmailLabel	Un'etichetta creata dall'utente nel suo account Gmail.
GmailMessage	Un messaggio nell'account Gmail di un utente.
GmailThread	Una discussione nell'account Gmail di un utente.

GmailApp

Metodi

Metodo	Tipo restituito	Breve descrizione
createDraft(recipient, subject, body)	GmailDraft	Crea una bozza di messaggio email.
createDraft(recipient, subject, body, options)	GmailDraft	Crea una bozza di email con argomenti facoltativi.
createLabel(name)	GmailLabel	Crea una nuova etichetta utente con il nome specificato.
deleteLabel(label)	GmailApp	Elimina l'etichetta specificata.
getAliases()	String[]	Recupera un elenco delle email configurate come alias per questo account in Gmail.
getDraft(draftId)	GmailDraft	Recupera la bozza di un messaggio email per ID.
getDraftMessages()	GmailMessage[]	Recupera tutte le bozze dei messaggi.
getDrafts()	GmailDraft[]	Recupera tutte le bozze dei messaggi Gmail.
getInboxThreads()	GmailThread[]	Recupera tutti i thread di Posta in arrivo indipendentemente dalle etichette.
getInboxThreads(start, max)	GmailThread[]	Recupera un intervallo di thread della Posta in arrivo indipendentemente dalle etichette.
getInboxUnreadCount()	Integer	Restituisce il numero di thread non letti nella posta in arrivo.
getMessageById(id)	GmailMessage	Recupera un messaggio in base all'ID.
getMessagesForThread(thread)	GmailMessage[]	Recupera tutti i messaggi nel thread specificato.
getMessagesForThreads(threads)	GmailMessage[][]	Recupera tutti i messaggi nei thread specificati.
getPriorityInboxThreads()	GmailThread[]	Recupera tutti i thread della Posta prioritaria indipendentemente dalle etichette.
getPriorityInboxThreads(start, max)	GmailThread[]	Recupera un intervallo di thread della Posta prioritaria indipendentemente dalle etichette.
getPriorityInboxUnreadCount()	Integer	Restituisce il numero di thread non letti nella Posta prioritaria.
getSpamThreads()	GmailThread[]	Recupera tutti i thread di spam indipendentemente dalle etichette.
getSpamThreads(start, max)	GmailThread[]	Recupera un intervallo di thread di spam indipendentemente dalle etichette.
getSpamUnreadCount()	Integer	Restituisce il numero di thread da leggere che sono spam.
getStarredThreads()	GmailThread[]	Recupera tutti i thread speciali indipendentemente dalle etichette.
getStarredThreads(start, max)	GmailThread[]	Recupera un intervallo di thread speciali indipendentemente dalle etichette.
getStarredUnreadCount()	Integer	Restituisce il numero di thread da leggere che sono stati aggiunti ai preferiti.
getThreadById(id)	GmailThread	Recupera un thread in base all'ID.
getTrashThreads()	GmailThread[]	Recupera tutti i thread del cestino indipendentemente dalle etichette.
getTrashThreads(start, max)	GmailThread[]	Recupera un intervallo di thread del cestino indipendentemente dalle etichette.
getUserLabelByName(name)	GmailLabel	Recupera un'etichetta dato il nome.
getUserLabels()	GmailLabel[]	Recupera un elenco di etichette create dall'utente.
markMessageRead(message)	GmailApp	Contrassegna questo messaggio come letto e ne forza l'aggiornamento.
markMessageUnread(message)	GmailApp	Contrassegna questo messaggio come non letto e ne forza l'aggiornamento.
markMessagesRead(messages)	GmailApp	Contrassegna questi messaggi come letti e forza l'aggiornamento.
markMessagesUnread(messages)	GmailApp	Contrassegna questi messaggi come non letti e forza l'aggiornamento dei messaggi.
markThreadImportant(thread)	GmailApp	Contrassegna questo thread come importante e ne forza l'aggiornamento.
markThreadRead(thread)	GmailApp	Contrassegna questo thread come letto e ne forza l'aggiornamento.
markThreadUnimportant(thread)	GmailApp	Contrassegna questo thread come non importante e ne forza l'aggiornamento.
markThreadUnread(thread)	GmailApp	Contrassegna questo thread come da leggere e ne forza l'aggiornamento.
markThreadsImportant(threads)	GmailApp	Contrassegna questi thread come importanti e li aggiorna.
markThreadsRead(threads)	GmailApp	Contrassegna questi thread come letti e li aggiorna.
markThreadsUnimportant(threads)	GmailApp	Contrassegna questi thread come non importanti e li aggiorna.
markThreadsUnread(threads)	GmailApp	Contrassegna questi thread come da leggere e li aggiorna.
moveMessageToTrash(message)	GmailApp	Sposta il messaggio nel cestino e ne forza l'aggiornamento.
moveMessagesToTrash(messages)	GmailApp	Sposta i messaggi specificati nel cestino e forza l'aggiornamento dei messaggi.
moveThreadToArchive(thread)	GmailApp	Sposta questo thread nell'archivio e lo aggiorna.
moveThreadToInbox(thread)	GmailApp	Sposta questo thread nella posta in arrivo e lo aggiorna.
moveThreadToSpam(thread)	GmailApp	Sposta questo thread nella cartella Spam e forza l'aggiornamento del thread.
moveThreadToTrash(thread)	GmailApp	Sposta questo thread nel cestino e ne forza l'aggiornamento.
moveThreadsToArchive(threads)	GmailApp	Sposta questi thread nell'archivio e li aggiorna.
moveThreadsToInbox(threads)	GmailApp	Sposta questi thread nella posta in arrivo e li aggiorna.
moveThreadsToSpam(threads)	GmailApp	Sposta questi thread nello spam e li aggiorna.
moveThreadsToTrash(threads)	GmailApp	Sposta questi thread nel cestino e li aggiorna.
refreshMessage(message)	GmailApp	Ricarica il messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
refreshMessages(messages)	GmailApp	Ricarica i messaggi e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
refreshThread(thread)	GmailApp	Ricarica il thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
refreshThreads(threads)	GmailApp	Ricarica i thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
search(query)	GmailThread[]	Cerca in Gmail con la query specificata.
search(query, start, max)	GmailThread[]	Cerca in Gmail con la query specificata.
sendEmail(recipient, subject, body)	GmailApp	Invia un messaggio email.
sendEmail(recipient, subject, body, options)	GmailApp	Invia un messaggio email con argomenti facoltativi.
setCurrentMessageAccessToken(accessToken)	void	Imposta il token di accesso del messaggio corrente che consente allo script di accedere alle proprietà GmailMessage correnti.
starMessage(message)	GmailApp	Aggiunge una stella a questo messaggio e ne forza l'aggiornamento.
starMessages(messages)	GmailApp	Aggiunge stelle a questi messaggi e ne forza l'aggiornamento.
unstarMessage(message)	GmailApp	Rimuove la stella da questo messaggio e lo aggiorna.
unstarMessages(messages)	GmailApp	Rimuove le stelle da questi messaggi e li aggiorna.

GmailAttachment

Metodi

Metodo	Tipo restituito	Breve descrizione
copyBlob()	Blob	Restituisce una copia di questo blob.
getAs(contentType)	Blob	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
getBytes()	Byte[]	Recupera i dati memorizzati in questo blob.
getContentType()	String	Ottiene il tipo di contenuto dei byte in questo blob.
getDataAsString()	String	Recupera i dati di questo blob come stringa con codifica UTF-8.
getDataAsString(charset)	String	Recupera i dati di questo blob come stringa con la codifica specificata.
getHash()	String	Recupera l'hash SHA1 dei contenuti per questo allegato.
getName()	String	Restituisce il nome di questo blob.
getSize()	Integer	Restituisce le dimensioni di questo allegato.
isGoogleType()	Boolean	Restituisce un valore che indica se questo blob è un file Google Workspace (Fogli, Documenti e così via).
setBytes(data)	Blob	Imposta i dati memorizzati in questo blob.
setContentType(contentType)	Blob	Imposta il tipo di contenuti dei byte in questo blob.
setContentTypeFromExtension()	Blob	Imposta il tipo di contenuti dei byte in questo blob in base all'estensione del file.
setDataFromString(string)	Blob	Imposta i dati di questo blob da una stringa con codifica UTF-8.
setDataFromString(string, charset)	Blob	Imposta i dati di questo blob da una stringa con la codifica specificata.
setName(name)	Blob	Imposta il nome di questo blob.

GmailDraft

Metodi

Metodo	Tipo restituito	Breve descrizione
deleteDraft()	void	Elimina questa bozza di messaggio.
getId()	String	Recupera l'ID di questa bozza di messaggio.
getMessage()	GmailMessage	Restituisce un oggetto GmailMessage che rappresenta questa bozza.
getMessageId()	String	Restituisce l'ID di GmailMessage che rappresenta questa bozza.
send()	GmailMessage	Invia questa bozza di email.
update(recipient, subject, body)	GmailDraft	Sostituisce i contenuti di questa bozza di messaggio.
update(recipient, subject, body, options)	GmailDraft	Sostituisce i contenuti di questa bozza di messaggio utilizzando argomenti facoltativi.

GmailLabel

Metodi

Metodo	Tipo restituito	Breve descrizione
addToThread(thread)	GmailLabel	Aggiunge questa etichetta al thread specificato e forza l'aggiornamento del thread (GmailThread.refresh()).
addToThreads(threads)	GmailLabel	Aggiunge questa etichetta ai thread specificati e forza l'aggiornamento dei thread.
deleteLabel()	void	Elimina questa etichetta.
getId()	String	Recupera l'ID di questa etichetta.
getName()	String	Restituisce il nome di questa etichetta.
getThreads()	GmailThread[]	Recupera i thread contrassegnati con questa etichetta.
getThreads(start, max)	GmailThread[]	Recupera un intervallo di thread contrassegnati con questa etichetta.
getUnreadCount()	Integer	Restituisce il numero di thread non letti contrassegnati con questa etichetta.
removeFromThread(thread)	GmailLabel	Rimuove questa etichetta dal thread specificato e forza l'aggiornamento del thread.
removeFromThreads(threads)	GmailLabel	Rimuove questa etichetta dai thread specificati e forza l'aggiornamento dei thread.

GmailMessage

Metodi

Metodo	Tipo restituito	Breve descrizione
createDraftReply(body)	GmailDraft	Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'indirizzo per risposte.
createDraftReply(body, options)	GmailDraft	Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'indirizzo Rispondi a, con argomenti facoltativi.
createDraftReplyAll(body)	GmailDraft	Crea una bozza di messaggio di risposta al mittente utilizzando l'indirizzo Rispondi a e tutti i destinatari di questo messaggio.
createDraftReplyAll(body, options)	GmailDraft	Crea una bozza di messaggio di risposta al mittente di questo messaggio utilizzando l'indirizzo Rispondi a e tutti i destinatari, con argomenti facoltativi.
forward(recipient)	GmailMessage	Inoltra questo messaggio a nuovi destinatari.
forward(recipient, options)	GmailMessage	Inoltra questo messaggio a nuovi destinatari, con argomenti facoltativi.
getAttachments()	GmailAttachment[]	Recupera tutti gli allegati per questo messaggio.
getAttachments(options)	GmailAttachment[]	Recupera tutti gli allegati per questo messaggio.
getBcc()	String	Restituisce i destinatari separati da virgole in Ccn di questo messaggio.
getBody()	String	Recupera i contenuti HTML del corpo di questo messaggio.
getCc()	String	Restituisce i destinatari in Cc separati da virgole di questo messaggio.
getDate()	Date	Visualizza la data e l'ora di questo messaggio.
getFrom()	String	Recupera il mittente di questo messaggio.
getHeader(name)	String	Recupera il valore di un'intestazione RFC 2822 dato il nome dell'intestazione.
getId()	String	Recupera l'ID di questo messaggio.
getPlainBody()	String	Recupera i contenuti del corpo di questo messaggio senza formattazione HTML.
getRawContent()	String	Recupera i contenuti non elaborati di questo messaggio.
getReplyTo()	String	Recupera l'indirizzo per le risposte di questo messaggio (di solito il mittente).
getSubject()	String	Recupera l'oggetto di questo messaggio.
getThread()	GmailThread	Recupera il thread che contiene questo messaggio.
getTo()	String	Recupera i destinatari separati da virgole di questo messaggio.
isDraft()	Boolean	Indica se questo messaggio è una bozza.
isInChats()	Boolean	Indica se questo messaggio è una chat.
isInInbox()	Boolean	Indica se il messaggio è nella posta in arrivo.
isInPriorityInbox()	Boolean	Restituisce true se questo messaggio si trova nella posta in arrivo prioritaria; altrimenti restituisce false.
isInTrash()	Boolean	Indica se questo messaggio si trova nel cestino.
isStarred()	Boolean	Indica se il messaggio è stato aggiunto a Speciali.
isUnread()	Boolean	Indica se questo messaggio è da leggere.
markRead()	GmailMessage	Contrassegna il messaggio come letto.
markUnread()	GmailMessage	Contrassegna il messaggio come da leggere.
moveToTrash()	GmailMessage	Sposta il messaggio nel cestino.
refresh()	GmailMessage	Ricarica questo messaggio e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
reply(body)	GmailMessage	Risposte al mittente di questo messaggio utilizzando l'indirizzo di risposta.
reply(body, options)	GmailMessage	Risposte al mittente di questo messaggio utilizzando l'indirizzo di risposta, con argomenti facoltativi.
replyAll(body)	GmailMessage	Risposte al mittente utilizzando l'indirizzo Rispondi a e a tutti i destinatari di questo messaggio.
replyAll(body, options)	GmailMessage	Risposte al mittente di questo messaggio utilizzando l'indirizzo di risposta e tutti i destinatari, con argomenti facoltativi.
star()	GmailMessage	Aggiunge il messaggio a Speciali.
unstar()	GmailMessage	Rimuove il messaggio da Speciali.

GmailThread

Metodi

Metodo	Tipo restituito	Breve descrizione
addLabel(label)	GmailThread	Aggiunge questa etichetta al thread.
createDraftReply(body)	GmailDraft	Crea una bozza di messaggio in risposta al mittente dell'ultimo messaggio di questo thread utilizzando l'indirizzo Rispondi a.
createDraftReply(body, options)	GmailDraft	Crea una bozza di messaggio di risposta al mittente dell'ultimo messaggio in questo thread utilizzando l'indirizzo Rispondi a, con argomenti facoltativi.
createDraftReplyAll(body)	GmailDraft	Crea una bozza di messaggio di risposta al mittente dell'ultimo messaggio di questo thread, utilizzando l'indirizzo Rispondi a e tutti i destinatari di questo messaggio.
createDraftReplyAll(body, options)	GmailDraft	Crea una bozza di messaggio di risposta al mittente dell'ultimo messaggio in questo thread, utilizzando l'indirizzo Rispondi a e tutti i destinatari, con argomenti facoltativi.
getFirstMessageSubject()	String	Recupera l'oggetto del primo messaggio nel thread.
getId()	String	Recupera l'ID di questo thread.
getLabels()	GmailLabel[]	Restituisce le etichette create dall'utente in questo thread.
getLastMessageDate()	Date	Restituisce la data dell'ultimo messaggio di questo thread.
getMessageCount()	Integer	Restituisce il numero di messaggi nel thread.
getMessages()	GmailMessage[]	Recupera i messaggi in questo thread.
getPermalink()	String	Ottiene un permalink per questo thread.
hasStarredMessages()	Boolean	Restituisce un valore che indica se il thread contiene messaggi aggiunti a Speciali.
isImportant()	Boolean	Restituisce un valore che indica se il thread è contrassegnato come importante.
isInChats()	Boolean	Restituisce un valore che indica se il thread è etichettato come chat.
isInInbox()	Boolean	Restituisce un valore che indica se il thread si trova nella posta in arrivo.
isInPriorityInbox()	Boolean	Restituisce true se questo thread si trova nella posta in arrivo prioritaria. In caso contrario, restituisce false.
isInSpam()	Boolean	Restituisce un valore che indica se il thread è contrassegnato come spam.
isInTrash()	Boolean	Restituisce un valore che indica se il thread si trova nel cestino.
isUnread()	Boolean	Restituisce un valore che indica se il thread contiene messaggi da leggere.
markImportant()	GmailThread	Contrassegna questo thread come importante.
markRead()	GmailThread	Contrassegna questo thread come letto.
markUnimportant()	GmailThread	Contrassegna questo thread come non importante.
markUnread()	GmailThread	Contrassegna questo thread come da leggere.
moveToArchive()	GmailThread	Sposta questo thread nell'archivio.
moveToInbox()	GmailThread	Sposta questo thread nella posta in arrivo.
moveToSpam()	GmailThread	Sposta questo thread nella cartella Spam.
moveToTrash()	GmailThread	Sposta questo thread nel cestino.
refresh()	GmailThread	Ricarica questo thread e lo stato associato da Gmail (utile nel caso in cui le etichette, lo stato di lettura, ecc. siano cambiati).
removeLabel(label)	GmailThread	Rimuove questa etichetta dal thread.
reply(body)	GmailThread	Rispondi al mittente dell'ultimo messaggio di questo thread utilizzando l'indirizzo replyTo.
reply(body, options)	GmailThread	Rispondi al mittente dell'ultimo messaggio di questo thread utilizzando l'indirizzo replyTo, con argomenti facoltativi.
replyAll(body)	GmailThread	Rispondi al mittente (utilizzando l'indirizzo Rispondi a) e a tutti i destinatari dell'ultimo messaggio di questo thread.
replyAll(body, options)	GmailThread	Rispondi al mittente (utilizzando l'indirizzo replyTo) e a tutti i destinatari dell'ultimo messaggio di questo thread, con argomenti facoltativi.