Gérer l'état de distribution avec l'extension Trigger Email (Adresse e-mail de déclenchement)
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Lorsqu'un document est ajouté à la collection, l'extension le récupère pour le traitement de l'envoi par e-mail. L'extension crée et met à jour un champ delivery dans le document lorsqu'elle traite l'e-mail.
Traitement de la distribution des e-mails
Le champ delivery peut être renseigné avec les champs suivants :
state : l'une des valeurs PENDING, PROCESSING, SUCCESS ou ERROR.
startTime : code temporel indiquant le début du traitement de l'e-mail.
endTime : code temporel indiquant la fin du traitement de l'e-mail (c'est-à-dire l'état SUCCESS ou ERROR).
error : si une erreur de distribution d'e-mail s'est produite, un message d'erreur s'affiche ici.
attempts : nombre de tentatives de distribution pour cet e-mail.
leaseExpireTime : en cas de blocage ou de délai avant expiration, heure à laquelle un état PROCESSING doit être considéré comme une erreur.
info : une fois l'e-mail envoyé (à au moins une adresse), ce champ est renseigné avec les champs suivants :
messageId : ID du message de l'e-mail remis.
accepted : tableau des adresses e-mail auxquelles l'e-mail a bien été envoyé.
rejected : tableau des adresses e-mail auxquelles l'e-mail n'a pas pu être envoyé.
pending : tableau des adresses e-mail qui ont été temporairement refusées par SMTP.
response : dernière réponse du serveur SMTP.
Un e-mail est généralement envoyé de PENDING à PROCESSING, puis à SUCCESS ou ERROR. Une fois l'état SUCCESS ou ERROR atteint, les modifications supplémentaires apportées au document ne déclenchent pas l'envoi d'un autre e-mail par l'extension. Pour renvoyer un e-mail contenant des mises à jour de documents, vous pouvez remplacer state par PENDING ou RETRY.
Nouvelles tentatives manuelles
Dans certains cas, l'envoi d'e-mails échoue de manière récupérable ou le document peut être corrigé manuellement pour être envoyé correctement avec des modifications mineures. Les nouvelles tentatives ne sont pas automatiques, mais vous pouvez modifier manuellement la valeur state dans le champ delivery pour la remplacer par RETRY. L'extension tentera alors d'envoyer l'e-mail à nouveau (et incrémentera le nombre de attempts).
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["\u003cbr /\u003e\n\nWhen a document is added to the collection, the extension picks it up for email\ndelivery processing. The extension creates and updates a `delivery` field in the\ndocument as it processes the email.\n\nEmail delivery processing\n\nThe `delivery` field can be populated with the following fields:\n\n- **state:** One of `PENDING`, `PROCESSING`, `SUCCESS`, or `ERROR`.\n- **startTime:** Timestamp when email processing began.\n- **endTime:** Timestamp when email processing completed (that is, ended in either a `SUCCESS` or `ERROR` state).\n- **error:** If there was an email delivery error, an error message will be populated here.\n- **attempts:** Number of delivery attempts for this email.\n- **leaseExpireTime:** In case of a hang or timeout, the time at which a `PROCESSING` state should be considered an error.\n- **info:** After successful email delivery (to at least one address), this field will be populated with the following fields:\n - **messageId:** The message ID of the delivered email.\n - **accepted:** Array of email addresses to which the email was successfully delivered.\n - **rejected:** Array of email addresses to which the email could not be delivered.\n - **pending:** Array of email addresses that were temporarily rejected by SMTP.\n - **response:** The last response from the SMTP server.\n\nAn email will typically go from `PENDING` to `PROCESSING` to either `SUCCESS` or\n`ERROR`. Once in the `SUCCESS` or `ERROR` state, additional changes to the\ndocument will not trigger the extension to send another email. To resend an\nemail with document updates, you can change the `state` to `PENDING` or `RETRY`.\n\nManual retries\n\nThere are instances in which email delivery fails in a recoverable fashion or\nthe document can be manually corrected for proper delivery with minor\nmodifications. While retries are not automatic, you can manually change the\n`state` in the `delivery` field to `RETRY` so that the extension attempts email\ndelivery again (and increments the number of `attempts`)."]]
