Mobile Push-API-Aktionen
Um die mobilen Amazon SNS-Push-APIs zu verwenden, müssen Sie zuerst die Voraussetzungen für den Push-Benachrichtigungs-Service, z. B. Apple Push Notification Service (APNs) und Firebase Cloud Messaging (FCM) erfüllen. Weitere Informationen zu diesen Voraussetzungen finden Sie unter Voraussetzungen für Amazon SNS-Benutzerbenachrichtigungen.
Um mit den APIs eine Push-Benachrichtigung an eine mobile App und ein Gerät zu senden, müssen Sie zunächst die CreatePlatformApplication
-Aktion verwenden. Diese gibt ein PlatformApplicationArn
-Attribut zurück. Das PlatformApplicationArn
-Attribut wird dann von CreatePlatformEndpoint
verwendet. So wird ein EndpointArn
-Attribut zurückgeben. Anschließend können Sie mit dem EndpointArn
-Attribut mit der Publish
-Aktion eine Benachrichtigung an eine mobile App und ein Gerät senden oder Sie können das EndpointArn
-Attribut mit der Subscribe
-Aktion zum Abonnieren eines Themas verwenden. Weitere Informationen finden Sie unter Übersicht über den Benutzerbenachrichtigungsprozess.
Die mobilen Amazon SNS-Push-APIs sind Folgende:
CreatePlatformApplication
-
Erstellt ein Plattformanwendungsobjekt für einen unterstützten Push-Benachrichtigungsservice (z. B. APNs und FCM), bei dem sich Geräte und Mobilgeräte-Apps registriert können. Gibt ein
PlatformApplicationArn
-Attribut zurück, das für dieCreatePlatformEndpoint
-Aktion verwendet wird. CreatePlatformEndpoint
-
Erstellt einen Endpunkt für ein Gerät und eine mobile App für einen der unterstützten Push-Benachrichtigungsservices.
CreatePlatformEndpoint
verwendet dasPlatformApplicationArn
-Attribut, das derCreatePlatformApplication
-Aktion zurückgegeben wurde. DasEndpointArn
-Attribut, das bei der Verwendung vonCreatePlatformEndpoint
zurückgegeben wird, wird mit derPublish
-Aktion verwendet, um eine Benachrichtigung an die mobile App und das Gerät zu senden. CreateTopic
-
Erstellt ein Thema, über das die Nachrichten veröffentlicht werden können.
DeleteEndpoint
-
Löscht den Endpunkt für ein Gerät und eine mobile App für einen der unterstützten Push-Benachrichtigungsservices.
DeletePlatformApplication
-
Löscht ein Plattformanwendungsobjekt.
DeleteTopic
-
Löscht ein Thema und alle seine Abonnements.
GetEndpointAttributes
-
Ruft die Endpunktattribute für ein Gerät und eine mobile App ab.
GetPlatformApplicationAttributes
-
Ruft die Attribute des Plattformanwendungsobjekts ab.
ListEndpointsByPlatformApplication
-
Listet die Endpunkte und Endpunktattribute für Geräte und mobile Apps in einem unterstützten Push-Benachrichtigungsservice auf.
ListPlatformApplications
-
Listet die Plattformanwendungsobjekte für die unterstützten Push-Benachrichtigungsservices auf.
Publish
-
Sendet eine Benachrichtigung an alle abonnierten Endpunkte des Themas.
SetEndpointAttributes
-
Legt die Attribute für einen Endpunkt für ein Gerät und eine mobile App fest.
SetPlatformApplicationAttributes
-
Legt die Attribute des Plattformanwendungsobjekts fest.
Subscribe
-
Bereitet über das Senden einer Bestätigungsnachricht an den Endpunkt das Abonnieren eines Endpunkts vor. Um ein Abonnement zu erstellen, muss der Eigentümer des Endpunkts die ConfirmSubscription-Aktion mit dem Token aus der Bestätigungsnachricht aufrufen.
Unsubscribe
-
Löscht ein Abonnement.