Direct Mail:SingleSendMail

Direct Mail コンソールで設定された送信元アドレス。

アドレスタイプ。有効値：

0：ランダムアカウント。

1：送信元アドレス。

メールバッチを分類するためのタグ。Direct Mail コンソールで作成できます。メールトラッキングを有効にする場合、タグは必須です。タグは 1～128 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。

コンソールで設定されたデフォルトの返信先アドレスを使用するかどうかを指定します。このアドレスは検証済みである必要があります。有効値：true、false。

宛先メールアドレス。複数のアドレスを指定する場合は、カンマで区切ります (最大 100 件)。

メールの件名。最大長は 256 文字です。

HTML 形式のメール本文。

注：HtmlBody または TextBody のいずれかを指定する必要があります。

• URL パラメーターとして渡す場合、本文のサイズは約 80 KB に制限されます。

• 最近の SDK (Java 1.4.0 以降、Python 3 1.4.0 以降、および PHP 1.4.0 以降) の場合、リクエストボディは約 8 MB に制限されます。

テキスト形式のメール本文。

注：HtmlBody または TextBody のいずれかを指定する必要があります。

• URL パラメーターとして渡す場合、本文のサイズは約 80 KB に制限されます。

• 最近の SDK (Java 1.4.0 以降、Python 3 1.4.0 以降、および PHP 1.4.0 以降) の場合、リクエストボディは約 8 MB に制限されます。

送信者名。15 文字以下である必要があります。

たとえば、送信者名を「田中」に設定し、送信元アドレスが test***@example.net の場合、受信者には送信者が「田中」 <test***@example.net> と表示されます。

返信先アドレス。

返信先アドレスとして表示される名前。

クリックトラッキングを有効にするかどうかを指定します。有効値："1" はクリックトラッキングを有効にし、"0" は無効にします (デフォルト)。

disabled：登録解除リンクを生成しません。

default：デフォルトポリシーを使用します。バッチ送信元アドレスの場合、「gmail」、「yahoo」、

「google」、「aol.com」、「hotmail」、

「outlook」、「ymail.com」などのキーワードを含む特定のドメインに送信する際に、登録解除リンクが生成されます。詳細については、「登録解除リンクの生成とフィルタリングの仕組み」をご参照ください。

表示言語は、受信者のブラウザ設定に基づいて自動的に決定されます。

フィルタリングレベル。詳細については、「登録解除リンクの生成とフィルタリングの仕組み」をご参照ください。

disabled：フィルタリングなし。

default：デフォルトポリシーを使用します。バッチアドレスの場合、フィルタリングは送信元アドレスレベルで適用されます。

mailfrom：送信元アドレスレベルでフィルタリングします。

mailfrom_domain：送信元ドメインレベルでフィルタリングします。

edm_id：アカウントレベルでフィルタリングします。

カスタムメールヘッダーの設定。

標準フィールドと非標準フィールドの両方が、標準ヘッダー構文に準拠している必要があります。1 回の API 呼び出しで最大 10 個のヘッダーを指定できます。超過したヘッダーは無視されます。この制限は SMTP には適用されません。

1. 標準フィールド

Message-ID、List-Unsubscribe、List-Unsubscribe-Post

標準フィールドは、メールヘッダー内の既存の値を上書きします。

2. 非標準フィールド

大文字と小文字は区別されません。

a. X-User- で始まるフィールド：これらは EventBridge または Message Service (MNS) にプッシュされません。このプレフィックスは API 呼び出しでのみ必要であり、SMTP では必要ありません。

b. X-User-Notify- で始まるフィールド：これらは EventBridge と MNS にプッシュされます。これは API と SMTP の両方の呼び出しでサポートされています。

EventBridge または MNS にプッシュされると、ヘッダーオブジェクトにこれらのフィールドが含まれます。

専用 IP プールの ID。専用 IP を購入している場合、このパラメーターを使用して、メール送信に使用する専用 IP プールを選択できます。詳細については、「専用 IP」をご参照ください。

• カンマ区切りの BCC 受信者のリスト。

• システムは各 BCC 受信者にメールのコピーを送信します。BCC の情報は、ToAddress および BccAddress で指定された受信者を含むすべての受信者から隠されます。

• プライバシー保護のため、BCC 受信者に送信されるメールでは、メールトラッキング機能 (開封トラッキングやクリックトラッキングなど) は無効になります。ただし、課金と送信ステータスは引き続き追跡されます。

• リクエストごとに最大 2 人の BCC 受信者が許可されます。

注：SingleSendMail API オペレーションは CC フィールドをサポートしていません。カーボンコピー (CC) を送信するには、SMTP を使用してください。

ドメインレベルの認証を有効にするかどうかを指定します。

• true

• false

このパラメーターはドメインレベルの認証にのみ使用されます。送信元アドレスレベルの認証の場合は無視してください。

1. コンソールでアドレス domain-auth-created-by-system@example.com を作成します。プレフィックスは固定で、サフィックスはご利用のドメインである必要があります。

2.

API シナリオ

AccountName をご利用のドメインに設定します。受信者には送信者が domain-auth-created-by-system@example.com と表示されます。

SMTP シナリオ

a. ModifyPWByDomain API オペレーションを呼び出して、ドメインのパスワードを設定します。

b. ドメインと設定したパスワードで認証します。MAIL FROM コマンドで、実際の送信者として user@example.com などのカスタムアドレスを渡します。受信者には送信者が user@example.com と表示されます。