> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# メールアドレス検証
> CSVインポート中および一括でメールアドレスを検証し、バウンスを減らして送信者の評判を守ります。
メールアドレス検証は、メールアドレスが受信者に届く前に一般的な問題を検出します。バウンス率を高めたり送信者の評判を傷つけたりする可能性のある、タイプミス、無効なドメイン、ロールベースのアドレス、使い捨てメールサービスをフラグします。
CSVインポート中に自動的に実行され、既存の受信者リストに対する一括検証ツールとしても使用できます。
メールアドレス検証はOneSignalの検証基準に基づいてアドレスを確認します。これはリアルタイムのバウンス検証チェックではなく、配信可能性を保証するものではありません。
## 検証チェック
メールアドレス検証は、次のチェックに対して各アドレスを評価します：
| チェック | 検出内容 |
| -------------- | ---------------------------------------------- |
| **構文検証** | 必須コンポーネントが欠けている不正な形式のアドレス（例：`@`の欠如、無効なTLD） |
| **タイプミス検出** | `gnail.com`や`gmail.con`などの一般的なドメインのスペルミス |
| **MXレコード確認** | 有効なメール交換レコードがないドメイン；ここに送信されたメールは配信不可 |
| **ロールベースアドレス** | 個人のものである可能性が低い`sales@`、`info@`、`admin@`などのアドレス |
| **使い捨てメール** | 一時または使い捨てメールサービスに関連するドメイン |
**無料プラン**には構文検証とタイプミス検出が含まれます。**有料プラン**には上記すべてに加え、MXレコード確認、ロールベースアドレス検出、使い捨てメールフィルタリングが含まれます。
アドレスがチェックに失敗した場合、メールアドレス検証は特定の問題を説明する人が読めるエラーを返します。アドレスが複数のチェックに失敗した場合、すべての失敗理由が一緒に返されるので、一度にすべてに対処できます。
***
## CSVインポート中のアドレス検証
CSVをインポートする際、インポートを確認する前に**レビュー**ステップでメールアドレス検証設定を構成できます。
**Audience > Import**に移動してファイルをアップロードします。**Upload**と**Map Fields**ステップを完了します。無効なメールアドレスが検出された場合、**Map Fields**ステップに警告が表示されます。
**レビュー**ステップで**メールアドレス検証設定**を展開します。次のオプションが利用可能です：
* **メールドメイン（MXレコード）を検証**：ドメインがメールを受信できることを確認
* **使い捨てメールアドレスを除外**：エンゲージメントを低下させる可能性のある一時または使い捨てアドレスを防止
* **ロールベースメールアドレスを除外**：エンゲージメントが低いことが多い`info@`や`support@`などの共有アドレスを防止
3つすべてがデフォルトで有効になっています。このインポートに適用したくないものはチェックを外してください。
無効なメールアドレスをインポートする必要がある場合（例：抑制または購読ステータスを更新する場合）、**無効なメールアドレスを許可**をチェックしてください。これにより検証がバイパスされ、任意の文字列がメールアドレスとして受け入れられます。
**確認してインポート**をクリックします。インポートが完了すると、結果を要約したメールが届きます：
* 追加されたサブスクリプション
* 変更されたサブスクリプション
* インポートされなかった行（拒否された行のダウンロードリンク付き）
#### 結果
有効なアドレスが受信者リストに追加されます。インポートが完了するとメールが届きます。検証に失敗したアドレスは除外され、結果メールのリンクからダウンロードできます。
***
## 既存の受信者リストを一括検証
一括検証を使用して、OneSignalの受信者リストにすでに登録されているメールアドレスを確認します。結果はCSVエクスポートとしてメールで受け取れます。
**Audience > Subscriptions**（または**Audience > Users**）に移動し、**Update/Import Users**をクリックして**Validate Email Addresses**を選択します。
モーダルで**Start validation**をクリックします。アプリのすべてのメールアドレスに対してメールアドレス検証が実行されます。
検証が完了すると、OneSignalから**CSV エクスポートをダウンロード**リンクが記載されたメールが届きます。リンクは72時間有効です。メールには失敗したアドレス数が次の項目別に要約されています：
* タイプミス
* ロールベースアドレス
* 使い捨てドメイン
* 無効なMXレコード
CSVをダウンロードしてフラグされたアドレスを確認します。
受信者リストをクリーンアップするには、修正または処理されたアドレスを含む新しいCSVを作成し、次の列形式のいずれかを使用して再インポートします：
| 目標 | 必須列 | 値 |
| --------------- | -------------------- | --------------------- |
| 修正されたアドレスを再購読 | `email`、`subscribed` | `subscribed` = `yes` |
| フラグされたアドレスを購読解除 | `email`、`subscribed` | `subscribed` = `no` |
| フラグされたアドレスを抑制 | `email`、`suppressed` | `suppressed` = `true` |
#### 結果
エラータイプ別に分類された検証結果の要約と共に、フラグされたアドレスのCSVエクスポートが記載されたメールが届きます。
***
## 検証エラーリファレンス
検証結果に次のエラーが表示される場合があります：
| エラー | 意味 | 対処方法 |
| ------------------ | ---------------------------------------------------------------------------------- | ---------------------------------------- |
| **無効な入力** | アドレスの形式が正しくなく、基本的な構文要件を満たしていません（例：`@`の欠如、無効なTLD）。 | アドレスを修正または削除してください。 |
| **メールアドレスのタイプミス** | ドメインに誤りが検出されました。隣の列に提案された修正が表示されます。 | 提案された修正を適用するか、アドレスを削除してください。 |
| **MXレコードが見つかりません** | ドメインに有効なメール交換レコードがありません。このアドレスにはメールを配信できません。 | アドレスを削除または抑制してください。 |
| **ロールベースのメールアドレス** | ローカル部分（`@`の前）が`sales@`や`support@`などの既知のロールベースパターンと一致します。これらのアドレスは個人のものである可能性が低いです。 | アドレスがユースケースに適切かどうかを確認してから、抑制または削除してください。 |
| **使い捨てメールアドレス** | ドメインが一時または使い捨てメールサービスに関連しています。 | アドレスを抑制または削除してください。 |
***
## APIエラーレスポンス
メールアドレス検証はAPIを通じて送信されたアドレスにも適用されます。以下のセクションでは発生する可能性のあるエラーレスポンスを説明します。
API検証はメールアドレスの形式が正しいかどうかのみを確認します。タイプミス、MXレコード、ロールベースアドレス、使い捨てドメインは確認しません。これらのチェックはCSVインポートおよび一括検証中のみ利用可能です。
### メール送信：メッセージを作成
[メッセージを作成エンドポイント](/reference/create-message)を通じて1つ以上の無効なアドレスに送信すると、無効なアドレスは配信から除外され、`invalid_email_tokens`の下に返されます。
```json theme={null}
{
"id": "",
"errors": {
"invalid_email_tokens": ["invalid@email"]
}
}
```
### ユーザーまたはサブスクリプションの追加：ユーザーモデルAPI
[ユーザーを作成](/reference/create-user)または[サブスクリプションを作成](/reference/create-subscription)エンドポイントを通じて無効なメールでユーザーまたはサブスクリプションを作成する場合：
```json theme={null}
{
"errors": [
{
"title": "Invalid `token` format for device type email"
}
]
}
```
### デバイスの追加：レガシーPlayers API
[レガシーPlayers API](/reference/add-a-device)を通じて無効なメールでプレイヤーレコードを追加または編集する場合：
```json theme={null}
{
"success": false,
"errors": ["[\"Identifier invalid format.\"]"]
}
```
レガシーPlayers APIは非推奨です。より詳細な検証エラーを受け取り、現在の機能にアクセスするには[ユーザーモデルAPI](/reference/create-user)に移行してください。