From 99572b2f02d88b092b3cd3e8a628bc4ffec46399 Mon Sep 17 00:00:00 2001
From: xsekiguchi <xsekiguchi.naoya2@contract.dentsusoken.com>
Date: Thu, 19 Feb 2026 22:26:10 +0900
Subject: [PATCH 1/5] =?UTF-8?q?SendGrid:=20Web=20API=20v3=E5=88=A9?=
 =?UTF-8?q?=E7=94=A8=E6=99=82=E3=81=AB=E3=83=9C=E3=83=87=E3=82=A3=E3=83=91?=
 =?UTF-8?q?=E3=83=A9=E3=83=A1=E3=83=BC=E3=82=BF=E3=82=92=E4=B8=8A=E6=9B=B8?=
 =?UTF-8?q?=E3=81=8D=E5=8F=AF=E8=83=BD=E3=81=AB=E3=81=99=E3=82=8B=EF=BC=88?=
 =?UTF-8?q?=E3=83=89=E3=82=AD=E3=83=A5=E3=83=A1=E3=83=B3=E3=83=88=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- ServiceConfig SendGridV3MailService に canOverwriteBodyParameter の説明を追加
- Developer Guide 通知のSendGrid固有オプションの設定に、本文パラメータの設定方法の説明を追加
---
 .../src/docs/asciidoc/notification/mail.adoc         |  8 ++++++--
 .../src/docs/asciidoc/core/mailservice_en.adoc       | 12 ++++++++++++
 .../src/docs/asciidoc/core/mailservice_ja.adoc       | 11 +++++++++++
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/developerguide/src/docs/asciidoc/notification/mail.adoc b/developerguide/src/docs/asciidoc/notification/mail.adoc
index 53cc6a7..2bda70d 100644
--- a/developerguide/src/docs/asciidoc/notification/mail.adoc
+++ b/developerguide/src/docs/asciidoc/notification/mail.adoc
@@ -226,7 +226,10 @@ SendGrid固有オプションは以下の手順で設定します。詳しい実
 ==== 注意事項
 固有オプションを設定する場合、以下の点に注意してください。
 
-* Mail インスタンスに設定されている情報から作成するオプション（例: personalizations, content など）は設定できません。設定した場合、そのオプションは上書きされます。
+* Mail インスタンスに設定されている情報から作成するオプション（例: personalizations, content など）は設定できません。設定した場合、そのオプションは削除されます。
+** 標準の機能では対応できない設定を行いたい場合（ `personalizations[n].substitutions` の設定など ）は、固有オプションを設定する必要がありますが、通常 personalizations, content など特定の固有オプション値は削除されてしまいます。 +
+SendGridV3MailService の `canOverwriteBodyParameter` プロパティを true に設定することで、固有オプションの設定値を削除せずに利用することができます。 +
+SendGridV3MailService の設定の詳細は <<../../serviceconfig/index.adoc#MailService_SendGridV3MailService, MailService - SendGridV3MailService>> を参照してください。
 * 固有オプションを設定した場合、存在の有無にかかわらずSendGridメール送信リクエストのボディに追加されます。
 ** アプリケーションのセキュリティ上のリスク軽減のため、ユーザー入力値を無加工でオプションの値として設定しないでください。
 ** 意図しないオプションが設定されないように、事前にバリデーションを行うことを推奨します。
@@ -274,7 +277,8 @@ private void sendMailWithSendGridOptions() {
             "html", "<strong>This is the footer html.</strong>"
         )
     ));
-    // 上記の指定で、以下のような値が追加されます。
+
+    // 上記の指定で、メール送信時のリクエストボディに以下のような値が追加されます。
     // 
     // {
     //   "asm": {
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
index 57baa9a..ec5aa04 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
@@ -414,6 +414,7 @@ It is similar to the <<SendMailListener>> in MailServiceImpl.
 </service>
 ----
 
+[[MailService_SendGridV3MailService]]
 ==== [.eeonly]#Settings of SendGridV3MailService#
 
 To use SendGrid Web API v3, please specify and configure the SendGridV3MailService.
@@ -428,6 +429,14 @@ To use SendGrid Web API v3, please specify and configure the SendGridV3MailServi
 | listener | <<SendMailListener_s_v3, SendMailListener>>, Multiple | The listener for sending the mail.
 | retryIntervalMillis | long | The retry interval when the transmission fails.(in millisecond)
 | retryCount | int | The number of retry attempts for email transmission to fail.
