

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Ações da API de push para dispositivos móveis
<a name="mobile-push-api"></a>

Para usar as APIs de push para dispositivos móveis do Amazon SNS, primeiro é necessário atender aos pré-requisitos do serviço de notificações por push, como o Apple Push Notification Service (APNs) e o Firebase Cloud Messaging (FCM). Para obter mais informações sobre os pré-requisitos, consulte [Pré-requisitos para notificações ao usuário do Amazon SNS](sns-prerequisites-for-mobile-push-notifications.md). 

 Para enviar uma mensagem de notificação por push para um dispositivo um aplicativo móvel usando as APIs, você deve primeiro usar a ação `CreatePlatformApplication`, que retorna um atributo `PlatformApplicationArn`. O atributo `PlatformApplicationArn` é, então, usado por `CreatePlatformEndpoint`, que retorna um atributo `EndpointArn`. Em seguida, você pode usar o atributo `EndpointArn` com a ação `Publish` para enviar uma mensagem de notificação para um dispositivo e aplicativo móvel, ou você pode usar o atributo `EndpointArn` com a ação `Subscribe` de inscrição em um tópico. Para obter mais informações, consulte [Configurar notificações de push com o Amazon SNS](sns-mobile-application-as-subscriber.md#sns-user-notifications-process-overview).

As APIs de push para dispositivos móveis do Amazon SNS são as seguintes: 

`[CreatePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)`  
Cria um objeto de aplicação da plataforma para um dos serviços de notificações por push compatíveis, como o APNs e o FCM, nos quais os dispositivos e as aplicações móveis podem se registrar. Retorna um atributo `PlatformApplicationArn`, que é usado pela ação `CreatePlatformEndpoint`.

`[CreatePlatformEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)`  
Cria um endpoint para um dispositivo e aplicativo móvel em um dos serviços de notificação por push compatíveis. O `CreatePlatformEndpoint` usa o atributo `PlatformApplicationArn` retornado da ação `CreatePlatformApplication`. O atributo `EndpointArn`, que é retornado ao usar `CreatePlatformEndpoint`, é, então, usado com a ação `Publish` para enviar uma mensagem de notificação para um dispositivo e aplicativo móvel. 

`[CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)`  
Cria um tópico no qual as mensagens podem ser publicadas. 

`[DeleteEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)`  
Exclui o endpoint para um dispositivo e aplicativo móvel em um dos serviços de notificações por push compatíveis.

`[DeletePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)`  
Exclui um objeto de aplicativo de plataforma.

`[DeleteTopic](https://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)`  
Exclui um tópico e todas as suas inscrições.

`[GetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)`  
Recupera os atributos do endpoint para um dispositivo e aplicativo móvel.

`[GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)`  
Recupera os atributos da plataforma de objeto de aplicativo.

`[ListEndpointsByPlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)`  
Lista os endpoints e atributos de endpoint para dispositivos e aplicativos móveis em um serviço de notificações por push compatível.

`[ListPlatformApplications](https://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)`  
Lista os objetos do aplicativo da plataforma para os serviços de notificações por push compatíveis.

`[Publish](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html)`  
Envia uma mensagem de notificação para todos os endpoints inscritos em um tópico.

`[SetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)`  
Define os atributos para um endpoint para um dispositivo e aplicativo móvel.

`[SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)`  
Define os atributos do objeto de aplicativo de plataforma.

`[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`  
Prepara para assinar um endpoint enviando ao endpoint uma mensagem de confirmação. Para criar de fato uma inscrição, o proprietário do endpoint deve chamar a ação ConfirmSubscription com o token da mensagem de confirmação. 

`[Unsubscribe](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)`  
Exclui a inscrição.