Gerenciar o status de entrega com a extensão do acionador de e-mails
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A extensão seleciona um documento, quando ele é adicionado à coleção, para processar
o envio de e-mails. Com a extensão, você cria e atualiza um campo delivery no
documento enquanto o e-mail é processado.
Processamento de entrega de e-mails
O campo delivery pode ser preenchido com os seguintes campos:
- state: um dos campos
PENDING, PROCESSING, SUCCESS ou ERROR.
- startTime: carimbo de data/hora em que o processamento de e-mails começou.
- endTime: carimbo de data/hora em que o processamento de e-mails foi concluído. Ou seja, no estado
SUCCESS ou ERROR.
- error: se houver um erro na entrega do e-mail, uma mensagem de erro será exibida aqui.
- attempts: o número de tentativas de entrega deste e-mail.
- leaseExpireTime: no caso de congelamento ou tempo limite atingido, o horário em que o estado
PROCESSING será considerado um erro.
- info: após o envio do e-mail (para pelo menos um endereço), este campo será preenchido com os seguintes campos:
- messageId: o ID da mensagem do e-mail entregue.
- accepted: matriz de endereços de e-mail para os quais o e-mail foi entregue.
- rejected: matriz de endereços de e-mail para os quais não foi possível entregar o e-mail.
- pending: matriz de endereços de e-mail que foram temporariamente rejeitados pelo SMTP.
- response: a última resposta do servidor SMTP.
Um e-mail normalmente é enviado de PENDING para PROCESSING como SUCCESS ou
ERROR. Depois que o e-mail estiver no estado SUCCESS ou ERROR, outras alterações no
documento não acionarão a extensão para enviar outro e-mail. Para enviar outro
e-mail com atualizações no documento, altere state para PENDING ou RETRY.
Novas tentativas manuais
Quando o envio do e-mail falha, há casos em que é possível recuperá-lo
ou corrigir o documento manualmente para garantir a entrega com pequenas
modificações. Embora as tentativas não sejam automáticas, é possível alterar manualmente o
state no campo delivery para RETRY. Dessa forma, a extensão tentará entregar
o e-mail novamente (e aumentará o número de attempts).
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-13 UTC.
[null,null,["Última atualização 2025-08-13 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`)."]]
