

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS エンドユーザーメッセージング SMS を使用して MMS メッセージを送信する例
<a name="send-mms-message"></a>

共有リソースを使用している場合は、リソースの完全な Amazon リソースネーム (ARN) を使用する必要があります。 AWS CLI または AWS End User Messaging SMS および音声 v2 API を使用して、顧客に MMS メッセージを送信できます。

[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI コマンドを使用して MMS メッセージを送信します。の設定の詳細については AWS CLI、 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)の[「AWS CLI の設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)」を参照してください。

**重要**  
MMS 機能は、一部の国でのみ使用できます。SMS および MMS をサポートしている国の詳細については、「[AWS エンドユーザーメッセージング SMS を使用した SMS メッセージングでサポートされている国とリージョン](phone-numbers-sms-by-country.md)」および「[AWS エンドユーザーメッセージング SMS での MMS メッセージングでサポートされている国とリージョン](phone-numbers-mms-by-country.md)」を参照してください。  
発信元 ID が MMS 対応かどうかを確認するには、「[AWS エンドユーザーメッセージング SMS で電話番号のステータスと機能を表示する](phone-numbers-status.md)」を参照してください。  
共有リソースを使用するには、完全な Amazon リソースネーム (ARN) を使用する必要があります。

## 前提条件
<a name="send-mms-message-prerequisite"></a>

