4D Netkit: Přiřazení štítků a získání více e-mailů pomocí rozhraní Gmail API

Od verze 4D v20 R4 přidáváme do sady příkazů Gmail dvojici výkonných vylepšení.

První funkce umožňuje načítat několik e-mailů současně a druhá vám umožní spravovat e-maily se štítky.

Čtěte dále a dozvíte se všechny podrobnosti.

HDI Správa e-mailů Google

Připojení k účtu

Před vytvořením e-mailu vytvoříme objekt připojení OAuth 2.0 a objekt 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"})

Přidání nebo odebrání štítků e-mailů

Štítky slouží ke kategorizaci e-mailů. Jsou podobné složkám v jiných e-mailových systémech. Zvláštností štítků je však to, že jednomu e-mailu můžete přiřadit několik štítků. Tento štítek může být vlastní nebo systémový, například INBOX, SPAM, TRASH, UNREAD, STARRED nebo IMPORTANT. E-mail lze například označit jako „Pracovní“ a „DŮLEŽITÉ“ pomocí .update():

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

Stejným způsobem můžete z e-mailů odstranit štítky pomocí funkce .update(). Pokud například chcete odstranit štítek NEPŘEČTENÝ:

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

Stáhnout více e-mailů

Pokud chcete stáhnout několik e-mailů, můžete to udělat najednou pomocí funkce .getMails():

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

Funkce .getMails() lze najednou stáhnout pouze 100 e-mailů. Pokud potřebujete získat více e-mailů, zavolejte tuto funkci několikrát.

Souhrnně lze říci, že tato verze funkcí obohacuje sadu příkazů služby Gmail 4D a nabízí rozšířené možnosti, jako je současné načítání e-mailů a efektivní správa štítků.

Podrobnou implementaci naleznete v dokumentaci.