ShinobiLayer: SendGridでClick TrackingやOpen Trackingを無効にする方法（Web API）

はじめに

SendGrid初心者のための注意点（SoftLayer版） にて紹介したように、SendGridはどのパッケージを選択するかによって、デフォルトの送信オプションが異なります。特に注意するべき項目は、Click TrackingやOpen Trackingです。詳細は先述のリンクをご確認下さい。
ここでは、直接SendGridに対してWeb APIを実行する際の回避策を提示します。

Web APIを使ったClick TrackingやOpen Trackingの切り替え方法

SendGridは、API実行時にx-smtpapiヘッダを使って、メール送信時にClick Tracking/Open Trackingを無効にすることが可能です。以下はcurlを使ったメール配信の実行例です。

通常の送信方法例

# curl -v \
-F to=宛先のメールアドレス \
-F toname=test \
-F subject="Advanced Package - default" \
-F html="This is test. <a href="http://www.yahoo.co.jp">This is html body.</a>" \
-F from=[e-mail] \
-F api_user=SendGridのアカウントID \
-F api_key=SendGridのアカウントパスワード \
https://api.sendgrid.com/api/mail.send.json

ClickTrackingとOpenTrackingを無効にするため、x-smtpapiを使用

# curl -v \
-F to=宛先のメールアドレス \
-F toname=test \
-F subject="Advanced Package with clicktrack disabled" \
-F html="This is test. <a href="http://www.yahoo.co.jp">This is html body.</a>" \
-F from=[e-mail] \
-F api_user=SendGridのアカウントID \
-F api_key=SendGridのアカウントパスワード \
-F x-smtpapi='{ "filters": { "clicktrack": { "settings": {"enable": 0 }}, "opentrack": { "settings": {"enable": 0 }}}}' \
https://api.sendgrid.com/api/mail.send.json

参考URL:
https://sendgrid.kke.co.jp/docs/API_Reference/Web_API_v3/index.html