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


---

# プッシュインストール API

# プッシュインストール API {#ariaid-title1}

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

プッシュインストール API は、モバイルデバイスがアプリケーションからプッシュ通知を受信できるようにするトークンを登録および登録解除するためのエンドポイントを提供します。
プッシュ通知は、重要なことを知らせる、またはアクションの実行を要求する、ユーザーのモバイル端末に表示されるテキスト メッセージです。

カスタムモバイルアプリケーションを作成する場合、プッシュ通知を設定するには、デバイスを製造元のサービスに登録する必要があります。サービスは、プッシュトークンを使用してそのデバイスに通知を適切に送信できるように、ユーザーのデバイスのアドレスを認識する必要があります。また、デバイスは通知を受信し、それに基づいて処理できる必要があります。デバイスを登録してプッシュトークンを取得する方法については、デバイスのオペレーティングシステムの開発者向けドキュメントを参照してください。たとえば、Apple デバイスについては、「 <https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns>」を参照してください。

## プッシュインストール:POST /now/push/{pushApplicationName}/installation {#ariaid-title2}

指定したアプリケーションからプッシュ通知を受信できるようにするためのトークンを追加または更新します。

### URL 形式 {#push-POST-installation__section_x12_fqg_dmb}

バージョニングされた URL: /api/now/{api_version}/push/{pushApplicationName}/installation

デフォルト URL: /api/now/push/{pushApplicationName}/installation  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#push-POST-installation__entry__2}{#push-POST-installation__version-not_optional-RESTAPI}

| パラメーター | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| プッシュアプリケーション名 | プッシュ通知を登録するアプリケーションの名前。このパラメーターは、関連するアプリケーションの \[名前\] 列の値と同じにする必要があります。 データタイプ：文字列 テーブル:プッシュアプリケーション \[sys_push_application\] |
[表 : 1. パスパラメーター]

{#push-POST-installation__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 2. クエリパラメーター]

{#push-POST-installation__entry__12}

| 要素 | 説明 |
|-|-|
| プラットフォーム | プッシュ通知を登録するプラットフォーム。 データタイプ：文字列 テーブル:プッシュプラットフォーム \[sys_push_platform\] テーブルの \[名前\] フィールド内。 |
| トークン | モバイルアプリケーションがプッシュ通知を受信するために登録するときに、Apple などのデバイスメーカーから提供されるトークン。 データタイプ：文字列 保存場所:プッシュ通知インストール \[sys_push_notif_app_install\] |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#push-POST-installation__entry__18}{#push-POST-installation__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 4. 要求ヘッダー]

{#push-POST-installation__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#push-POST-installation__entry__26}{#push-POST-installation__entry-200-status-code}{#push-POST-installation__entry-401-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー。サーバー側のコードでロジックエラーが発生しました。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#push-POST-installation__entry__36}

| 名前 | 説明 |
|-|-|
| なし |   |
[ ]

### cURL 要求のサンプル

    curl -X POST \
      https://instance.servicenow.com/api/now/push/ServiceNowPushApp/installation \
    --header "Content-Type: application/json" \
    --user "username":"password" \
    --data '{"platform":"Apple","token":"544836d77ac2e551bbf78204630509a7d494fc87f52e85da52e5b5d42910e2cf"}' \

    None

## プッシュインストール:POST /now/push/{pushApplicationName}/removeInstallation {#ariaid-title3}

モバイルデバイスが指定されたアプリケーションからプッシュ通知を受信できるようにするトークンを非アクティブ化します。

### URL 形式 {#push-POST-removeInstallation__section_uy3_drg_dmb}

バージョニングされた URL: /api/now/{api_version}/push/{pushApplicationName}/removeInstallation

デフォルト URL: /api/now/push/{pushApplicationName}/removeInstallation  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#push-POST-removeInstallation__entry__2}{#push-POST-removeInstallation__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| プッシュアプリケーション名 | プッシュ通知を登録解除するアプリケーションの名前。 データタイプ：文字列 テーブル:プッシュアプリケーション \[sys_push_application\] テーブルの関連アプリケーションの \[名前\] フィールド。 |
[表 : 7. パスパラメーター]

{#push-POST-removeInstallation__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 8. クエリパラメーター]

{#push-POST-removeInstallation__entry__12}

| 要素 | 説明 |
|-|-|
| プラットフォーム | プッシュ通知を登録するプラットフォーム。 データタイプ：文字列 テーブル:プッシュプラットフォーム \[sys_push_platform\] テーブルの \[名前\] フィールド内。 |
[表 : 9. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#push-POST-removeInstallation__entry__16}{#push-POST-removeInstallation__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 10. 要求ヘッダー]

{#push-POST-removeInstallation__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#push-POST-removeInstallation__entry__24}{#push-POST-removeInstallation__entry-200-status-code}{#push-POST-removeInstallation__entry-401-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー。サーバー側のコードでロジックエラーが発生しました。 |
[表 : 12. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#push-POST-removeInstallation__entry__34}

| 名前 | 説明 |
|-|-|
| なし |   |
[ ]

### cURL 要求のサンプル

    curl -X POST \
      https://instance.servicenow.com/api/now/push/ServiceNowPushApp/removeInstallation \
    --header "Content-Type: application/json" \
    --user "username":"password" \
    --data '{"platform":"Apple"}' \

    None