وضعیت تحویل را با برنامه افزودنی Trigger Email مدیریت کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
هنگامی که یک سند به مجموعه اضافه می شود، برنامه افزودنی آن را برای پردازش تحویل ایمیل انتخاب می کند. برنامه افزودنی در حین پردازش ایمیل، فیلد delivery را در سند ایجاد و به روز می کند.
پردازش تحویل ایمیل
فیلد delivery را می توان با فیلدهای زیر پر کرد:
- حالت: یکی از
PENDING ، PROCESSING ، SUCCESS یا ERROR . - startTime: زمان شروع پردازش ایمیل.
- endTime: زمانی که پردازش ایمیل تکمیل شد (یعنی در حالت
SUCCESS یا ERROR به پایان رسید) مهر زمانی را نشان می‌دهد. - خطا: اگر خطای تحویل ایمیل وجود داشته باشد، یک پیام خطا در اینجا پر می شود.
- تلاش: تعداد تلاش‌های ارسال برای این ایمیل.
- leaseExpireTime: در صورت هنگ یا وقفه زمانی، زمانی که در آن یک وضعیت
PROCESSING باید خطا در نظر گرفته شود. - اطلاعات: پس از تحویل موفقیت آمیز ایمیل (حداقل به یک آدرس)، این فیلد با فیلدهای زیر پر می شود:
- messageId: شناسه پیام ایمیل ارسالی.
- پذیرفته شده: مجموعه ای از آدرس های ایمیل که ایمیل با موفقیت به آنها تحویل داده شد.
- رد شده: مجموعه ای از آدرس های ایمیل که ایمیل به آنها تحویل داده نمی شود.
- در انتظار: مجموعه ای از آدرس های ایمیل که به طور موقت توسط SMTP رد شده اند.
- پاسخ: آخرین پاسخ از سرور SMTP.
یک ایمیل معمولاً از PENDING به PROCESSING به SUCCESS یا ERROR می رود. هنگامی که در وضعیت SUCCESS یا ERROR قرار می گیرید، تغییرات اضافی در سند باعث نمی شود که برنامه افزودنی برای ارسال ایمیل دیگر اقدام کند. برای ارسال مجدد ایمیل همراه با به‌روزرسانی‌های سند، می‌توانید state به PENDING یا RETRY تغییر دهید.
تلاش های مجدد دستی
مواردی وجود دارد که در آن تحویل ایمیل به روشی قابل بازیابی انجام نمی شود یا سند را می توان به صورت دستی برای تحویل مناسب با تغییرات جزئی تصحیح کرد. در حالی که تلاش‌های مجدد خودکار نیستند، می‌توانید به صورت دستی state در قسمت delivery به RETRY تغییر دهید تا برنامه افزودنی دوباره ارسال ایمیل را انجام دهد (و تعداد attempts را افزایش دهد).
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Manage delivery status with the Trigger Email extension\n\n\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-------------------------\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--------------\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`)."]]
