--- 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 --- # NowPushService クラス : Android # NowPushService クラス : Android {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分 NowPushService クラスは、プッシュ通知サービスとのやり取りを可能にする関数を提供します。 {#NowPushServiceAndroidAPI__table_vx2_klw_5pb__entry__2} | 名前 | 説明 | |-|-| | 構成 | サービスに関連付けるサービス構成。 データタイプ: [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/kN3GoqTwJ7c0P7uFfos~Dg "NowServiceConfiguration クラスを使用すると、フィーチャ サービスのServiceNow インスタンス URL とパッケージ名を構成できます。") | [表 : 1. プロパティ] {#NowPushServiceAndroidAPI__table_vx2_klw_5pb} ## NowPushService - handlePush(remoteMessage: RemoteMessage, successCallback: Consumer\, errorCallback: Consumer\) {#ariaid-title2} プッシュ通知要求を処理します。 注: 現在実装されているプッシュ通知タイプは `NowPushVirtualAgent` だけです。他の渡されたプッシュ通知タイプはすべて、 [NotSupportedPushError](https://servicenow-prod.fluidtopics.net/Ff_pWEi9RXvYPK9H82JNAw#NotSupportedPushErrorAndroidAPI "NowPushSDK がプッシュ通知要求を処理できない場合、 NotSupportedPushError クラスの関数がスローされます。このタイプのエラーがスローされた場合は、MobileSDK フレームワークの外部でプッシュ通知を解析して処理する必要があります。") オブジェクトを返します。 {#NPushServ-handlePush_S_O_O__table_aly_nvk_nrb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | リモートメッセージ | [リモートメッセージ](https://firebase.google.com/docs/reference/android/com/google/firebase/messaging/RemoteMessage) | `com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived` によって受信された通知。詳細については、「 [Android アプリでメッセージを受信する」](https://firebase.google.com/docs/cloud-messaging/android/receive)を参照してください。 | | 成功 コールバック | [コンシューマー](https://developer.android.com/reference/kotlin/java/util/function/Consumer) \<[NowPushPayload](https://servicenow-prod.fluidtopics.net/V5bh6iXm2EMLczeHdzqL2Q#NowPushPayloadAndroidInterface "NowPushPayload インターフェイスは、NowSDK が実装するプッシュ通知ペイロードを定義します。")\> | 処理済み NowPushPayload を返すコールバック。 | | エラーコールバック | [コンシューマー](https://developer.android.com/reference/kotlin/java/util/function/Consumer) \<[スロー可能\>](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/) | スローされたエラーを返すコールバック。エラー [NotSupportedPushError](https://servicenow-prod.fluidtopics.net/Ff_pWEi9RXvYPK9H82JNAw#NotSupportedPushErrorAndroidAPI "NowPushSDK がプッシュ通知要求を処理できない場合、 NotSupportedPushError クラスの関数がスローされます。このタイプのエラーがスローされた場合は、MobileSDK フレームワークの外部でプッシュ通知を解析して処理する必要があります。") がスローされた場合、通知タイプは Mobile SDK でサポートされておらず、Mobile SDK フレームワークの外部で処理する必要があります。 | [表 : 2. パラメーター] {#NPushServ-handlePush_S_O_O__table_aly_nvk_nrb} {#NPushServ-handlePush_S_O_O__table_bly_nvk_nrb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 3. 返される内容] {#NPushServ-handlePush_S_O_O__table_bly_nvk_nrb} この例では、 onMessageReceived() をオーバーライドして、 RemoteMessage を `NowPushService` に渡す方法を示します。`NowPushService` は、通知タイプを認識すると、要求を処理し、アプリケーションが処理する通知オブジェクトを返します。それ以外の場合は [、NotSupportedPushError](https://servicenow-prod.fluidtopics.net/Ff_pWEi9RXvYPK9H82JNAw#NotSupportedPushErrorAndroidAPI "NowPushSDK がプッシュ通知要求を処理できない場合、 NotSupportedPushError クラスの関数がスローされます。このタイプのエラーがスローされた場合は、MobileSDK フレームワークの外部でプッシュ通知を解析して処理する必要があります。") をスローします。 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: String, pushApp: String, successCallback: Runnable, errorCallback: Consumer\) {#ariaid-title3} 現在のAndroidデバイスおよび指定されたアプリケーションのプッシュ通知を識別するために使用する一意のFirebaseServiceNowトークンを インスタンスに登録します。 ServiceNowインスタンスが通知を生成し、デバイスAndroidアプリケーションから通知を受信するには、このトークンを登録する必要があります。 {#NPushServ-registerPushToken_S_S_O_O__table_zhp_ccl_nrb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | プッシュトークン | 文字列 | Firebase[com.google.firebase.messaging.FirebaseMessaging.getToken](https://firebase.google.com/docs/reference/js/v8/firebase.messaging.Messaging#gettoken) または [com.google.firebase.messaging.FirebaseMessagingService.onNewToken](https://firebase.google.com/docs/cloud-messaging/android/client) によって取得されるトークン。 | | プッシュアプリ | 文字列 | 関連付けられた ServiceNow インスタンスのプッシュアプリケーションテーブルで指定されたプッシュアプリケーションの名前。 | | 成功 コールバック | [実行可能ファイル](https://developer.android.com/reference/kotlin/java/lang/Runnable.html) | トークンの登録に成功したときに実行されるコールバック。 | | エラーコールバック | [コンシューマー](https://developer.android.com/reference/kotlin/java/util/function/Consumer) \<[スロー可能\>](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/) | トークンの登録に失敗したときに実行されるコールバック。 | [表 : 4. パラメーター] {#NPushServ-registerPushToken_S_S_O_O__table_zhp_ccl_nrb} {#NPushServ-registerPushToken_S_S_O_O__table_a3p_ccl_nrb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 5. 返される内容] {#NPushServ-registerPushToken_S_S_O_O__table_a3p_ccl_nrb} この例では、現在の Android デバイスとアプリケーション「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: String, pushApp: String, successCallback: Runnable, errorCallback: Consumer\) {#ariaid-title4} 指定された Firebase プッシュトークンを関連する ServiceNow インスタンスで登録解除します。 {#NPushServ-unregPushToken_S_S_O_O__table_ywx_bgl_nrb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | プッシュトークン | 文字列 | Firebase 登録解除するトークン。[com.google.firebase.messaging.FirebaseMessaging.getToken](https://firebase.google.com/docs/reference/js/v8/firebase.messaging.Messaging#gettoken) または [com.google.firebase.messaging.FirebaseMessagingService.onNewToken](https://firebase.google.com/docs/cloud-messaging/android/client) によって取得されます。 | | プッシュアプリ | 文字列 | 登録解除するトークンに関連付けられたプッシュアプリケーションの名前。この情報は、関連付けられた ServiceNow インスタンスのプッシュアプリケーションテーブルに格納されます。 | | 成功 コールバック | [実行可能ファイル](https://developer.android.com/reference/kotlin/java/lang/Runnable.html) | トークンの登録解除に成功したときに実行されるコールバック。 | | エラーコールバック | [コンシューマー](https://developer.android.com/reference/kotlin/java/util/function/Consumer) \<[スロー可能\>](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/) | トークンの登録解除に失敗したときに実行されるコールバック。 | [表 : 6. パラメーター] {#NPushServ-unregPushToken_S_S_O_O__table_ywx_bgl_nrb} {#NPushServ-unregPushToken_S_S_O_O__table_zwx_bgl_nrb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 7. 返される内容] {#NPushServ-unregPushToken_S_S_O_O__table_zwx_bgl_nrb} このコード例は、ユーザーがアプリケーションからログアウトしたときなどにプッシュトークンを登録解除する方法を示しています。 pushService.unregisterPushtoken(token, "PushAppName", { Log.v(TAG, "Successfully unregistered push token") }, { e -> Log.e(TAG, "Error unregistering push", e) })