+| canOverwriteBodyParameter | boolean | Whether to allow overwriting the body parameters in the SendGrid Web API v3 request. The default value is false. +
+The Mail class used in the SendGrid Web API v3 request is SendGridMail. +
+SendGridMail has the putBodyParameter and setBodyParameters methods, which can be used to set API-specific parameters.
+The added specific parameters are added to the body of the SendGrid Web API v3 request. +
+If this parameter is false, the body parameters created from the information set in SendGridMail (e.g., personalizations, content, etc.) will be sanitized if they exist in the added specific parameters. +
+By setting this parameter to true, the specific parameters can be used without sanitization.
+
+In cases where you need to embed different strings in the body or subject for each recipient, and the standard settings cannot handle it, you may consider setting this parameter to true.
 |===
 
 [[HttpClientConfig]]
@@ -484,6 +493,9 @@ It is similar to the <<SendMailListener>> in MailServiceImpl.
 	<!-- The charset of the mail -->
 	<property name="charset" value="UTF-8" />
 
+	<!-- Whether to allow overwriting the body parameters in the SendGrid Web API v3 request -->
+	<property name="canOverwriteBodyParameter" value="false" />
+
 	<!-- ■ for develop only (additional="true") ■ -->
 	<!-- 
 	<property name="listener" class="org.iplass.mtp.mail.listeners.LoggingSendMailListener" additional="true"/>
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
index 1432ad0..865d818 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
@@ -415,6 +415,7 @@ MailServiceImplの<<SendMailListener>>と同様です。
 </service>
 ----
 
+[[MailService_SendGridV3MailService]]
 ==== [.eeonly]#SendGridV3MailServiceの設定#
 
 SendGrid Web API v3を利用する場合、SendGridV3MailServiceを設定します。
@@ -429,6 +430,14 @@ SendGrid Web API v3を利用する場合、SendGridV3MailServiceを設定しま
 | listener | <<SendMailListener_s_v3, SendMailListener>>、複数指定可 | メール送信時のListener。
 | retryIntervalMillis | long | 送信失敗時のリトライ間隔（ミリ秒）。
 | retryCount | int | 送信失敗時のリトライ回数。
+| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メールの本文パラメータを上書き可能とするか。デフォルト値は false です。 +
+SendGrid Web API v3のリクエストで利用する Mail クラスは SendGridMail です。 +
+SendGridMail には putBodyParameter メソッドと setBodyParameters メソッドがあり、これを利用して API 固有パラメータを設定することができます。
+追加した固有パラメータは SendGrid Web API v3 のリクエストのボディに追加されます。 +
+この際、本パラメータが false の場合、SendGridMail に設定されている情報から作成する本文パラメータ（例: personalizations, content など）が、追加した固有パラメータに存在する場合はサニタイズされます。 +
+本パラメータを true に設定することで、特定の固有パラメータをサニタイズせずに優先的に利用します。
+
+宛先ごとに異なる文字列を本文や件名に埋め込んで送信する場合など、標準の設定では対応できない場合に本パラメータを true に設定してください。
 |===
 
 [[HttpClientConfig]]
@@ -486,6 +495,8 @@ MailServiceImplの<<SendMailListener>>と同様です。
 	<!-- メールの文字コード -->
 	<property name="charset" value="UTF-8" />	
 
+	<!-- ボディパラメータを上書き可能とする -->
+	<property name="canOverwriteBodyParameter" value="false" />
 
 	<!-- ■ for develop only (additional="true") ■ -->
 	<!-- 

From 68496cd8cf9d96c8fb8af9f91d162a1464091458 Mon Sep 17 00:00:00 2001
From: xsekiguchi <xsekiguchi.naoya2@contract.dentsusoken.com>
Date: Thu, 19 Feb 2026 22:53:49 +0900
Subject: [PATCH 2/5] =?UTF-8?q?=E8=AA=AC=E6=98=8E=E8=A6=8B=E7=9B=B4?=
 =?UTF-8?q?=E3=81=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 developerguide/src/docs/asciidoc/notification/mail.adoc  | 6 +++---
 serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc | 6 +++---
 serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc | 6 +++---
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/developerguide/src/docs/asciidoc/notification/mail.adoc b/developerguide/src/docs/asciidoc/notification/mail.adoc
index 2bda70d..e7bcde4 100644
--- a/developerguide/src/docs/asciidoc/notification/mail.adoc
+++ b/developerguide/src/docs/asciidoc/notification/mail.adoc
@@ -226,9 +226,9 @@ SendGrid固有オプションは以下の手順で設定します。詳しい実
 ==== 注意事項
 固有オプションを設定する場合、以下の点に注意してください。
 
