Sono disponibili altri esempi AWS SDK nel repository AWS Doc SDK Examples. GitHub
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzare SendBulkEmail con un SDK AWS
Il seguente esempio di codice mostra come utilizzareSendBulkEmail.
Gli esempi di operazioni sono estratti di codice da programmi più grandi e devono essere eseguiti nel contesto. È possibile visualizzare questa operazione nel contesto nel seguente esempio di codice:
- Python
-
- SDK per Python (Boto3)
-
class SESv2Wrapper:
"""Encapsulates Amazon SESv2 email sending actions."""
def __init__(self, sesv2_client: Any) -> None:
"""
Initializes the SESv2Wrapper with an SESv2 client.
:param sesv2_client: A Boto3 SESv2 client.
"""
self.sesv2_client = sesv2_client
@classmethod
def from_client(cls) -> "SESv2Wrapper":
"""
Creates an SESv2Wrapper instance with a default Boto3 SESv2 client.
:return: A new SESv2Wrapper instance.
"""
sesv2_client = boto3.client("sesv2")
return cls(sesv2_client)
def send_bulk_email(
self,
from_address: str,
template_name: str,
default_template_data: str,
bulk_entries: List[Dict[str, Any]],
attachments: Optional[List[Dict[str, Any]]] = None,
) -> List[Dict[str, Any]]:
"""
Sends a templated email to multiple recipients in a single API call.
All recipients receive the same attachment(s) defined in the default
content, while template data can be personalized per recipient.
:param from_address: The verified sender email address.
:param template_name: The name of an existing email template.
:param default_template_data: Default JSON template data string.
:param bulk_entries: A list of BulkEmailEntry dicts, each containing
'Destination' and optionally 'ReplacementEmailContent'.
:param attachments: An optional list of attachment dicts for all
recipients.
:return: A list of BulkEmailEntryResult dicts with status and MessageId.
:raises ClientError: If the message is rejected (MessageRejected).
"""
try:
template_content: Dict[str, Any] = {
"TemplateName": template_name,
"TemplateData": default_template_data,
}
if attachments:
template_content["Attachments"] = attachments
response = self.sesv2_client.send_bulk_email(
FromEmailAddress=from_address,
DefaultContent={"Template": template_content},
BulkEmailEntries=bulk_entries,
)
results = response.get("BulkEmailEntryResults", [])
logger.info(
"Sent bulk email from %s to %d recipients.",
from_address,
len(bulk_entries),
)
return results
except ClientError as err:
if err.response["Error"]["Code"] == "MessageRejected":
logger.error(
"Bulk message was rejected. Check that the template "
"exists, attachment file types are supported, and "
"total message size is within limits. Details: %s",
err.response["Error"]["Message"],
)
else:
logger.error(
"Couldn't send bulk email. Here's why: %s: %s",
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise