Nous avons annoncé la sortie end-of-support de la AWS SDK for JavaScript v2. Nous vous recommandons de migrer vers la AWS SDK for JavaScript version 3. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, reportez-vous à l'annonce associée.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de modèles d'e-mails dans Amazon SES

Cet exemple de code Node.js présente :

Amazon SES vous permet d'envoyer des e-mails personnalisés à l'aide de modèles d'e-mail. Pour en savoir plus sur la création et l'utilisation de modèles d'e-mail dans Amazon Simple Email Service, consultez la section Envoi d'e-mails personnalisés à l'aide de l'API Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Scénario

Dans cet exemple, vous utilisez une série de modules Node.js à utiliser avec des modèles d'e-mail. Les modules Node.js utilisent le SDK pour JavaScript créer et utiliser des modèles de courrier électronique en utilisant les méthodes suivantes de la classe AWS.SES client :

Tâches prérequises

Pour configurer et exécuter cet exemple, vous devez d'abord :

Liste de vos modèles d'e-mail

Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé ses_listtemplates.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre les paramètres de la méthode listTemplates de la classe client AWS.SES. Pour appeler la méthode listTemplates, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the promise and SES service object
var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .listTemplates({ MaxItems: ITEMS_COUNT })
  .promise();

// Handle promise's fulfilled/rejected states
templatePromise
  .then(function (data) {
    console.log(data);
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie la liste des modèles.

node ses_listtemplates.js

Cet exemple de code se trouve ici sur GitHub.

Récupération d'un modèle d'e-mail

Dans cet exemple, utilisez un module Node.js pour obtenir un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé ses_gettemplate.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre le paramètre TemplateName ainsi que les autres paramètres de la méthode getTemplate de la classe client AWS.SES. Pour appeler la méthode getTemplate, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// Load the AWS SDK for Node.js.
var AWS = require("aws-sdk");
// Set the AWS Region.
AWS.config.update({ region: "REGION" });

// Create the promise and Amazon Simple Email Service (Amazon SES) service object.
var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .getTemplate({ TemplateName: "TEMPLATE_NAME" })
  .promise();

// Handle promise's fulfilled/rejected states
templatePromise
  .then(function (data) {
    console.log(data.Template.SubjectPart);
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie les détails du modèle.

node ses_gettemplate.js

Cet exemple de code se trouve ici sur GitHub.

Création d'un modèle d'e-mail

Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé ses_createtemplate.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre les paramètres de la méthode createTemplate de la classe client AWS.SES, y compris TemplateName, HtmlPart, SubjectPart et TextPart. Pour appeler la méthode createTemplate, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create createTemplate params
var params = {
  Template: {
    TemplateName: "TEMPLATE_NAME" /* required */,
    HtmlPart: "HTML_CONTENT",
    SubjectPart: "SUBJECT_LINE",
    TextPart: "TEXT_CONTENT",
  },
};

// Create the promise and SES service object
var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .createTemplate(params)
  .promise();

// Handle promise's fulfilled/rejected states
templatePromise
  .then(function (data) {
    console.log(data);
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le modèle est ajouté à Amazon SES.

node ses_createtemplate.js

Cet exemple de code se trouve ici sur GitHub.

Mise à jour d'un modèle d'e-mail

Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé ses_updatetemplate.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre les valeurs de paramètre Template que vous souhaitez mettre à jour dans le modèle, avec le paramètre TemplateName obligatoire transmis à la méthode updateTemplate de la classe client AWS.SES. Pour appeler la méthode updateTemplate, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create updateTemplate parameters
var params = {
  Template: {
    TemplateName: "TEMPLATE_NAME" /* required */,
    HtmlPart: "HTML_CONTENT",
    SubjectPart: "SUBJECT_LINE",
    TextPart: "TEXT_CONTENT",
  },
};

// Create the promise and SES service object
var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .updateTemplate(params)
  .promise();

// Handle promise's fulfilled/rejected states
templatePromise
  .then(function (data) {
    console.log("Template Updated");
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie les détails du modèle.

node ses_updatetemplate.js

Cet exemple de code se trouve ici sur GitHub.

Suppression d'un modèle d'e-mail

Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé ses_deletetemplate.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre le paramètreTemplateName obligatoire à la méthode deleteTemplate de la classe client AWS.SES. Pour appeler la méthode deleteTemplate, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the promise and SES service object
var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .deleteTemplate({ TemplateName: "TEMPLATE_NAME" })
  .promise();

// Handle promise's fulfilled/rejected states
templatePromise
  .then(function (data) {
    console.log("Template Deleted");
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie les détails du modèle.

node ses_deletetemplate.js

Cet exemple de code se trouve ici sur GitHub.