toEmailAddresses, string? subject,
string? htmlContent, string? textContent, string? templateName = null, string? templateData = null, string? contactListName = null)
{
var request = new SendEmailRequest
{
FromEmailAddress = fromEmailAddress
};
if (toEmailAddresses.Any())
{
request.Destination = new Destination { ToAddresses = toEmailAddresses };
}
if (!string.IsNullOrEmpty(templateName))
{
request.Content = new EmailContent()
{
Template = new Template
{
TemplateName = templateName,
TemplateData = templateData
}
};
}
else
{
request.Content = new EmailContent
{
Simple = new Message
{
Subject = new Content { Data = subject },
Body = new Body
{
Html = new Content { Data = htmlContent },
Text = new Content { Data = textContent }
}
}
};
}
if (!string.IsNullOrEmpty(contactListName))
{
request.ListManagementOptions = new ListManagementOptions
{
ContactListName = contactListName
};
}
try
{
var response = await _sesClient.SendEmailAsync(request);
return response.MessageId;
}
catch (AccountSuspendedException ex)
{
Console.WriteLine("The account's ability to send email has been permanently restricted.");
Console.WriteLine(ex.Message);
}
catch (MailFromDomainNotVerifiedException ex)
{
Console.WriteLine("The sending domain is not verified.");
Console.WriteLine(ex.Message);
}
catch (MessageRejectedException ex)
{
Console.WriteLine("The message content is invalid.");
Console.WriteLine(ex.Message);
}
catch (SendingPausedException ex)
{
Console.WriteLine("The account's ability to send email is currently paused.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while sending the email: {ex.Message}");
}
return string.Empty;
}
```
+ Pour plus de détails sur l'API, reportez-vous [SendEmail](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/SendEmail)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ses#code-examples).
Envoie un message.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sesv2.model.Body;
import software.amazon.awssdk.services.sesv2.model.Content;
import software.amazon.awssdk.services.sesv2.model.Destination;
import software.amazon.awssdk.services.sesv2.model.EmailContent;
import software.amazon.awssdk.services.sesv2.model.Message;
import software.amazon.awssdk.services.sesv2.model.SendEmailRequest;
import software.amazon.awssdk.services.sesv2.model.SesV2Exception;
import software.amazon.awssdk.services.sesv2.SesV2Client;
/**
* Before running this AWS SDK for Java (v2) example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SendEmail {
public static void main(String[] args) {
final String usage = """
Usage:
\s
Where:
sender - An email address that represents the sender.\s
recipient - An email address that represents the recipient.\s
subject - The subject line.\s
""";
if (args.length != 3) {
System.out.println(usage);
System.exit(1);
}
String sender = args[0];
String recipient = args[1];
String subject = args[2];
Region region = Region.US_EAST_1;
SesV2Client sesv2Client = SesV2Client.builder()
.region(region)
.build();
// The HTML body of the email.
String bodyHTML = "" + "" + "" + "Hello!
"
+ " See the list of customers.
" + "" + "";
send(sesv2Client, sender, recipient, subject, bodyHTML);
}
public static void send(SesV2Client client,
String sender,
String recipient,
String subject,
String bodyHTML) {
Destination destination = Destination.builder()
.toAddresses(recipient)
.build();
Content content = Content.builder()
.data(bodyHTML)
.build();
Content sub = Content.builder()
.data(subject)
.build();
Body body = Body.builder()
.html(content)
.build();
Message msg = Message.builder()
.subject(sub)
.body(body)
.build();
EmailContent emailContent = EmailContent.builder()
.simple(msg)
.build();
SendEmailRequest emailRequest = SendEmailRequest.builder()
.destination(destination)
.content(emailContent)
.fromEmailAddress(sender)
.build();
try {
System.out.println("Attempting to send an email through Amazon SES "
+ "using the AWS SDK for Java...");
client.sendEmail(emailRequest);
System.out.println("email was sent");
} catch (SesV2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
Envoie un message à l’aide d’un modèle.
```
String coupons = Files.readString(Paths.get("resources/coupon_newsletter/sample_coupons.json"));
for (String emailAddress : contactEmails) {
SendEmailRequest newsletterRequest = SendEmailRequest.builder()
.destination(Destination.builder().toAddresses(emailAddress).build())
.content(EmailContent.builder()
.template(Template.builder()
.templateName(TEMPLATE_NAME)
.templateData(coupons)
.build())
.build())
.fromEmailAddress(this.verifiedEmail)
.listManagementOptions(ListManagementOptions.builder()
.contactListName(CONTACT_LIST_NAME)
.build())
.build();
SendEmailResponse newsletterResponse = sesClient.sendEmail(newsletterRequest);
System.out.println("Newsletter sent to " + emailAddress + ": " + newsletterResponse.messageId());
}
```
Envoie un message contenant des informations d’en-tête.
```
public class SendwithHeader {
public static void main(String[] args) {
final String usage = """
Usage:
\s
Where:
sender - An email address that represents the sender.\s
recipient - An email address that represents the recipient.\s
subject - The subject line.\s
""";
if (args.length != 3) {
System.out.println(usage);
System.exit(1);
}
String sender = args[0];
String recipient = args[1];
String subject = args[2];
Region region = Region.US_EAST_1;
SesV2Client sesv2Client = SesV2Client.builder()
.region(region)
.build();
String bodyHTML = """
Hello!
See the list of customers.
""";
sendWithHeader(sesv2Client, sender, recipient, subject, bodyHTML);
sesv2Client.close();
}
/**
* Sends an email using the AWS SES V2 client.
*
* @param sesv2Client the SES V2 client to use for sending the email
* @param sender the email address of the sender
* @param recipient the email address of the recipient
* @param subject the subject of the email
* @param bodyHTML the HTML content of the email body
*/
public static void sendWithHeader(SesV2Client sesv2Client,
String sender,
String recipient,
String subject,
String bodyHTML) {
EmailContent emailContent = EmailContent.builder()
.simple(Message.builder()
.body(b -> b.html(c -> c.charset(UTF_8.name()).data(bodyHTML))
.text(c -> c.charset(UTF_8.name()).data(bodyHTML)))
.subject(c -> c.charset(UTF_8.name()).data(subject))
.headers(List.of(
MessageHeader.builder()
.name("List-Unsubscribe")
.value(", ")
.build(),
MessageHeader.builder()
.name("List-Unsubscribe-Post")
.value("List-Unsubscribe=One-Click")
.build()))
.build())
.build();
SendEmailRequest request = SendEmailRequest.builder()
.fromEmailAddress(sender)
.destination(d -> d.toAddresses(recipient))
.content(emailContent)
.build();
try {
SendEmailResponse response = sesv2Client.sendEmail(request);
System.out.println("Email sent! Message ID: " + response.messageId());
} catch (SesV2Exception e) {
System.err.println("Failed to send email: " + e.awsErrorDetails().errorMessage());
throw new RuntimeException(e);
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [SendEmail](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendEmail)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Python ]
**Kit SDK for Python (Boto3)**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sesv2#code-examples).
Envoie un message à tous les membres de la liste de contacts.
```
def main():
"""
The main function that orchestrates the execution of the workflow.
"""
print(INTRO)
ses_client = boto3.client("sesv2")
workflow = SESv2Workflow(ses_client)
try:
workflow.prepare_application()
workflow.gather_subscriber_email_addresses()
workflow.send_coupon_newsletter()
workflow.monitor_and_review()
except ClientError as e:
print_error(e)
workflow.clean_up()
class SESv2Workflow:
"""
A class to manage the SES v2 Coupon Newsletter Workflow.
"""
def __init__(self, ses_client, sleep=True):
self.ses_client = ses_client
self.sleep = sleep
self.ses_client.send_email(
FromEmailAddress=self.verified_email,
Destination={"ToAddresses": [email]},
Content={
"Simple": {
"Subject": {
"Data": "Welcome to the Weekly Coupons Newsletter"
},
"Body": {
"Text": {"Data": welcome_text},
"Html": {"Data": welcome_html},
},
}
},
)
print(f"Welcome email sent to '{email}'.")
```
Envoie un message à tous les membres de la liste de contacts à l’aide d’un modèle.
```
def main():
"""
The main function that orchestrates the execution of the workflow.
"""
print(INTRO)
ses_client = boto3.client("sesv2")
workflow = SESv2Workflow(ses_client)
try:
workflow.prepare_application()
workflow.gather_subscriber_email_addresses()
workflow.send_coupon_newsletter()
workflow.monitor_and_review()
except ClientError as e:
print_error(e)
workflow.clean_up()
class SESv2Workflow:
"""
A class to manage the SES v2 Coupon Newsletter Workflow.
"""
def __init__(self, ses_client, sleep=True):
self.ses_client = ses_client
self.sleep = sleep
self.ses_client.send_email(
FromEmailAddress=self.verified_email,
Destination={"ToAddresses": [email_address]},
Content={
"Template": {
"TemplateName": TEMPLATE_NAME,
"TemplateData": coupon_items,
}
},
ListManagementOptions={"ContactListName": CONTACT_LIST_NAME},
)
```
+ Pour plus de détails sur l'API, consultez [SendEmail](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/SendEmail)le *AWS manuel de référence de l'API SDK for Python (Boto3*).
------
#### [ Ruby ]
**Kit SDK pour Ruby**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/ses/v2#code-examples).
```
require 'aws-sdk-sesv2'
require_relative 'config' # Recipient and sender email addresses.
# Set up the SESv2 client.
client = Aws::SESV2::Client.new(region: AWS_REGION)
def send_email(client, sender_email, recipient_email)
response = client.send_email(
{
from_email_address: sender_email,
destination: {
to_addresses: [recipient_email]
},
content: {
simple: {
subject: {
data: 'Test email subject'
},
body: {
text: {
data: 'Test email body'
}
}
}
}
}
)
puts "Email sent from #{SENDER_EMAIL} to #{RECIPIENT_EMAIL} with message ID: #{response.message_id}"
end
send_email(client, SENDER_EMAIL, RECIPIENT_EMAIL)
```
+ Pour plus de détails sur l'API, reportez-vous [SendEmail](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SendEmail)à la section *Référence des AWS SDK pour Ruby API*.
------
#### [ Rust ]
**SDK pour Rust**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
Envoie un message à tous les membres de la liste de contacts.
```
async fn send_message(
client: &Client,
list: &str,
from: &str,
subject: &str,
message: &str,
) -> Result<(), Error> {
// Get list of email addresses from contact list.
let resp = client
.list_contacts()
.contact_list_name(list)
.send()
.await?;
let contacts = resp.contacts();
let cs: Vec = contacts
.iter()
.map(|i| i.email_address().unwrap_or_default().to_string())
.collect();
let mut dest: Destination = Destination::builder().build();
dest.to_addresses = Some(cs);
let subject_content = Content::builder()
.data(subject)
.charset("UTF-8")
.build()
.expect("building Content");
let body_content = Content::builder()
.data(message)
.charset("UTF-8")
.build()
.expect("building Content");
let body = Body::builder().text(body_content).build();
let msg = Message::builder()
.subject(subject_content)
.body(body)
.build();
let email_content = EmailContent::builder().simple(msg).build();
client
.send_email()
.from_email_address(from)
.destination(dest)
.content(email_content)
.send()
.await?;
println!("Email sent to list");
Ok(())
}
```
Envoie un message à tous les membres de la liste de contacts à l’aide d’un modèle.
```
let coupons = std::fs::read_to_string("../resources/newsletter/sample_coupons.json")
.unwrap_or_else(|_| r#"{"coupons":[]}"#.to_string());
let email_content = EmailContent::builder()
.template(
Template::builder()
.template_name(TEMPLATE_NAME)
.template_data(coupons)
.build(),
)
.build();
match self
.client
.send_email()
.from_email_address(self.verified_email.clone())
.destination(Destination::builder().to_addresses(email.clone()).build())
.content(email_content)
.list_management_options(
ListManagementOptions::builder()
.contact_list_name(CONTACT_LIST_NAME)
.build()?,
)
.send()
.await
{
Ok(output) => {
if let Some(message_id) = output.message_id {
writeln!(
self.stdout,
"Newsletter sent to {} with message ID {}",
email, message_id
)?;
} else {
writeln!(self.stdout, "Newsletter sent to {}", email)?;
}
}
Err(e) => return Err(anyhow!("Error sending newsletter to {}: {}", email, e)),
}
```
+ Pour plus de détails sur l'API, voir [SendEmail](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.send_email)la section de *référence de l'API AWS SDK for Rust*.
------
#### [ SAP ABAP ]
**Kit SDK pour SAP ABAP**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/se2#code-examples).
Envoie un message.
```
TRY.
" Create destination with recipient address
DATA lt_to_addresses TYPE /aws1/cl_se2emailaddresslist_w=>tt_emailaddresslist.
APPEND NEW /aws1/cl_se2emailaddresslist_w( iv_value = iv_to_email_address ) TO lt_to_addresses.
DATA(lo_destination) = NEW /aws1/cl_se2destination(
it_toaddresses = lt_to_addresses ).
" Create message content
DATA(lo_subject) = NEW /aws1/cl_se2content( iv_data = iv_subject ).
DATA(lo_text_body) = NEW /aws1/cl_se2content( iv_data = iv_text_body ).
DATA(lo_html_body) = NEW /aws1/cl_se2content( iv_data = iv_html_body ).
DATA(lo_body) = NEW /aws1/cl_se2body(
io_text = lo_text_body
io_html = lo_html_body ).
DATA(lo_message) = NEW /aws1/cl_se2message(
io_subject = lo_subject
io_body = lo_body ).
DATA(lo_content) = NEW /aws1/cl_se2emailcontent(
io_simple = lo_message ).
" Send the email
lo_se2->sendemail(
iv_fromemailaddress = iv_from_email_address
io_destination = lo_destination
io_content = lo_content ).
MESSAGE 'Email sent successfully.' TYPE 'I'.
CATCH /aws1/cx_se2accountsuspendedex INTO DATA(lo_account_suspended).
MESSAGE 'Account suspended.' TYPE 'I'.
RAISE EXCEPTION lo_account_suspended.
CATCH /aws1/cx_se2badrequestex INTO DATA(lo_bad_request).
MESSAGE 'Bad request.' TYPE 'I'.
RAISE EXCEPTION lo_bad_request.
CATCH /aws1/cx_se2messagerejected INTO DATA(lo_message_rejected).
MESSAGE 'Message rejected - check email verification.' TYPE 'I'.
RAISE EXCEPTION lo_message_rejected.
ENDTRY.
```
Envoie un message à l’aide d’un modèle.
```
TRY.
" Create destination with recipient address
DATA lt_to_addresses TYPE /aws1/cl_se2emailaddresslist_w=>tt_emailaddresslist.
APPEND NEW /aws1/cl_se2emailaddresslist_w( iv_value = iv_to_email_address ) TO lt_to_addresses.
DATA(lo_destination) = NEW /aws1/cl_se2destination(
it_toaddresses = lt_to_addresses ).
" Create template reference
DATA(lo_template) = NEW /aws1/cl_se2template(
iv_templatename = iv_template_name
iv_templatedata = iv_template_data ).
DATA(lo_content) = NEW /aws1/cl_se2emailcontent(
io_template = lo_template ).
" Create list management options
DATA(lo_list_mgmt) = NEW /aws1/cl_se2listmanagementopts(
iv_contactlistname = iv_contact_list_name ).
" Send the email using template
lo_se2->sendemail(
iv_fromemailaddress = iv_from_email_address
io_destination = lo_destination
io_content = lo_content
io_listmanagementoptions = lo_list_mgmt ).
MESSAGE 'Email sent using template successfully.' TYPE 'I'.
CATCH /aws1/cx_se2accountsuspendedex INTO DATA(lo_account_suspended).
MESSAGE 'Account suspended.' TYPE 'I'.
RAISE EXCEPTION lo_account_suspended.
CATCH /aws1/cx_se2badrequestex INTO DATA(lo_bad_request).
MESSAGE 'Bad request.' TYPE 'I'.
RAISE EXCEPTION lo_bad_request.
CATCH /aws1/cx_se2messagerejected INTO DATA(lo_message_rejected).
MESSAGE 'Message rejected - check email verification.' TYPE 'I'.
RAISE EXCEPTION lo_message_rejected.
ENDTRY.
```
+ Pour plus de détails sur l'API, reportez-vous [SendEmail](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)à la section de référence du *AWS SDK pour l'API SAP ABAP*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation d'Amazon SES avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.