-* Mail インスタンスに設定されている情報から作成するオプション（例: personalizations, content など）は設定できません。設定した場合、そのオプションは削除されます。
-** 標準の機能では対応できない設定を行いたい場合（ `personalizations[n].substitutions` の設定など ）は、固有オプションを設定する必要がありますが、通常 personalizations, content など特定の固有オプション値は削除されてしまいます。 +
-SendGridV3MailService の `canOverwriteBodyParameter` プロパティを true に設定することで、固有オプションの設定値を削除せずに利用することができます。 +
+* Mail インスタンスに設定されている情報から作成される本文パラメータ（例: `personalizations`, `content` など）と同名の SendGrid 固有オプション値を設定した場合、Mail インスタンスから生成される本文パラメータが優先され、同名で追加した固有オプション値はサニタイズ（無効化）されます。
+** 標準の機能では対応できない設定を行いたい場合（例: `personalizations[n].substitutions` の設定など）には固有オプションを利用しますが、デフォルトでは `personalizations`, `content` など既存の本文パラメータと衝突する特定の固有オプション値はサニタイズされ、メール送信リクエストには反映されません。 +
+SendGridV3MailService の `canOverwriteBodyParameter` プロパティを `true` に設定すると、これらの固有オプション値はサニタイズされず、固有オプションで指定した値で既存の本文パラメータを上書きできるようになります。 +
 SendGridV3MailService の設定の詳細は <<../../serviceconfig/index.adoc#MailService_SendGridV3MailService, MailService - SendGridV3MailService>> を参照してください。
 * 固有オプションを設定した場合、存在の有無にかかわらずSendGridメール送信リクエストのボディに追加されます。
 ** アプリケーションのセキュリティ上のリスク軽減のため、ユーザー入力値を無加工でオプションの値として設定しないでください。
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
index ec5aa04..ce066b7 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
@@ -429,12 +429,12 @@ To use SendGrid Web API v3, please specify and configure the SendGridV3MailServi
 | listener | <<SendMailListener_s_v3, SendMailListener>>, Multiple | The listener for sending the mail.
 | retryIntervalMillis | long | The retry interval when the transmission fails.(in millisecond)
 | retryCount | int | The number of retry attempts for email transmission to fail.
-| canOverwriteBodyParameter | boolean | Whether to allow overwriting the body parameters in the SendGrid Web API v3 request. The default value is false. +
+| canOverwriteBodyParameter | boolean | Whether to allow API-specific body parameters to overwrite conflicting body parameters (such as personalizations, content, etc.) generated from the Mail settings in the SendGrid Web API v3 request. The default value is false. +
 The Mail class used in the SendGrid Web API v3 request is SendGridMail. +
 SendGridMail has the putBodyParameter and setBodyParameters methods, which can be used to set API-specific parameters.
 The added specific parameters are added to the body of the SendGrid Web API v3 request. +
-If this parameter is false, the body parameters created from the information set in SendGridMail (e.g., personalizations, content, etc.) will be sanitized if they exist in the added specific parameters. +
-By setting this parameter to true, the specific parameters can be used without sanitization.
+If this parameter is false, then when an added specific parameter has the same key as a body parameter created from the information set in SendGridMail (e.g., personalizations, content, etc.), the original body parameter value is kept and the conflicting specific parameter value is sanitized. +
+By setting this parameter to true, in such key conflicts the values of the specific parameters are used as-is (without sanitization), and they overwrite the existing conflicting body parameters.
 
 In cases where you need to embed different strings in the body or subject for each recipient, and the standard settings cannot handle it, you may consider setting this parameter to true.
 |===
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
index 865d818..4a38093 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
@@ -430,12 +430,12 @@ SendGrid Web API v3を利用する場合、SendGridV3MailServiceを設定しま
 | listener | <<SendMailListener_s_v3, SendMailListener>>、複数指定可 | メール送信時のListener。
 | retryIntervalMillis | long | 送信失敗時のリトライ間隔（ミリ秒）。
 | retryCount | int | 送信失敗時のリトライ回数。
-| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メールの本文パラメータを上書き可能とするか。デフォルト値は false です。 +
+| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メール設定から生成される競合するボディパラメータ（例: personalizations, content など）をAPI固有のボディパラメータで上書きするかどうかを指定します。デフォルト値は false です。 +
 SendGrid Web API v3のリクエストで利用する Mail クラスは SendGridMail です。 +
 SendGridMail には putBodyParameter メソッドと setBodyParameters メソッドがあり、これを利用して API 固有パラメータを設定することができます。
 追加した固有パラメータは SendGrid Web API v3 のリクエストのボディに追加されます。 +
-この際、本パラメータが false の場合、SendGridMail に設定されている情報から作成する本文パラメータ（例: personalizations, content など）が、追加した固有パラメータに存在する場合はサニタイズされます。 +
-本パラメータを true に設定することで、特定の固有パラメータをサニタイズせずに優先的に利用します。
+この際、本パラメータが false の場合、追加した固有パラメータのうち、SendGridMail に設定されている情報から作成される本文パラメータ（例: personalizations, content など）と同名のものはサニタイズされ、SendGridMail から生成された本文パラメータ側が優先されます。 +
+本パラメータを true に設定すると、これら同名の追加した固有パラメータはサニタイズされずに優先的に利用され、SendGridMail から生成される本文パラメータを上書きします。
 
 宛先ごとに異なる文字列を本文や件名に埋め込んで送信する場合など、標準の設定では対応できない場合に本パラメータを true に設定してください。
 |===

From 65f794d5abd06759db19ce6ae702f1b2c5338d69 Mon Sep 17 00:00:00 2001
From: xsekiguchi <xsekiguchi.naoya2@contract.dentsusoken.com>
Date: Fri, 20 Feb 2026 10:13:59 +0900
Subject: [PATCH 3/5] =?UTF-8?q?=E8=A8=AD=E5=AE=9A=E5=A4=89=E6=9B=B4?=
 =?UTF-8?q?=E3=81=AB=E3=82=88=E3=82=8B=E5=AE=9F=E8=A1=8C=E7=B5=90=E6=9E=9C?=
 =?UTF-8?q?=E3=81=AE=E4=BE=8B=E3=82=92=E8=A8=98=E8=BC=89=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/docs/asciidoc/notification/mail.adoc  | 70 ++++++++++++++++++-
 .../docs/asciidoc/core/mailservice_en.adoc    | 12 ++--
 .../docs/asciidoc/core/mailservice_ja.adoc    | 12 ++--
 3 files changed, 79 insertions(+), 15 deletions(-)

diff --git a/developerguide/src/docs/asciidoc/notification/mail.adoc b/developerguide/src/docs/asciidoc/notification/mail.adoc
index e7bcde4..e16572a 100644
--- a/developerguide/src/docs/asciidoc/notification/mail.adoc
+++ b/developerguide/src/docs/asciidoc/notification/mail.adoc
@@ -227,9 +227,9 @@ SendGrid固有オプションは以下の手順で設定します。詳しい実
 固有オプションを設定する場合、以下の点に注意してください。
 
 * Mail インスタンスに設定されている情報から作成される本文パラメータ（例: `personalizations`, `content` など）と同名の SendGrid 固有オプション値を設定した場合、Mail インスタンスから生成される本文パラメータが優先され、同名で追加した固有オプション値はサニタイズ（無効化）されます。
-** 標準の機能では対応できない設定を行いたい場合（例: `personalizations[n].substitutions` の設定など）には固有オプションを利用しますが、デフォルトでは `personalizations`, `content` など既存の本文パラメータと衝突する特定の固有オプション値はサニタイズされ、メール送信リクエストには反映されません。 +
-SendGridV3MailService の `canOverwriteBodyParameter` プロパティを `true` に設定すると、これらの固有オプション値はサニタイズされず、固有オプションで指定した値で既存の本文パラメータを上書きできるようになります。 +
-SendGridV3MailService の設定の詳細は <<../../serviceconfig/index.adoc#MailService_SendGridV3MailService, MailService - SendGridV3MailService>> を参照してください。
+** 標準の機能では対応できない設定を行いたい場合は固有オプションを利用しますが、デフォルトでは `personalizations`, `content` など既存の本文パラメータと衝突する特定の固有オプション値はサニタイズされ、メール送信リクエストには反映されません。 +
+メール送信リクエストには反映したい場合は SendGridV3MailService の `canOverwriteBodyParameter` プロパティを `true` に設定することで、これらの固有オプション値はサニタイズされず、固有オプションで指定した値で既存の本文パラメータを上書きできるようになります。 +
+実装と結果については、後述の「<<mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example>>」を参照してください。
 * 固有オプションを設定した場合、存在の有無にかかわらずSendGridメール送信リクエストのボディに追加されます。
 ** アプリケーションのセキュリティ上のリスク軽減のため、ユーザー入力値を無加工でオプションの値として設定しないでください。
 ** 意図しないオプションが設定されないように、事前にバリデーションを行うことを推奨します。
