---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# iOSアプリケーションでのプッシュ通知の設定

# iOSアプリケーションでのプッシュ通知の設定 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

プッシュ通知を設定するために ServiceNow インスタンスで実行する必要があるタスクに加えて、 iOS アプリケーションに特定のコードを含める必要もあります。

## NowSDK NowPushService の作成 {#mobsdk-ios-setup-push-app__section_hyb_zxp_prb}

アプリケーションで最初に行う必要があることの 1 つは、 `NowPushService` を作成することです。`NowPush` SDK は、このサービスを作成するためのファクトリ関数を提供します。次のスニペットのようなコードをメインコード本文の早い段階で追加します。

    func setup(with instanceURL: URL) -> AnyPublisher<NowService, ConfigurationError> {
      NowPush.makePushService(instanceUrl: instanceURL)
        .mapError { .sdkError($0) }
        .map { $0 as NowService }
        .eraseToAnyPublisher()
    }

NowPush.makePushService() メソッドの詳細については、「[NowPush API - iOS](https://servicenow-prod.fluidtopics.net/hUZP9DQFu36zXqdHscS40g#NowPushiOSAPI "NowPush API は、ユーザーが NowPush サービスインスタンスをインスタンス化できるようにするトップレベルのグローバル API です。")」を参照してください。

## プッシュトークンを登録する {#mobsdk-ios-setup-push-app__section_kyr_4cq_prb}

Apple は、プッシュ通知を受信するデバイスとアプリケーションを識別する一意のプッシュ通知トークンを提供します。アプリケーションがプッシュ通知を受信できるようにするには、 `NowPushService` を使用してこのトークンを登録する必要があります。iOSアプリケーションに次のような関数を追加します。このアプリケーションは、 ServiceNow インスタンスに登録する必要があります。

    func registerForPushNotifications(deviceToken: Data) {
      pushService.registerPushToken(deviceToken,
          pushAppName: "TestPushApp", // Modify this to be your iOS application name
          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
        }
      }
    }

registerPushToken() メソッドの詳細については、「[NowPushService - registerPushToken(_token: Data, pushAppName: String, environment: NowPushEnvironment, completion: @escaping (Result\<Data, NowPushError\>) -\> Void)](https://servicenow-prod.fluidtopics.net/CjGCHQjp7nwpjxJ~E3haeg#NPushServ-registerPushToken_O_S_O_O "現在のiOSデバイスと指定されたアプリケーションのプッシュ通知を識別するために使用される一意のトークンをServiceNowインスタンスに登録します。")」を参照してください。

## プッシュトークンを登録解除

ユーザーがログアウトするときなど、ユーザーがアプリケーションを終了するたびに、プッシュトークンの登録を解除する必要があります。プッシュトークンを登録解除するには、次のコードスニペットのようなコードを使用します。pushAppNameをiOSアプリケーションの名前に変更してください。

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

unregisterPushToken() メソッドの詳細については、「[NowPushService - unregisterPushToken(_token: Data, pushAppName: String, environment: NowPushEnvironment, completion: @escaping (Result\<Data, NowPushError\>) -\> Void)](https://servicenow-prod.fluidtopics.net/CjGCHQjp7nwpjxJ~E3haeg#NPushServ-unregisterPushToken_O_S_O_O "以前に登録したプッシュトークンを登録解除します。")」を参照してください。

## プッシュペイロードを解析 {#mobsdk-ios-setup-push-app__section_ofn_dlw_trb}

情報を収集し、アプリケーションの他の部分でデータを使用するには、プッシュ通知ペイロードを `NowPushPayload` オブジェクトに解析する必要があります。現在、これは仮想エージェントプッシュ通知でのみ使用できます。次のようなコードを使用します

    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(())
    }