BatchSendMail - - Centre de documentation Alibaba Cloud

Envoie des e-mails par lots.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dm:BatchSendMail

none

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
TemplateName	string	Non	Le nom d'un modèle pré-créé et approuvé.	test1
AccountName	string	Oui	L'adresse de l'expéditeur configurée dans la console de gestion.	test@example.com
ReceiversName	string	Non	Le nom d'une liste de destinataires pré-créée dans laquelle des destinataires ont été importés. Remarque : Le nombre de destinataires dans la liste ne doit pas dépasser le quota quotidien restant. Sinon, l'envoi de l'e-mail échoue. Ne supprimez pas la liste de destinataires avant au moins 10 minutes après le déclenchement de la tâche. Sinon, l'envoi de l'e-mail risque d'échouer.	test2
AddressType	integer	Oui	Valeurs valides : 0 : compte aléatoire 1 : adresse de l'expéditeur.	1
TagName	string	Non	Le nom de la balise de l'e-mail.	test3
ReplyAddress	string	Non	L'adresse de réponse.	test2***@example.net
ReplyAddressAlias	string	Non	L'alias de l'adresse de réponse.	Xiaohong
ClickTrace	string	Non	Valeurs valides : 1 : active le suivi des données. 0 (par défaut) : désactive le suivi des données.	0
UnSubscribeLinkType	string	Non	Le type de lien de désabonnement généré. Pour plus d'informations, consultez Mécanisme de génération et de filtrage des liens de désabonnement. Valeurs valides : disabled : aucun lien de désabonnement n'est généré. default : la stratégie par défaut est utilisée. Un lien de désabonnement est généré lorsque des e-mails sont envoyés depuis une adresse d'expéditeur par lots vers des domaines spécifiques contenant des mots-clés tels que « gmail », « yahoo », « google », « aol.com », « hotmail », « outlook » ou « ymail.com ». La langue d'affichage est automatiquement déterminée en fonction des paramètres du navigateur du destinataire.	default
UnSubscribeFilterLevel	string	Non	Le niveau de filtrage. Pour plus d'informations, consultez Mécanisme de génération et de filtrage des liens de désabonnement. Valeurs valides : disabled : aucun filtrage n'est appliqué. default : la stratégie par défaut est utilisée. Les adresses de lot sont filtrées au niveau de l'adresse de l'expéditeur. mailfrom : filtrage au niveau de l'adresse de l'expéditeur. mailfrom_domain : filtrage au niveau du domaine de l'expéditeur. edm_id : filtrage au niveau du compte.	mailfrom_domain
Headers	string	Non	Les paramètres d'en-tête de l'e-mail. Les champs standard et non standard doivent respecter les exigences de syntaxe des en-têtes définies dans la norme. Un maximum de 10 en-têtes peut être transmis via le champ headers lors de l'envoi d'e-mails via l'API. Les en-têtes qui dépassent cette limite sont ignorés. SMTP n'a pas cette limite. Champs standard Message-ID, List-Unsubscribe, List-Unsubscribe-Post Les champs standard remplacent les valeurs d'origine dans l'en-tête de l'e-mail. Champs non standard Insensibles à la casse. a. Champs préfixés par X-User- (non transmis à EventBridge ou Message Service (MNS). Cette restriction s'applique uniquement à l'API. SMTP autorise tous les champs personnalisés.) b. Champs préfixés par X-User-Notify- (transmis à EventBridge et Message Service (MNS). L'API et SMTP sont tous deux pris en charge.) Lorsqu'ils sont transmis à EventBridge ou MNS, ces champs sont inclus sous le champ header.	{ "Message-ID": "", "X-User-UID1": "UID-1-000001", "X-User-UID2": "UID-2-000001", "X-User-Notify-UID1": "UID-3-000001", "X-User-Notify-UID2": "UID-4-000001" }
IpPoolId	string	Non	L'identifiant du pool d'adresses IP dédiées. Les utilisateurs ayant acheté des adresses IP dédiées peuvent utiliser ce paramètre pour spécifier l'adresse IP sortante pour cette tâche d'envoi d'e-mails.	e4xxxxxe-4xx0-4xx3-8xxa-74cxxxxx1cef
DomainAuth	boolean	Non	Indique si l'authentification au niveau du domaine doit être activée. Valeurs valides : true false Utilisez ce paramètre uniquement pour l'authentification au niveau du domaine. Ignorez-le pour l'authentification au niveau de l'adresse de l'expéditeur. Créez l'adresse domain-auth-created-by-system@example.com dans la console. Conservez le préfixe avant @ inchangé et remplacez le suffixe par votre propre nom de domaine. Scénario API Définissez AccountName sur le nom de domaine. Le destinataire voit domain-auth-created-by-system@example.com comme expéditeur. Scénario SMTP a. Appelez l'opération ModifyPWByDomain pour définir le mot de passe du domaine. b. Authentifiez-vous avec le nom de domaine et le mot de passe configuré. Transmettez une adresse personnalisée telle que user@example.com comme expéditeur réel (mailfrom). Le destinataire voit user@example.com comme expéditeur.	true
TemplateContent	object	Non	Le contenu personnalisé de l'e-mail. Vous pouvez spécifier directement le contenu sans créer de modèle au préalable. Spécifiez ce paramètre ou TemplateName. Si TemplateContent et TemplateName sont tous deux spécifiés, TemplateName est prioritaire.
Subject	string	Non	L'objet de l'e-mail.	Black Friday : profitez de remises exclusives
HtmlBody	string	Non	Le corps HTML de l'e-mail. Remarque : HtmlBody et TextBody sont utilisés pour différents types de contenu d'e-mail. Vous devez spécifier l'un des deux. Le nouveau SDK utilise Body pour le passage des paramètres avec une limite de taille d'environ 8 Mo (Java 1.4.0 et versions ultérieures, Python3 1.4.0 et versions ultérieures, PHP 1.4.0 et versions ultérieures).	10 % de réduction sur l'ensemble du site, aujourd'hui uniquement
TextBody	string	Non	Le corps en texte brut de l'e-mail. Remarque : HtmlBody et TextBody sont utilisés pour différents types de contenu d'e-mail. Vous devez spécifier l'un des deux. Le nouveau SDK utilise Body pour le passage des paramètres avec une limite de taille d'environ 8 Mo (Java 1.4.0 et versions ultérieures, Python3 1.4.0 et versions ultérieures, PHP 1.4.0 et versions ultérieures).	10 % de réduction sur l'ensemble du site, aujourd'hui uniquement
Alias	string	Non	Le nom d'affichage de l'expéditeur.	Jackie
Receivers	array<object>	Non	La liste des destinataires. Le nombre de destinataires ne peut pas dépasser 100. Spécifiez ce paramètre ou ReceiversName. Si Receivers et ReceiversName sont tous deux spécifiés, ReceiversName est prioritaire. Exemple : [{"To":["Jackie@example.com"],"TemplateData":{"UserName":"Jackie"}},{"To":["Tom@example.com"],"TemplateData":{"UserName":"Tom"}}].
	array<object>	Non	Les détails d'un destinataire personnalisé.
To	array	Non	La liste des destinataires. Ce paramètre est de type tableau.
	string	Non	L'adresse e-mail.	Jackie@example.com
TemplateData	object	Non	Les paramètres du modèle d'e-mail. Ce paramètre est de type map JSON.
	string	Non	Chaîne clé-valeur.	{"UserName": "Jackie"}

Éléments de réponse

Élément	Type	Description	Exemple
	object
EnvId	string	L'identifiant de l'événement.	xxx
RequestId	string	L'identifiant de la requête.	12D086F6-8F31-4658-84C1-006DED011A85

Exemples

JSON format

{
  "EnvId": "xxx",
  "RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.