@@ -298,3 +298,67 @@ private void sendMailWithSendGridOptions() {
     manager.sendMail(sendGridMail);
 }
 ----
+
+[[mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example]]
+==== SendGridV3MailService のプロパティ canOverwriteBodyParameter 設定による動作の変化
+SendGridV3MailService のプロパティ `canOverwriteBodyParameter` の設定によって、優先する項目を制御できます。 +
+`false` に設定した場合、Mail オブジェクトから生成される本文パラメータが優先され、同名の固有オプション値はサニタイズされます。 +
+`true` に設定した場合、Mail オブジェクトから生成される本文パラメータを SendGrid 固有オプションで上書きできます。
+
+ServiceConfig SendGridV3MailService の設定の詳細は <<../../serviceconfig/index.adoc#MailService_SendGridV3MailService, MailService - SendGridV3MailService>> を参照してください。
+
+[source,java]
+----
+import org.iplass.mtp.mail.Mail;
+import org.iplass.mtp.mail.MailManager;
+import org.iplass.mtp.mail.sendgrid.SendGridMail;
+
+private void sendMailWithSendGridOptions() {
+    MailManager manager = ManagerLocator.manager(MailManager.class);
+
+    Mail mail = manager.createMail();;
+
+    // mail に対して、送信先等を設定する
+    // :
+    // :
+    // <a> Mail オブジェクトに本文を設定する
+	mail.setMessage("これは本文です");
+
+    // Mail オブジェクトを SendGridMail にキャスト
+    SendGridMail sendGridMail = (SendGridMail)mail;
+
+    // <b> SendGrid固有オプションのとして content を設定する
+    sendGridMail.putBodyParameter("content", List.of(Map.of(
+        "type", "text/plain",
+        "value", "SendGrid固有オプションで設定した本文です"
+    )));
+
+    // 上記の実装で canOverwriteBodyParameter の設定により、SendGrid API実行時のリクエストボディは以下のように変化します。
+    // 
+    // ＜ デフォルトの設定（canOverwriteBodyParameter = false）の場合 ＞
+    // <a> で設定した Mail オブジェクトから生成される content パラメータが優先されます。<b> で設定した同名の固有オプションの値はサニタイズされます。
+    // 
+    // {
+    //   "content": [
+    //     {
+    //       "type": "text/plain",
+    //       "value": "これは本文です"
+    //     }
+    //   ]
+    // }
+
+    // ＜ canOverwriteBodyParameter を true に設定した場合 ＞
+    // <a> で設定した Mail オブジェクトから生成される content パラメータが上書きされ、<b> で設定した固有オプションの値が利用されます。
+    //
+    // {
+    //   "content": [
+    //     {
+    //       "type": "text/plain",
+    //       "value": "SendGrid固有オプションで設定した本文です"
+    //     }
+    //   ]
+    // }
+
+    manager.sendMail(sendGridMail);
+}
+----
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
index ce066b7..3a50caa 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
@@ -429,14 +429,14 @@ To use SendGrid Web API v3, please specify and configure the SendGridV3MailServi
 | listener | <<SendMailListener_s_v3, SendMailListener>>, Multiple | The listener for sending the mail.
 | retryIntervalMillis | long | The retry interval when the transmission fails.(in millisecond)
 | retryCount | int | The number of retry attempts for email transmission to fail.
-| canOverwriteBodyParameter | boolean | Whether to allow API-specific body parameters to overwrite conflicting body parameters (such as personalizations, content, etc.) generated from the Mail settings in the SendGrid Web API v3 request. The default value is false. +
+| canOverwriteBodyParameter | boolean | Whether to overwrite conflicting body parameters (such as personalizations, content, etc.) generated from the Mail settings in the SendGrid Web API v3 request with custom option parameters. The default value is `false`. +
 The Mail class used in the SendGrid Web API v3 request is SendGridMail. +
