4D Netkit : Attribuer des étiquettes et obtenir plusieurs courriels avec l’API Gmail

A partir de 4D v20 R4, nous ajoutons deux nouvelles fonctionnalités au jeu de commandes Gmail.

La première fonctionnalité vous permet de récupérer plusieurs courriels simultanément, et la seconde vous permettra de gérer des étiquettes de courriels.

Continuez à lire pour tous les détails.

HDI Google Gérer les e-mails

Connexion au compte

Avant de créer un email, nous allons créer un objet de connexion OAuth 2.0 et un objet 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"})

Ajouter ou supprimer des étiquettes d’email

Les étiquettes sont utilisées pour catégoriser les courriels. Ils sont similaires aux dossiers des autres systèmes de messagerie. Mais la particularité des étiquettes est qu’il est possible d’attribuer plusieurs étiquettes à un même courriel. Il peut s’agir d’un libellé personnalisé ou d’un libellé système comme INBOX, SPAM, TRASH, UNREAD, STARRED ou IMPORTANT. Par exemple, un courriel peut être étiqueté comme « Travail » et « IMPORTANT » à l’aide de la fonction .update() :

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

De la même manière, vous pouvez supprimer les étiquettes des messages électroniques à l’aide de la fonction .update(). Par exemple, si vous souhaitez supprimer l’étiquette NON LU :

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

Télécharger plusieurs emails

Si vous avez plusieurs courriels à récupérer, vous pouvez le faire en une seule fois avec la fonction .getMails() :

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

La fonction .getMails() ne peut récupérer que 100 messages électroniques à la fois. Si vous avez besoin de récupérer plus d’e-mails, appelez cette fonction plusieurs fois.

En résumé, ces nouvelles fonctionnalités enrichissent l’ensemble des commandes Gmail de 4D, en offrant des capacités améliorées telles que la récupération simultanée d’e-mails et une gestion efficace des étiquettes.

Pour une mise en œuvre détaillée, reportez-vous à la documentation.