---
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 -- iOS

# Now PushService-Klasse -- iOS {#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.
{#NowPushServiceiOSAPI__entry__2}

| Name | Beschreibung |
|-|-|
| konfigurieren | Konfigurationseinstellungen, die bei der Initialisierung des Service bereitgestellt wurden. Datentyp: [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/m~vU6ffKznzmlhUz94FBmw#NowServiceConfigurationiOSStruct "Die Jetzt Servicekonfiguration Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") |
[Tabelle : 1. Eigenschaften]

## NowPushService -- registerPushToken(_Token: Data, pushAppName: Zeichenfolge, Umgebung: NowPushEnvironment, Abschluss: @Escaping (Result\<Data, NowPushError\>) -\> Stornieren) {#ariaid-title2}

Registriert ein eindeutiges Token bei ServiceNowInstanz, die zum Identifizieren der Push-Benachrichtigungen für die aktuelle Instanz verwendet wird iOSGerät und angegebene Anwendung.
{#NPushServ-registerPushToken_O_S_O_O__table_cr3_pgh_trb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| _Token | Daten | Datenobjekt des zu registrierenden Push-Tokens. Dies ist das Token, das von abgerufen wurde AppleEntwickler-Website. Weitere Informationen finden Sie unter Mobile SDKEntwicklerleitfaden -- iOS. |
| PusAppName | Zeichenfolge | Name der Push-Anwendung, für die dieses Token registriert wird. |
| Umgebung | Now PushEnvironment | Umgebung, für die das Token registriert wird. Gültige Werte: * Produktion * Sandbox |
| Abschluss | @Escaping (Ergebnis​-\<Data, NowPushError\>) → ungültig | Abschlusshandler, der ausgeführt werden soll, nachdem versucht wurde, das Token zu registrieren. * Erfolg: IOS-Push-Benachrichtigungszertifikat. * Fehler: NowPushError: Informationen zum Fehler, der beim Versuch, das Token zu registrieren, aufgetreten ist. Mögliche Werte: * Decodierung: Decodierungsfehler aufgetreten. * HttpRequestFailure: Generischer Fehler, der zurückgegeben wird, wenn der HTTP-Aufruf kein Erfolg ist (2xx). * NotAuthorized: Die anfordernde Person ist nicht berechtigt, den angegebenen Push-Benachrichtigungsvorgang auszuführen. * Nicht supportedData: Push-Nutzlast ist ungültig. {#NPushServ-registerPushToken_O_S_O_O__ul_pmt_m5h_trb} {#NPushServ-registerPushToken_O_S_O_O__ul_lxy_k3h_trb} |
[Tabelle : 2. Parameter]

{#NPushServ-registerPushToken_O_S_O_O__table_cr3_pgh_trb} {#NPushServ-registerPushToken_O_S_O_O__table_dr3_pgh_trb__entry__2}

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

{#NPushServ-registerPushToken_O_S_O_O__table_dr3_pgh_trb}  
Dieses Beispiel zeigt, wie ein Push-Benachrichtigungstoken für die TestPushApp-Anwendung registriert wird.

    func registerForPushNotifications(deviceToken: Data) {
      pushService.registerPushToken(deviceToken,
          pushAppName: "TestPushApp",
          environment: environment) { [weak self] result in
        guard let self = self else { return }
        switch result {
          case .success:
            UserDefaults.standard.set(true, forKey: "pushNotificationsRegistered")
            self.pushRegistrationState = .registrationSuccess
          case .failure:
            UserDefaults.standard.set(false, forKey: "pushNotificationsRegistered")
            self.pushRegistrationState = .registrationFailed
        }
      }
    }

## NowPushService -- unregisterPushToken(_Token: Data, pushAppName: Zeichenfolge, Umgebung: NowPushEnvironment, Abschluss: @Escaping (Result\<Data, NowPushError\>) -\> Stornieren) {#ariaid-title3}

Hebt die Registrierung eines zuvor registrierten Push-Tokens auf.
{#NPushServ-unregisterPushToken_O_S_O_O__table_fvk_rjh_trb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| _Token | Daten | Datenobjekt des Push-Tokens, dessen Registrierung aufgehoben werden soll. |
| PusAppName | Zeichenfolge | Name der Push-Anwendung, für die die Registrierung dieses Tokens aufgehoben wird. |
| Umgebung | Now PushEnvironment | Umgebung, für die das Token registriert wird. Gültige Werte: * Produktion * Sandbox |
| Abschluss | @Escaping (Ergebnis​-\<Data, NowPushError\>) → ungültig | Abschlusshandler, der ausgeführt werden soll, nachdem versucht wurde, die Registrierung des Tokens aufzuheben. * Erfolg: API-Antwortdaten . * Fehler: `Now PushError `-- Informationen zum Fehler, der beim Versuch aufgetreten ist, die Registrierung des Tokens aufzuheben. Mögliche Werte: * Decodierung: Decodierungsfehler aufgetreten. * HttpRequestFailure: Generischer Fehler, der zurückgegeben wird, wenn der HTTP-Aufruf kein Erfolg ist (2xx). * NotAuthorized: Die anfordernde Person ist nicht berechtigt, den angegebenen Push-Benachrichtigungsvorgang auszuführen. * Nicht supportedData: Push-Nutzlast ist ungültig. {#NPushServ-unregisterPushToken_O_S_O_O__ul_pmt_m5h_trb} {#NPushServ-unregisterPushToken_O_S_O_O__ul_lxy_k3h_trb} |
[Tabelle : 4. Parameter]

{#NPushServ-unregisterPushToken_O_S_O_O__table_fvk_rjh_trb} {#NPushServ-unregisterPushToken_O_S_O_O__table_gvk_rjh_trb__entry__2}

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

{#NPushServ-unregisterPushToken_O_S_O_O__table_gvk_rjh_trb}  
Dieses Beispiel zeigt, wie die Registrierung des Push-Benachrichtigungstoken aufgehoben wird, das der TestPushApp-Anwendung zugeordnet ist.

    func unregisterFromPushNotifications(deviceToken: Data) {
      pushService.unregisterPushToken(deviceToken, pushAppName: "TestPushApp", environment: environment) { [weak self] result in
        guard let self = self else { return }
        switch result {
          case .success:
            UserDefaults.standard.set(false, forKey: "pushNotificationsRegistered")
            self.pushRegistrationState = .unregisterSuccess
          case .failure:
            self.pushRegistrationState = .unregisterFailed
        }
      }
    }

## NowPushService -- payloadFromUserInfo(_UserInfo: \[AnyHashable: Beliebig\]) {#ariaid-title4}

Analysiert `Anwenderinformationen `Schlüssel-Wert-Paare zu `Now PushPayload `Objekt.
{#NPushServ_payloadFromUserInfo_O__table_vqs_mkh_trb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| _AnwenderInfo | \[AnyHashable: Beliebig\] | Inhalt der Push-Nutzlast, der als Teil der Push-Benachrichtigung empfangen wurde. |
[Tabelle : 6. Parameter]

{#NPushServ_payloadFromUserInfo_O__table_vqs_mkh_trb} {#NPushServ_payloadFromUserInfo_O__table_wqs_mkh_trb__entry__2}

| Typ | Beschreibung |
|-|-|
| Result\<NowPushPayload, NowPushError\> | Gibt die Ergebnisse der Nutzlastanalyse zurück. * Erfolg: Analysiert `Now PushPayload `Objekt. * Fehler: `Now PushError `-- Informationen zum Fehler, der beim Analysieren der angegebenen Anwendernutzlast aufgetreten ist. Mögliche Werte: * Decodierung: Decodierungsfehler aufgetreten. * HttpRequestFailure: Generischer Fehler, der zurückgegeben wird, wenn der HTTP-Aufruf kein Erfolg ist (2xx). * NotAuthorized: Die anfordernde Person ist nicht berechtigt, den angegebenen Push-Benachrichtigungsvorgang auszuführen. * Nicht supportedData: Push-Nutzlast ist ungültig. {#NPushServ_payloadFromUserInfo_O__ul_pmt_m5h_trb} |
[Tabelle : 7. Rückgaben]

{#NPushServ_payloadFromUserInfo_O__table_wqs_mkh_trb}  
Dieses Beispiel zeigt, wie eine Anwendernutzlast analysiert wird.

    func userNotificationCenter(_ center: UNUserNotificationCenter,
        didReceive response: UNNotificationResponse,
        withCompletionHandler completionHandler: @escaping () -> Void) {
      guard let pushService = pushService else {
        completionHandler()
        return
      }
      let userInfo = response.notification.request.content.userInfo
      _ = pushService.payloadFromUserInfo(userInfo)
        .flatMap(handleNowPushPayload)
    }


    func handleNowPushPayload(_ payload: NowPushPayload) -> Result<Void, NowPushError> {
      guard payload is NowPushVirtualAgent else {
        return .failure(NowPushError.unsupportedData)
      }
      launchVirtualAgent()
      return .success(())
    }