-SendGridMail has the putBodyParameter and setBodyParameters methods, which can be used to set API-specific parameters.
-The added specific parameters are added to the body of the SendGrid Web API v3 request. +
-If this parameter is false, then when an added specific parameter has the same key as a body parameter created from the information set in SendGridMail (e.g., personalizations, content, etc.), the original body parameter value is kept and the conflicting specific parameter value is sanitized. +
-By setting this parameter to true, in such key conflicts the values of the specific parameters are used as-is (without sanitization), and they overwrite the existing conflicting body parameters.
+SendGridMail has the putBodyParameter and setBodyParameters methods, which can be used to set custom option parameters.
+The added custom option parameters are added to the body of the SendGrid Web API v3 request. +
+If this parameter is false, then when an added custom option parameter has the same key as a body parameter created from the information set in SendGridMail (e.g., personalizations, content, etc.), the original body parameter value is kept and the conflicting custom option parameter value is sanitized. +
+By setting this parameter to true, in such key conflicts the values of the custom option parameters are used as-is (without sanitization), and they overwrite the existing conflicting body parameters.
 
-In cases where you need to embed different strings in the body or subject for each recipient, and the standard settings cannot handle it, you may consider setting this parameter to true.
+Also refer to the behavior <<../developerguide/notification/index.adoc#mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example, changes caused by the canOverwriteBodyParameter setting in the SendGridV3MailService properties>>.
 |===
 
 [[HttpClientConfig]]
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
index 4a38093..4a41dbf 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
@@ -430,14 +430,14 @@ SendGrid Web API v3を利用する場合、SendGridV3MailServiceを設定しま
 | listener | <<SendMailListener_s_v3, SendMailListener>>、複数指定可 | メール送信時のListener。
 | retryIntervalMillis | long | 送信失敗時のリトライ間隔（ミリ秒）。
 | retryCount | int | 送信失敗時のリトライ回数。
-| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メール設定から生成される競合するボディパラメータ（例: personalizations, content など）をAPI固有のボディパラメータで上書きするかどうかを指定します。デフォルト値は false です。 +
+| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メール設定から生成される競合するボディパラメータ（例: personalizations, content など）を固有オプションパラメータで上書きするかを設定します。デフォルト値は `false` です。 +
 SendGrid Web API v3のリクエストで利用する Mail クラスは SendGridMail です。 +
-SendGridMail には putBodyParameter メソッドと setBodyParameters メソッドがあり、これを利用して API 固有パラメータを設定することができます。
-追加した固有パラメータは SendGrid Web API v3 のリクエストのボディに追加されます。 +
-この際、本パラメータが false の場合、追加した固有パラメータのうち、SendGridMail に設定されている情報から作成される本文パラメータ（例: personalizations, content など）と同名のものはサニタイズされ、SendGridMail から生成された本文パラメータ側が優先されます。 +
-本パラメータを true に設定すると、これら同名の追加した固有パラメータはサニタイズされずに優先的に利用され、SendGridMail から生成される本文パラメータを上書きします。
+SendGridMail には putBodyParameter メソッドと setBodyParameters メソッドがあり、これを利用して固有オプションパラメータを設定することができます。
+追加した固有オプションパラメータは SendGrid Web API v3 のリクエストのボディに追加されます。 +
+この際、本パラメータが false の場合、追加した固有オプションパラメータのうち、SendGridMail に設定されている情報から作成される本文パラメータ（例: personalizations, content など）と同名のものはサニタイズされ、SendGridMail から生成された本文パラメータ側が優先されます。 +
+本パラメータを true に設定すると、これら同名の追加した固有オプションパラメータはサニタイズされずに優先的に利用され、SendGridMail から生成される本文パラメータを上書きします。
 
-宛先ごとに異なる文字列を本文や件名に埋め込んで送信する場合など、標準の設定では対応できない場合に本パラメータを true に設定してください。
+<<../developerguide/notification/index.adoc#mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example, SendGridV3MailService のプロパティ canOverwriteBodyParameter 設定による動作の変化>>も参照してください。
 |===
 
 [[HttpClientConfig]]

