メールをバッチ送信します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
dm:BatchSendMail |
none |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| TemplateName |
string |
任意 |
事前に作成され、承認されたテンプレートの名前。 |
test1 |
| AccountName |
string |
必須 |
管理コンソールで設定された送信元アドレス。 |
test@example.com |
| ReceiversName |
string |
任意 |
受信者がアップロードされた、事前に作成された受信者リストの名前。 注意: リスト内の受信者数は、残りの日次割当クォータを超えてはなりません。超えた場合、メール送信は失敗します。 タスクがトリガーされてから少なくとも 10 分間は受信者リストを削除しないでください。削除すると、メール送信が失敗する可能性があります。 |
test2 |
| AddressType |
integer |
必須 |
有効な値:
|
1 |
| TagName |
string |
任意 |
メールのタグ名。 |
test3 |
| ReplyAddress |
string |
任意 |
返信先アドレス。 |
test2***@example.net |
| ReplyAddressAlias |
string |
任意 |
返信先アドレスのエイリアス。 |
小红 |
| ClickTrace |
string |
任意 |
有効な値:
|
0 |
| UnSubscribeLinkType |
string |
任意 |
生成される登録解除リンクのタイプ。詳細については、登録解除リンクの生成とフィルタリングメカニズムを参照してください。 有効な値:
表示言語は、受信者のブラウザ設定に基づいて自動的に決定されます。 |
default |
| UnSubscribeFilterLevel |
string |
任意 |
フィルタリングレベル。詳細については、登録解除リンクの生成とフィルタリングメカニズムを参照してください。 有効な値:
|
mailfrom_domain |
| Headers |
string |
任意 |
メールヘッダー設定。 標準フィールドと非標準フィールドの両方が、標準で定義されたヘッダーの構文要件に準拠する必要があります。API 経由でメールを送信する場合、headers フィールドを通じて最大 10 個のヘッダーを渡せます。この制限を超えるヘッダーは無視されます。SMTP にはこのような制限はありません。
Message-ID、List-Unsubscribe、List-Unsubscribe-Post 標準フィールドは、メールヘッダー内の元の値を上書きします。
大文字小文字を区別しません。 a. X-User- プレフィックス付きのフィールド (EventBridge またはメッセージサービス (MNS) にはプッシュされません。この制限は API にのみ適用されます。SMTP では任意のカスタムフィールドが許可されます。) b. X-User-Notify- プレフィックス付きのフィールド (EventBridge およびメッセージサービス (MNS) にプッシュされます。API と SMTP の両方がサポートされます。) EventBridge または MNS にプッシュされる場合、これらのフィールドは header フィールドの下に含まれます。 |
{
"Message-ID": " |
| IpPoolId |
string |
任意 |
専用 IP アドレスプールの ID。専用 IP アドレスを購入したユーザーは、このパラメーターを使用して、このメール送信タスクのアウトバウンド IP アドレスを指定できます。 |
e4xxxxxe-4xx0-4xx3-8xxa-74cxxxxx1cef |
| DomainAuth |
boolean |
任意 |
ドメインレベル認証を有効にするかどうかを指定します。 有効な値:
このパラメーターはドメインレベル認証の場合にのみ使用してください。送信元アドレスレベル認証の場合は無視してください。
API シナリオ AccountName をドメイン名に設定します。受信者には domain-auth-created-by-system@example.com が送信者として表示されます。 SMTP シナリオ a. ModifyPWByDomain 操作を呼び出してドメインパスワードを設定します。 b. ドメイン名と設定したパスワードで認証します。user@example.com などのカスタムアドレスを実際の送信者 (mailfrom) として渡します。受信者には user@example.com が送信者として表示されます。 |
true |
| TemplateContent |
object |
任意 |
カスタムメールコンテンツ。事前にテンプレートを作成せずにコンテンツを直接指定できます。このパラメーターまたは TemplateName を指定します。TemplateContent と TemplateName の両方が指定された場合、TemplateName が優先されます。 |
|
| Subject |
string |
任意 |
メールの主題。 |
黑色星期五,专属折扣来袭 |
| HtmlBody |
string |
任意 |
メールの HTML 本文。 注意: HtmlBody と TextBody は異なるタイプのメールコンテンツに使用されます。いずれか一方を指定する必要があります。 新しい SDK では Body を使用してパラメーターを渡し、サイズ制限は約 8 MB です (Java 1.4.0 以降、Python3 1.4.0 以降、PHP 1.4.0 以降)。 |
全场九折,仅限今日 |
| TextBody |
string |
任意 |
メールのプレーンテキスト本文。 注意: HtmlBody と TextBody は異なるタイプのメールコンテンツに使用されます。いずれか一方を指定する必要があります。 新しい SDK では Body を使用してパラメーターを渡し、サイズ制限は約 8 MB です (Java 1.4.0 以降、Python3 1.4.0 以降、PHP 1.4.0 以降)。 |
全场九折,仅限今日 |
| Alias |
string |
任意 |
送信者の表示名。 |
Jackie |
| Receivers |
array<object> |
任意 |
受信者リスト。受信者数は 100 を超えることはできません。このパラメーターまたは ReceiversName を指定します。Receivers と ReceiversName の両方が指定された場合、ReceiversName が優先されます。 例: [{"To":["Jackie@example.com"],"TemplateData":{"UserName":"Jackie"}},{"To":["Tom@example.com"],"TemplateData":{"UserName":"Tom"}}]。 |
|
|
array<object> |
任意 |
カスタム受信者の詳細。 |
||
| To |
array |
任意 |
受信者リスト。このパラメーターは配列タイプです。 |
|
|
string |
任意 |
メールアドレス。 |
Jackie@example.com |
|
| TemplateData |
object |
任意 |
メールテンプレートパラメーター。このパラメーターは JSON マップタイプです。 |
|
|
string |
任意 |
key-value 字符串 |
{"UserName": "Jackie"} |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| EnvId |
string |
イベント ID。 |
xxx |
| RequestId |
string |
リクエスト ID。 |
12D086F6-8F31-4658-84C1-006DED011A85 |
例
成功レスポンス
JSONJSON
{
"EnvId": "xxx",
"RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。