開始するには、以下の前提条件を満たす必要があります。
+ [MMS メッセージの送信をサポートする](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title)発信元 ID が必要です。
+ MMS 対応の送信元 ID AWS リージョン と同じ にある Amazon S3 バケットにメディアファイルをアップロードする必要があります。「」を参照してください[MMS ファイル用 Amazon S3 バケットのセットアップ](#send-mms-message-bucket)。

  サポートファイルのタイプとサイズのリストは、「[ MMS ファイルの種類、サイズ、文字数の制限  MMS ファイルのサイズ、ファイルタイプの制限、および MMS に含めることができる最大文字数について説明します。  MMS ファイルの種類MMS ファイルのサイズMMS 文字制限  1 つの MMS メディアファイルのサイズは、すべての画像タイプ (gif、jpeg、png) で最大 2 MB、すべてのオーディオおよびビデオメディアファイルタイプでは最大 600 KB です。MMS のテキストメッセージ本文には、任意の文字セットから 1600 文字を含めることができます。SMS とは異なり、MMS メッセージは送信時に複数のパートに分割されません。大きなテキストメッセージを送信する場合、複数のパートに分割されないため、MMS メッセージを送信するスループットが向上する可能性があります。 


****  

| ファイルタイプ | MIME タイプ | 最大ファイルサイズ | 
| --- | --- | --- | 
| グラフィックスインターチェンジフォーマット |  `image/gif`  | 2 MB | 
| ジョイントフォトグラフィックエキスパーツグループ |  `image/jpeg`  | 2 MB | 
| ポータブルネットワークグラフィックス  |  `image/png`  | 2 MB | 
| タグ付きイメージファイルフォーマット |  `image/tiff`  | 600 KB | 
| 3GPP  |  `audio/3gpp`, `video/3gpp`  | 600 KB | 
| 3GPP2  |  `audio/3gpp2`, `video/3gpp2`  | 600 KB | 
| 適応マルチレート |  `audio/amr`  | 600 KB | 
| MPEG-4 |  `audio/mp4`, `video/mp4`  | 600 KB | 
| ムービングピクチャーエクスパーツグループ |  `audio/mpeg` `audio/mpeg` では MP3 ファイルのみがサポートされています  | 600 KB | 
| Ogg |  `audio/ogg`  | 600 KB | 
| QuickTime |  `video/quicktime`  | 600 KB | 
| WebM |  `video/webm`  | 600 KB | 
| iCalendar |  `text/calendar`  | 600 KB | 
| vCard |  `text/vcard`, `text/x-vcard`  | 600 KB | 
| ポータブルドキュメント形式 |  `application/pdf`  | 600 KB |  ](mms-limitations-character.md#mms-limitations-character.title)」を参照してください。
+ 各 MMS ファイルの S3 URI。
+ `send-media-message` を呼び出すために使用される ID には、メディアファイルを含む Amazon S3 バケットへの読み取りアクセスが必要です。読み取りアクセスの設定の詳細は、[Amazon S3 ユーザーガイド](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)の「[Amazon S3 のアイデンティティベースのポリシー例](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)」を参照してください。

## を使用して MMS を送信する AWS CLI
<a name="send-mms-message-steps"></a>

[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) に必要なパラメータは `destination-phone-number` と `origination-identity` のみです。`media-urls` パラメータを省略することにより、テキストのみのメッセージを送信できます。`message-body` パラメータを省略することにより、メディアファイルのみのメッセージを送信することもできます。

**MMS メッセージを送信するには**
+ コマンドラインで以下のコマンドを入力します。

  ```
  aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number +12065550150 --origination-identity +14255550120 --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'
  ```

  上のコマンドに、以下の変更を加えます。
  + *us-east-1* を、発信元 ID が保存され AWS リージョン ている に置き換えます。
  + *\$112065550150* を送信先電話番号に置き換えます。
  + *\$114255550120* を発信元 ID に置き換えます。発信元 ID は `ACTIVE` で、送信先電話番号に送信できる必要があります。
  + *text body* をテキストメッセージに置き換えます。
  + *s3://s3-bucket/media\$1file.jpg* を MMS ファイルの S3 URI に置き換えます。サポートされているメディアファイル形式は、「[MMS ファイルの種類、サイズ、文字数の制限](mms-limitations-character.md)」に記載されています。S3 バケットの作成とオブジェクトの管理の詳細については、[MMS ファイル用 Amazon S3 バケットのセットアップ](#send-mms-message-bucket) または [Amazon S3 ユーザーガイド](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)の「[バケットの作成](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)」および「[オブジェクトのアップロード](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html)」を参照してください。

 AWS エンドユーザーメッセージング SMS が コマンドを受け入れると、 を受け取ります`MessageID`。これは、コマンドが正常に受信されただけで、送信先デバイスがメッセージを受信したわけではありません。エラーコードのリストは、「[SendMediaMessage エラー](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors)」を参照してください。

```
{
   "MessageId": "string"
}
```

## MMS ファイル用 Amazon S3 バケットのセットアップ
<a name="send-mms-message-bucket"></a>

MMS ファイルは Amazon S3 バケットに保存する必要があります。Amazon S3 バケットは、MMS 対応の送信元 ID AWS リージョン と同じ AWS アカウント および にある必要があります。ここでは、Amazon S3 バケットの作成方法、ファイルのアップロード方法、および URI をファイルに構築する方法を説明しています。Amazon S3 コマンドの詳細は、「[AWS CLI で高レベル (s3) コマンドを使用する](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html)」を参照してください。の設定の詳細については AWS CLI、 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)の[「AWS CLI の設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)」を参照してください。

Amazon S3 バケットを作成するには、[create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI コマンドを使用します。コマンドラインで以下のコマンドを入力します。

```
aws s3api create-bucket --region 'us-east-1' --bucket BucketName
```

上記のコマンドでは:
+ *us-east-1* を、MMS 対応の送信元 ID が存在する に置き換え AWS リージョン ます。
+ *BucketName* を新しいバケット名に置き換えます。

Amazon S3 バケットにファイルをコピーするには、[cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) AWS CLI コマンドを使用します。コマンドラインで以下のコマンドを入力します。

```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName 
```

上記のコマンドでは:
+ *SourceFilePathAndName* をコピーするファイルパスと名前に置き換えます。
+ *BucketName* をバケット名に置き換えます。
+ *FileName* をファイルに使用する名前に置き換えます。

送信時に使用する URI は次のとおりです。

```
s3://BucketName/FileName
```