翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# キャリアルックアップサービスを使用する
AWS エンドユーザーメッセージング SMS には、電話番号が有効かどうかなど、電話番号に関する情報を取得するために使用できるキャリア検索サービスが含まれています。キャリアルックアップサービスは、電話番号について次の情報を返します。
+ E164 形式の電話番号 (元の入力からサニタイズ）。
+ 電話番号のタイプ (無効、固定電話、モバイルなど）。
+ 電話番号の国またはリージョンの名前。
+ 電話番号の国または地域の数値ダイヤルコード。
+ 電話番号の ISO 3166-1 alpha-2 形式の 2 文字の国またはリージョンコード。
+ 携帯電話の場合は、モバイル国コード (MCC)。
+ 携帯電話の場合は、モバイルネットワークコード (MNC)。
+ 電話番号が現在登録されているキャリアまたはサービスプロバイダー。一部の国やリージョンでは、この値は電話番号が最初に登録されたキャリアまたはサービスプロバイダーである場合があります。
キャリア検索サービスの使用には追加料金がかかります。詳細については、[AWS 「エンドユーザーメッセージング SMS の料金](https://aws.amazon.com/end-user-messaging/pricing/#Phone_number_validate)」を参照してください。
## キャリア検索のユースケース
キャリア検索サービスを使用して、次のようないくつかのユースケースを有効にできます。
+ **ウェブフォームで提供される電話番号の検索** – ウェブベースのフォームを使用して顧客の連絡先情報を収集する場合、フォームを送信する前に顧客が提供した電話番号を検索できます。ウェブサイトのバックエンドを使用して、 AWS エンドユーザーメッセージング SMS API を使用して番号を検索および検証します。API レスポンスは、電話番号が正しくフォーマットされている場合など、番号が有効かどうかを示します。お客様が指定した電話番号が無効であると判断した場合、ウェブフォームで有効な電話番号の入力をお客様に求めることができます。
+ **既存の問い合わせデータベースのクリーンアップ** – 顧客の電話番号のデータベースがある場合は、各電話番号を検索し、キャリアの検索結果を使用してデータベースを更新できます。例えば、SMS メッセージを受信できない電話番号を持つエンドポイントを見つけた場合は、そのエンドポイントの `ChannelType` プロパティを `SMS` から `VOICE` に変更できます。
+ [**Choosing the right channel before you send a message**] - SMS メッセージを送信しようとしているが送信先番号が無効であると判断した場合は、別のチャネルを介して受信者にメッセージを送信できます。例えば、エンドポイントが、SMS メッセージを受信できない場合は、代わりに音声メッセージを送信できます。
## サポートされている電話番号形式
電話番号は E164 形式である必要があります。プラス記号 (\+) の後に国のダイヤルコードと電話番号 (例: \+12065551234) が続きます。キャリアルックアップサービスは、さまざまなフォーマット文字を受け入れ、処理中に自動的に削除します。電話番号入力には、次の書式設定文字を含めることができます。
+ 括弧: `+1 (555) 123-4567`
+ ブラケット: `+1 [555] 123-4567`
+ スペース: `+1 555 123 4567`
+ ハイフン: `+1-555-123-4567`
+ 期間: `+1.555.123.4567`
+ カンマ: `+1,555,123,4567`
+ 混合フォーマット: `+1 (555)-123.4567`
すべてのフォーマット文字は処理中に自動的に削除され、サービスはレスポンスの `E164PhoneNumber`フィールドに標準の E164 形式 ( など`+15551234567`) の電話番号を返します。
## でのキャリア検索サービスの使用 AWS CLI
次の例は、 でキャリアルックアップサービスを使用する方法を示しています AWS CLI。このサービスは、さまざまなフォーマット文字 (括弧、括弧、スペース、ハイフン、ピリオド、カンマ) を持つ電話番号を受け入れ、処理のために E164 形式に自動的に変換します。詳細については、 AWS 「エンドユーザーメッセージング SMS API リファレンス」の[CarrierLookup](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_CarrierLookup.html)」または AWS CLI 「 コマンドリファレンス」の[「キャリアルックアップ](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/carrier-lookup.html)」を参照してください。
**キャリアルックアップサービスを使用するには (CLI)**
+ コマンドラインで、以下のコマンドを入力します。さまざまな電話番号形式を使用できます。サービスは、括弧、括弧、スペース、ハイフン、ピリオド、カンマなどの特殊文字を使用できます。
```
$ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number {{"+1 (555) 555-5333"}}
```
または、E164 形式の場合:
```
$ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number {{+15555555333}}
```
### キャリアルックアップレスポンス
キャリアルックアップサービスが提供する情報は、指定した電話番号で利用可能なデータによって若干異なります。このセクションでは、キャリアルックアップサービスが返すレスポンスの例を示します。
**注記**
キャリアルックアップサービスによって提供されるデータは、世界中の通信プロバイダーやその他のエンティティによって提供される情報に基づいています。一部の国のプロバイダーは、他の国のプロバイダーほど頻繁にこの情報を更新しない場合があります。たとえば、携帯電話番号を検証するリクエストを発行し、指定した番号が 1 つの携帯電話キャリアから別の携帯電話キャリアに移植された場合、キャリア検索サービスからのレスポンスには、現在のキャリアではなく元のキャリアの名前が含まれることがあります。
**有効な携帯電話番号**
次のレスポンスは、有効な携帯電話番号に対して が`CarrierLookup`返す情報の例です。
```
{
"E164PhoneNumber": "+15555555333",
"DialingCountryCode": "1",
"IsoCountryCode": "US",
"Country": "United States",
"MCC": "310",
"MNC": "260",
"Carrier": "ExampleCorp Mobile",
"PhoneNumberType": "MOBILE"
}
```
**有効な固定電話番号**
次のレスポンスは、有効な固定電話番号に対して が`CarrierLookup`返す情報の例です。
```
{
"E164PhoneNumber": "+15555555333",
"DialingCountryCode": "1",
"IsoCountryCode": "CA",
"Country": "Canada",
"Carrier": "ExampleCorp Landline",
"PhoneNumberType": "LANDLINE"
}
```
**無効な電話番号**
リクエストに無効な電話番号が含まれている場合、キャリアルックアップサービスは、次の例のような情報を返します。
```
{
"E164PhoneNumber": "+15555555333444666",
"PhoneNumberType": "INVALID"
}}
```
このレスポンスの `PhoneNumberType` プロパティは、この電話番号が `INVALID` であること、および電話番号に関連付けられた携帯電話会社または場所に関する情報が含まれていないことを示しています。`PhoneNumberType` が `INVALID` である電話番号に SMS または音声メッセージを送信することは避けてください。これらの番号は実際の受信者に属しているとは考えられないためです。
**その他の電話番号**
携帯電話、固定電話、無効に分類されていない電話番号は、 `PhoneNumberType`の値で返されます`OTHER`。