4D Netkit: Assegnare etichette e ottenere più e-mail con l’API di Gmail

Da 4D v20 R4, aggiungiamo un paio di potenti miglioramenti al set di comandi di Gmail.

La prima funzione consente di recuperare più e-mail contemporaneamente, mentre la seconda permette di gestire le e-mail con etichetta.

Continuate a leggere per tutti i dettagli.

HDI Google Gestire le e-mail

Connessione all’account

Prima di creare un’e-mail, creeremo un oggetto di connessione OAuth 2.0 e un oggetto Google.

var $oAuth2 : cs.NetKit.OAuth2Provider
var $google : cs.NetKit.Google
$oAuth2:=cs.NetKit.OAuth2Provider.new($credentials)
$google:=cs.NetKit.Google.new($oAuth2; {mailType: "JMAP"})

Aggiungere o rimuovere le etichette delle e-mail

Le etichette sono utilizzate per classificare le e-mail. Sono simili alle cartelle di altri sistemi di posta elettronica. Ma la particolarità delle etichette è che si possono assegnare più etichette alla stessa email. L’etichetta può essere personalizzata o di sistema, come INBOX, SPAM, TRASH, UNREAD, STARRED o IMPORTANT. Ad esempio, un’e-mail può essere etichettata come “Lavoro” e “Importante” con la funzione .update():

$status:=$google.mail.update($mailIds; {addLabelIds: ["Work"; "IMPORTANT"]})

Allo stesso modo, è possibile rimuovere le etichette dai messaggi di posta elettronica con la funzione .update(). Ad esempio, se si desidera rimuovere l’etichetta NON LETTO:

$status:=$google.mail.update($mailIds; {removeLabelIds: ["UNREAD"]})

Scaricare più e-mail

Se si devono recuperare più messaggi di posta elettronica, è possibile farlo in una sola volta con la funzione .getMails():

$mailIds:=$google.mail.getMailIds({labelIds: ["INBOX","UNREAD"]})
// Gets the email according to the collection of mail ID
$mails:=$google.mail.getMails($mailIds)

La funzione .getMails() può prelevare solo 100 e-mail in una volta. Se si desidera ottenere un numero maggiore di e-mail, è necessario richiamare questa funzione più volte.

In sintesi, questo rilascio di funzionalità arricchisce il set di comandi Gmail di 4D, offrendo funzionalità avanzate come il recupero simultaneo di e-mail e la gestione efficiente delle etichette.

Per un’implementazione dettagliata, consultare la documentazione.