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


---

# ServiceNow インスタンスでのパブリック REST API とのやり取り

# ServiceNow インスタンスでのパブリック REST API とのやり取り {#ariaid-title1}

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

この Mobile SDK は、 Android アプリケーションが ServiceNow インスタンスでパブリック REST API を呼び出せるようにする機能を提供します。
[NowAPIService](https://servicenow-prod.fluidtopics.net/Ji0OkzojFrD4aUiGF3aWjQ#NowAPIServiceAndroidInterface "NowAPIService インターフェイスは、指定された ServiceNow REST API で要求を実行する機能を提供します。") API を使用すると、ベース [ServiceNowパブリック REST API](https://servicenow-prod.fluidtopics.net/t8fFT9Nlw4YRtSQ0g5Fwow "REST インターフェイスを使用して、インスタンス上のデータにアクセスします。") とやり取りしたり、インスタンス内にカスタム REST API を作成して Android アプリケーションからそれらを呼び出したりすることができます。

ServiceNow REST API を呼び出す前に、[makeNowAPIService()](https://servicenow-prod.fluidtopics.net/nGOLq8n4~_LupXJmSN9rEg#NDataSDK-makeNowAPIService_S_O_O "NowAPIService サービスのインスタンスを作成して初期化します。このサービスを使用すると、 ServiceNow インスタンスによって公開されているパブリック REST API にアクセスできます。") メソッドを呼び出してサービスのインスタンスを作成する必要があります。サービスインスタンスはコールバックで返され、成功した場合はエラーがスローされます。  
NowAPIService オブジェクトを初期化する方法を次に示します。

    /**
     * Helper class used to handle different Now service instances. It has an application scope or is Singleton
     */
    @Singleton
    class SdkManager @Inject constructor() {

        private var nowApiService: NowAPIService? = null

        /**
         * Create the NowAPIService once in the lifetime of the application inside the Application class or another manager class
         * that will be injected into other classes via dagger/hilt.
         * NowAPIService should be created after initializing the NowSDK
         */
        suspend fun getNowApiService(): NowAPIService? {
            if (nowApiService != null) return nowApiService

            return NowDataSDK.makeAPIService(URL("https://instance-name.service-now.com")).getOrThrow()
                .also { this.nowApiService = it }
        }

    }

NowAPIService オブジェクトが初期化されたら、NowAPIService [data()](https://servicenow-prod.fluidtopics.net/Ji0OkzojFrD4aUiGF3aWjQ#NAPIServ-data_S_S_S_S "指定された ServiceNow インスタンスで指定された REST API を呼び出します。") メソッドを使用して、呼び出す REST エンドポイントとそれに関連するすべてのパラメーターを指定します。

     suspend fun makeNowApiCall() {
      val apiService = sdkManager.getNowApiService()

      val apiPath = "api/now/table/sn_customerservice_case"
      val endpoint = NowAPIService.Endpoint(HttpMethod.GET, apiPath, true)
      val fieldNames = "sys_id,number,short_description,number,priority,state," +
        "opened_at,account.name,account.number,contact.name,contact.email," +
        "contact_type,assignment_group.name,assigned_to.name"

      val queryParamsMap = mapOf("sysparm_fields" to fieldNames, "sysparm_limit" to "10")

      val queryParams = QueryParams.Builder().addAll(queryParamsMap).build()

      val response = runCatching {
        apiService?.data(endpoint = endpoint, queryParams = queryParams)?.execute()
      }

      if (response.isSuccess) {
        val resultString = response.getOrNull()?.body?.let { String(it) }
      } else {
        // Handle error
      }
    }