From 8612e86ece01e2c10f7945a0311072aea954d6ed Mon Sep 17 00:00:00 2001
From: xsekiguchi <xsekiguchi.naoya2@contract.dentsusoken.com>
Date: Fri, 20 Feb 2026 10:23:51 +0900
Subject: [PATCH 4/5] fix typo

---
 developerguide/src/docs/asciidoc/notification/mail.adoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/developerguide/src/docs/asciidoc/notification/mail.adoc b/developerguide/src/docs/asciidoc/notification/mail.adoc
index e16572a..3587fb5 100644
--- a/developerguide/src/docs/asciidoc/notification/mail.adoc
+++ b/developerguide/src/docs/asciidoc/notification/mail.adoc
@@ -316,7 +316,7 @@ import org.iplass.mtp.mail.sendgrid.SendGridMail;
 private void sendMailWithSendGridOptions() {
     MailManager manager = ManagerLocator.manager(MailManager.class);
 
-    Mail mail = manager.createMail();;
+    Mail mail = manager.createMail();
 
     // mail に対して、送信先等を設定する
     // :
@@ -327,7 +327,7 @@ private void sendMailWithSendGridOptions() {
     // Mail オブジェクトを SendGridMail にキャスト
     SendGridMail sendGridMail = (SendGridMail)mail;
 
-    // <b> SendGrid固有オプションのとして content を設定する
+    // <b> SendGrid固有オプションとして content を設定する
     sendGridMail.putBodyParameter("content", List.of(Map.of(
         "type", "text/plain",
         "value", "SendGrid固有オプションで設定した本文です"

From 87f9ebf54f0044f323d4f94dd9aca94eb515ba1a Mon Sep 17 00:00:00 2001
From: xsekiguchi <xsekiguchi.naoya2@contract.dentsusoken.com>
Date: Tue, 24 Feb 2026 09:45:46 +0900
Subject: [PATCH 5/5] =?UTF-8?q?=E3=83=AC=E3=83=93=E3=83=A5=E3=83=BC?=
 =?UTF-8?q?=E6=8C=87=E6=91=98=E4=BF=AE=E6=AD=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 文言の不備修正
- コードブロックの統一
---
 developerguide/src/docs/asciidoc/notification/mail.adoc  | 2 +-
 serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc | 6 +++---
 serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc | 6 +++---
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/developerguide/src/docs/asciidoc/notification/mail.adoc b/developerguide/src/docs/asciidoc/notification/mail.adoc
index 3587fb5..0a1a7a9 100644
--- a/developerguide/src/docs/asciidoc/notification/mail.adoc
+++ b/developerguide/src/docs/asciidoc/notification/mail.adoc
@@ -228,7 +228,7 @@ SendGrid固有オプションは以下の手順で設定します。詳しい実
 
 * Mail インスタンスに設定されている情報から作成される本文パラメータ（例: `personalizations`, `content` など）と同名の SendGrid 固有オプション値を設定した場合、Mail インスタンスから生成される本文パラメータが優先され、同名で追加した固有オプション値はサニタイズ（無効化）されます。
 ** 標準の機能では対応できない設定を行いたい場合は固有オプションを利用しますが、デフォルトでは `personalizations`, `content` など既存の本文パラメータと衝突する特定の固有オプション値はサニタイズされ、メール送信リクエストには反映されません。 +
-メール送信リクエストには反映したい場合は SendGridV3MailService の `canOverwriteBodyParameter` プロパティを `true` に設定することで、これらの固有オプション値はサニタイズされず、固有オプションで指定した値で既存の本文パラメータを上書きできるようになります。 +
+メール送信リクエストに反映したい場合は SendGridV3MailService の `canOverwriteBodyParameter` プロパティを `true` に設定することで、これらの固有オプション値はサニタイズされず、固有オプションで指定した値で既存の本文パラメータを上書きできるようになります。 +
 実装と結果については、後述の「<<mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example>>」を参照してください。
 * 固有オプションを設定した場合、存在の有無にかかわらずSendGridメール送信リクエストのボディに追加されます。
 ** アプリケーションのセキュリティ上のリスク軽減のため、ユーザー入力値を無加工でオプションの値として設定しないでください。
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
index 3a50caa..87217fc 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_en.adoc
@@ -429,12 +429,12 @@ To use SendGrid Web API v3, please specify and configure the SendGridV3MailServi
 | listener | <<SendMailListener_s_v3, SendMailListener>>, Multiple | The listener for sending the mail.
 | retryIntervalMillis | long | The retry interval when the transmission fails.(in millisecond)
 | retryCount | int | The number of retry attempts for email transmission to fail.
-| canOverwriteBodyParameter | boolean | Whether to overwrite conflicting body parameters (such as personalizations, content, etc.) generated from the Mail settings in the SendGrid Web API v3 request with custom option parameters. The default value is `false`. +
+| canOverwriteBodyParameter | boolean | Whether to overwrite conflicting body parameters (such as `personalizations`, `content`, etc.) generated from the Mail settings in the SendGrid Web API v3 request with custom option parameters. The default value is `false`. +
 The Mail class used in the SendGrid Web API v3 request is SendGridMail. +
 SendGridMail has the putBodyParameter and setBodyParameters methods, which can be used to set custom option parameters.
 The added custom option parameters are added to the body of the SendGrid Web API v3 request. +
-If this parameter is false, then when an added custom option parameter has the same key as a body parameter created from the information set in SendGridMail (e.g., personalizations, content, etc.), the original body parameter value is kept and the conflicting custom option parameter value is sanitized. +
-By setting this parameter to true, in such key conflicts the values of the custom option parameters are used as-is (without sanitization), and they overwrite the existing conflicting body parameters.
+If this parameter is `false`, then when an added custom option parameter has the same key as a body parameter created from the information set in SendGridMail (e.g., `personalizations`, `content`, etc.), the original body parameter value is kept and the conflicting custom option parameter value is sanitized. +
+By setting this parameter to `true`, in such key conflicts the values of the custom option parameters are used as-is (without sanitization), and they overwrite the existing conflicting body parameters.
 
 Also refer to the behavior <<../developerguide/notification/index.adoc#mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example, changes caused by the canOverwriteBodyParameter setting in the SendGridV3MailService properties>>.
 |===
diff --git a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
index 4a41dbf..627cfaf 100644
--- a/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
+++ b/serviceconfig/src/docs/asciidoc/core/mailservice_ja.adoc
@@ -430,12 +430,12 @@ SendGrid Web API v3を利用する場合、SendGridV3MailServiceを設定しま
 | listener | <<SendMailListener_s_v3, SendMailListener>>、複数指定可 | メール送信時のListener。
 | retryIntervalMillis | long | 送信失敗時のリトライ間隔（ミリ秒）。
 | retryCount | int | 送信失敗時のリトライ回数。
-| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メール設定から生成される競合するボディパラメータ（例: personalizations, content など）を固有オプションパラメータで上書きするかを設定します。デフォルト値は `false` です。 +
+| canOverwriteBodyParameter | boolean | SendGrid Web API v3のリクエストで、メール設定から生成される競合するボディパラメータ（例: `personalizations`, `content` など）を固有オプションパラメータで上書きするかを設定します。デフォルト値は `false` です。 +
 SendGrid Web API v3のリクエストで利用する Mail クラスは SendGridMail です。 +
 SendGridMail には putBodyParameter メソッドと setBodyParameters メソッドがあり、これを利用して固有オプションパラメータを設定することができます。
 追加した固有オプションパラメータは SendGrid Web API v3 のリクエストのボディに追加されます。 +
-この際、本パラメータが false の場合、追加した固有オプションパラメータのうち、SendGridMail に設定されている情報から作成される本文パラメータ（例: personalizations, content など）と同名のものはサニタイズされ、SendGridMail から生成された本文パラメータ側が優先されます。 +
-本パラメータを true に設定すると、これら同名の追加した固有オプションパラメータはサニタイズされずに優先的に利用され、SendGridMail から生成される本文パラメータを上書きします。
+この際、本パラメータが `false` の場合、追加した固有オプションパラメータのうち、SendGridMail に設定されている情報から作成される本文パラメータ（例: `personalizations`, `content` など）と同名のものはサニタイズされ、SendGridMail から生成された本文パラメータ側が優先されます。 +
+本パラメータを `true` に設定すると、これら同名の追加した固有オプションパラメータはサニタイズされずに優先的に利用され、SendGridMail から生成される本文パラメータを上書きします。
 
 <<../developerguide/notification/index.adoc#mail_configure_SendGridV3MailService_canOverwriteBodyParameter_example, SendGridV3MailService のプロパティ canOverwriteBodyParameter 設定による動作の変化>>も参照してください。
 |===