---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Now PushService-Klasse -- Android

# Now PushService-Klasse -- Android {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die Now PushService Die Klasse bietet Funktionen, die die Interaktion mit dem Push-Benachrichtigungsservice ermöglichen.
{#NowPushServiceAndroidAPI__table_vx2_klw_5pb__entry__2}

| Name | Beschreibung |
|-|-|
| konfigurieren | Servicekonfiguration, die dem Service zugeordnet werden soll. Datentyp: [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/WAB84mPvDb0Qp4qoJQv2OQ "Die Jetzt Servicekonfiguration Mit der Klasse können Sie konfigurieren ServiceNowInstanz-URL und Paketname für einen Funktionsservice.") |
[Tabelle : 1. Eigenschaften]

{#NowPushServiceAndroidAPI__table_vx2_klw_5pb}

## NowPushService -- handlePush(remoteMessage: RemoteMessage, Success Callback: Consumer\<NowPushPayload\>, errorCallback: Consumer\<Throwable\>) {#ariaid-title2}

Verarbeitet eine Push-Benachrichtigungsanforderung.
Hinweis:  
Derzeit ist der einzige implementierte Push-Benachrichtigungstyp `Now PushVirtualAgent `. Jeder andere übergebene Push-Benachrichtigungstyp gibt ein zurück [Nicht SupportedPushError](https://servicenow-prod.fluidtopics.net/iqlMS_KK1JfaLiYe8bD9Hg#NotSupportedPushErrorAndroidAPI "Eine Funktion von Nicht SupportedPushError Klasse wird ausgelöst, wenn das NowPushSDK die Push-Benachrichtigungsanforderung nicht verarbeiten kann. Wenn dieser Fehlertyp ausgelöst wird, müssen Sie die Push-Benachrichtigung außerhalb des MobileSDK-Frameworks analysieren und verarbeiten.")Objekt.
{#NPushServ-handlePush_S_O_O__table_aly_nvk_nrb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Remote-Nachricht | [Remote-Nachricht](https://firebase.google.com/docs/reference/android/com/google/firebase/messaging/RemoteMessage) | Benachrichtigung wie erhalten von `Com.google.Firebase.Messaging.FirebaseMessagingService.onMessageReceived `. Weitere Informationen finden Sie unter [Empfangen Sie Nachrichten in einer Android-App](https://firebase.google.com/docs/cloud-messaging/android/receive). |
| Erfolgreicher Rückruf | [Verbraucher](https://developer.android.com/reference/kotlin/java/util/function/Consumer)\< [Now PushPayload](https://servicenow-prod.fluidtopics.net/eUrM8g9AODc_I1ZDJP_awQ#NowPushPayloadAndroidInterface "Die Now PushPayload Die Schnittstelle definiert die Nutzlast der Push-Benachrichtigung, die das Now SDK implementiert.")\> | Rückruf, um den verarbeiteten zurückzugeben NowPushPayloadBis. |
| Fehler beim Rückruf | [Verbraucher](https://developer.android.com/reference/kotlin/java/util/function/Consumer)\< [Throwable](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/)\> | Rückruf, an den der ausgelöste Fehler zurückgegeben werden soll. Wenn der Fehler ist [Nicht SupportedPushError](https://servicenow-prod.fluidtopics.net/iqlMS_KK1JfaLiYe8bD9Hg#NotSupportedPushErrorAndroidAPI "Eine Funktion von Nicht SupportedPushError Klasse wird ausgelöst, wenn das NowPushSDK die Push-Benachrichtigungsanforderung nicht verarbeiten kann. Wenn dieser Fehlertyp ausgelöst wird, müssen Sie die Push-Benachrichtigung außerhalb des MobileSDK-Frameworks analysieren und verarbeiten.")Wird ausgelöst, wird der Benachrichtigungstyp vom mobilen SDK nicht unterstützt und muss außerhalb des mobilen SDK-Frameworks verarbeitet werden. |
[Tabelle : 2. Parameter]

{#NPushServ-handlePush_S_O_O__table_aly_nvk_nrb} {#NPushServ-handlePush_S_O_O__table_bly_nvk_nrb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Rückgaben]

{#NPushServ-handlePush_S_O_O__table_bly_nvk_nrb}  
Dieses Beispiel zeigt, wie Sie überschreiben OnMessageReceived() Und übergeben Sie RemoteMessageBis zu `Now PushService `. Wenn `Now PushService `Erkennt den Benachrichtigungstyp, verarbeitet die Anforderung und gibt das Benachrichtigungsobjekt zurück, das die Anwendung verarbeiten soll. Andernfalls wird ausgelöst [Nicht SupportedPushError](https://servicenow-prod.fluidtopics.net/iqlMS_KK1JfaLiYe8bD9Hg#NotSupportedPushErrorAndroidAPI "Eine Funktion von Nicht SupportedPushError Klasse wird ausgelöst, wenn das NowPushSDK die Push-Benachrichtigungsanforderung nicht verarbeiten kann. Wenn dieser Fehlertyp ausgelöst wird, müssen Sie die Push-Benachrichtigung außerhalb des MobileSDK-Frameworks analysieren und verarbeiten.").

    override fun onMessageReceived(remodeeMessage: RemoteMessage){
      pushService.handlePush(remoteMessage, { push ->
        when (push) {
          is NowPushVirtualAgent → handleVirtualAgentPush(push)
        }, { error ->
            Log.e(TAG, "Unknown push", error)
            handleAppPushNotification(remoteMessage)
        })
    }

## NowPushService -- registerPushToken(pushToken: Zeichenfolge, pushApp: Zeichenfolge, succCallback: Ausführbar, errorCallback: Consumer\<Throwable\>) {#ariaid-title3}

Registriert eine eindeutige FirebaseToken mit ServiceNowInstanz, die zum Identifizieren der Push-Benachrichtigungen für die aktuelle Instanz verwendet wird AndroidGerät und angegebene Anwendung.
In der Reihenfolge für ServiceNowInstanz zum Generieren von Benachrichtigungen AndroidGerät, um Benachrichtigungen von der Anwendung zu erhalten, muss dieses Token registriert werden.
{#NPushServ-registerPushToken_S_S_O_O__table_zhp_ccl_nrb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Push-Token | Zeichenfolge | FirebaseToken wurde von einer der beiden abgerufen [Com.google.Firebase.Messaging.FirebaseMessaging.getToken](https://firebase.google.com/docs/reference/js/v8/firebase.messaging.Messaging#gettoken)Oder [Com.google.Firebase.Messaging.FirebaseMessagingService.onNewToken](https://firebase.google.com/docs/cloud-messaging/android/client). |
| Push-App | Zeichenfolge | Name der Push-Anwendung, wie in der Tabelle „Push-Anwendung" auf dem angegeben ServiceNowInstanz. |
| Erfolgreicher Rückruf | [Ausführbar](https://developer.android.com/reference/kotlin/java/lang/Runnable.html) | Rückruf wird ausgeführt, wenn die Tokenregistrierung erfolgreich ist. |
| Fehler -- Rückruf | [Verbraucher](https://developer.android.com/reference/kotlin/java/util/function/Consumer)\< [Throwable](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/)\> | Rückruf wird ausgeführt, wenn die Tokenregistrierung fehlschlägt. |
[Tabelle : 4. Parameter]

{#NPushServ-registerPushToken_S_S_O_O__table_zhp_ccl_nrb} {#NPushServ-registerPushToken_S_S_O_O__table_a3p_ccl_nrb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Rückgaben]

{#NPushServ-registerPushToken_S_S_O_O__table_a3p_ccl_nrb}  
In diesem Beispiel wird ein Push-Token für die aktuelle registriert AndroidGerät und Anwendung „PushAppName".

    FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
      val token = task.result

      if (!task.isSuccessful || token == null) {
        throw Exception("Unable to fetch token"))
      }

      pushService.registerPushToken(token, "PushAppName", {
        Log.v(TAG, "Successfully registered push token")
      }, { e ->
        Log.e(TAG, "Error registering push", e)
      })
    }

## NowPushService -- unregisterPushToken(pushToken: Zeichenfolge, pushApp: Zeichenfolge, succCallback: Ausführbar, errorCallback: Consumer\<Throwable\>) {#ariaid-title4}

Hebt die Registrierung des angegebenen auf FirebasePush-Token mit zugehörigem ServiceNowInstanz.
{#NPushServ-unregPushToken_S_S_O_O__table_ywx_bgl_nrb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Push-Token | Zeichenfolge | Firebase Token zum Aufheben der Registrierung. Wurde von einer der beiden abgerufen [Com.google.Firebase.Messaging.FirebaseMessaging.getToken](https://firebase.google.com/docs/reference/js/v8/firebase.messaging.Messaging#gettoken)Oder [Com.google.Firebase.Messaging.FirebaseMessagingService.onNewToken](https://firebase.google.com/docs/cloud-messaging/android/client). |
| Push-App | Zeichenfolge | Name der Push-Anwendung, die dem Token zugeordnet ist, dessen Registrierung aufgehoben werden soll. Diese Informationen werden in der Push-Anwendungstabelle auf der zugehörigen gespeichert ServiceNowInstanz. |
| Erfolgreicher Rückruf | [Ausführbar](https://developer.android.com/reference/kotlin/java/lang/Runnable.html) | Rückruf wird ausgeführt, wenn die Token-Registrierung erfolgreich aufgehoben wird. |
| fehler beim Rückruf | [Verbraucher](https://developer.android.com/reference/kotlin/java/util/function/Consumer)\< [Throwable](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/)\> | Rückruf wird ausgeführt, wenn die Token-Aufhebung fehlschlägt. |
[Tabelle : 6. Parameter]

{#NPushServ-unregPushToken_S_S_O_O__table_ywx_bgl_nrb} {#NPushServ-unregPushToken_S_S_O_O__table_zwx_bgl_nrb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Rückgaben]

{#NPushServ-unregPushToken_S_S_O_O__table_zwx_bgl_nrb}  
Dieses Codebeispiel zeigt, wie die Registrierung eines Push-Tokens aufgehoben wird, z. B. wenn sich der Anwender von der Anwendung abmeldet.

    pushService.unregisterPushtoken(token, "PushAppName", {
      Log.v(TAG, "Successfully unregistered push token")
    },  { e ->
      Log.e(TAG, "Error unregistering push", e)
    })


