

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

# モバイルプッシュ API アクション
<a name="mobile-push-api"></a>

Amazon SNS モバイルプッシュ API を使用するには、まず、プッシュ通知サービス (Apple Push Notification (APN)、Firebase Cloud Messaging (FCM) など) の前提条件を満たす必要があります。前提条件の詳細については、「[Amazon SNS ユーザー通知の前提条件](sns-prerequisites-for-mobile-push-notifications.md)」を参照してください。

 API を使用してモバイルアプリケーションおよびデバイスにプッシュ通知メッセージを送信するには、まず、`CreatePlatformApplication` アクションを使用する必要があります。このアクションは、`PlatformApplicationArn` 属性を返します。この `PlatformApplicationArn` 属性は、`CreatePlatformEndpoint` によって使用され、`EndpointArn` 属性が返されます。この `EndpointArn` 属性と `Publish` アクションを使用して、モバイルアプリケーションやデバイスに通知メッセージを送信することができます。また、`EndpointArn` 属性と `Subscribe` アクションを使って、トピックへのサブスクリプションを行うこともできます。詳細については、「[Amazon SNS でプッシュ通知を設定する](sns-mobile-application-as-subscriber.md#sns-user-notifications-process-overview)」を参照してください。

Amazon SNS モバイルプッシュ API は次のとおりです。

`[CreatePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)`  
デバイスやモバイルアプリケーションを登録できる、サポートされているいずれかのプッシュ通知サービス (例: APNS、GCM) のプラットフォームアプリケーションオブジェクトを作成します。`PlatformApplicationArn` 属性を返します。この属性は、`CreatePlatformEndpoint` アクションで使用されます。

`[CreatePlatformEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)`  
サポートされているプッシュ通知サービスのいずれかでデバイスおよびモバイルアプリケーションのエンドポイントを作成します。`CreatePlatformEndpoint` は、`CreatePlatformApplication` アクションから返される `PlatformApplicationArn`属性を使用します。`CreatePlatformEndpoint` を使用したときに返される `EndpointArn` 属性は、モバイルアプリケーションとデバイスに通知メッセージを送信するために `Publish` アクションで使用されます。

`[CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)`  
メッセージが発行されるトピックを作成します。

`[DeleteEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)`  
サポートされているプッシュ通知サービスのいずれかでデバイスおよびモバイルアプリケーションのエンドポイントを削除します。

`[DeletePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)`  
プラットフォームアプリケーションオブジェクトを削除します。

`[DeleteTopic](https://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)`  
トピックとすべてのサブスクリプションを削除します。

`[GetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)`  
デバイスおよびモバイルアプリケーションのエンドポイント属性を取得します。

`[GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)`  
プラットフォームアプリケーションオブジェクトの属性を取得します。

`[ListEndpointsByPlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)`  
サポートされているプッシュ通知サービスでのデバイスおよびモバイルアプリケーションのエンドポイントとエンドポイント属性を一覧表示します。

`[ListPlatformApplications](https://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)`  
サポートされているプッシュ通知サービス用のプラットフォームアプリケーションオブジェクトを一覧表示します。

`[Publish](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html)`  
トピックのサブスクライブされたエンドポイントすべてに通知メッセージを送信します。

`[SetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)`  
デバイスおよびモバイルアプリケーションのエンドポイントの属性を設定します。

`[SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)`  
プラットフォームアプリケーションオブジェクトの属性を設定します。

`[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`  
エンドポイントに確認メッセージを送信して、エンドポイントのサブスクライブに備えます。実際にサブスクリプションを作成するには、エンドポイントの所有者は確認メッセージからトークンと共に ConfirmSubscription アクションを呼び出す必要があります。

`[Unsubscribe](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)`  
サブスクリプションを削除します。