:SingleSendMail

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

アドレスタイプです。有効な値は以下のとおりです。

0：ランダムアカウント

1：送信元アドレス

Direct Mail コンソールで作成したメールタグです。メールタグを使用して、メールのバッチを分類し、各バッチの送信状況をクエリできます。メールトラッキングが有効になっている場合、メールタグを指定する必要があります。 タグの長さは 1～128 文字で、英数字、アンダースコア (_)、ハイフン (-) を使用できます。

コンソールで設定した返信先アドレスを使用するかどうかを指定します。返信先アドレスは事前に認証済みである必要があります。有効な値は true および false です。

宛先アドレスです。複数のアドレスを指定する場合は、カンマ (,) で区切ります。最大 100 個のアドレスを指定できます。受信者グループもサポートされています。

メールの件名です。件名の長さは 256 文字以内である必要があります。

メールの HTML 本文です。

注：HtmlBody または TextBody のいずれかを指定してください。

• URL で渡されるパラメーターのサイズは、約 80 KB に制限されています。

• 最新の SDK では、本文パラメーターのサイズが約 8 MB に制限されています（Java 1.4.0 以降、Python 3 1.4.0 以降、PHP 1.4.0 以降）。

メールのテキスト本文です。

注：HtmlBody または TextBody のいずれかを指定してください。

• URL で渡されるパラメーターのサイズは、約 80 KB に制限されています。

• 最新の SDK では、本文パラメーターのサイズが約 8 MB に制限されています（Java 1.4.0 以降、Python 3 1.4.0 以降、PHP 1.4.0 以降）。

送信者のニックネームです。ニックネームは 15 文字未満である必要があります。

たとえば、ニックネームを「小紅」と設定し、送信元アドレスを test***@example.net とした場合、受信者側には「小紅」<test***@example.net> として表示されます。

返信先アドレスです。

返信先アドレスのニックネームです。

1：データ追跡を有効にします。

0（デフォルト）：データ追跡を無効にします。

disabled：リンクを生成しません。

default：デフォルトポリシーを使用します。「gmail」「yahoo」「google」「aol.com」「hotmail」「outlook」「ymail.com」などの特定のドメインを含むバッチメールに対して、登録解除リンクが自動的に生成されます。詳細については、「登録解除リンクの生成とフィルタリングメカニズム」をご参照ください。

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

「outlook」、または「ymail.com」。詳細については、「配信停止リンクの生成およびフィルタリングメカニズム」をご参照ください。

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

フィルタリングレベルです。詳細については、「登録解除リンクの生成とフィルタリングメカニズム」をご参照ください。

disabled：フィルタリングを行いません。

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

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

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

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

メッセージヘッダーの設定です。

標準フィールドおよび非標準フィールドのいずれも、メッセージヘッダーの構文ルールに従う必要があります。API では、headers フィールドに最大 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 イベントバスおよび Message Service MNS にプッシュされ、API および SMTP の両方でサポートされています。）

EventBridge または MNS にプッシュされる際、これらのフィールドは header フィールド内に表示されます。

専用 IP アドレスプールの ID です。専用 IP アドレスを購入している場合、このパラメーターを使用して現在のメールの送信元 IP アドレスを指定します。詳細については、「専用 IP」をご参照ください。

• ブラインドカーボンコピー（BCC）受信者のリストです。

• 各 BCC アドレスにメールのコピーが送信されます。BCC 情報は ToAddress フィールドおよび BccAddress フィールドのすべての受信者に対して非表示になります。

• BCC 受信者のプライバシー保護のため、BCC 宛てのメールに対してはメールトラッキングがデフォルトで無効になります。つまり、開封率やクリック率などの行動データは BCC メールでは記録されません。ただし、課金、送信詳細、送信ステータス統計は通常のメールと同様です。

• 各メールにつき、最大 2 人の BCC 受信者を指定できます。

ドメインレベルの認証を有効にします。

• 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. ドメインと設定したパスワードを使用して認証します。実際の送信元アドレスとして、`mailfrom` フィールドに `user@example.com` のようなカスタムアドレスを渡します。受信者側には `user@example.com` として表示されます。