---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowWeb API - iOS

# NowWeb API - iOS {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

NowWeb API は、ユーザーが NowWeb サービスインスタンスをインスタンス化できるようにするトップレベルのグローバル API です。

## NowWeb - makeWebService(instanceUrl: URL) async throws {#ariaid-title2}

前に指定した構成を使用して NowWebService のインスタンスを作成します。
この関数を呼び出す前に SDK を初期化する必要があり、そうでない場合は完了ブロックが `sdkNotConfigured` エラーで呼び出されます。SDK を初期化するには、必要な構成で NowSDK.configure() を呼び出します。
{#NWeb-makeWebService-async_S__table_wct_ldx_kqb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| instanceUrl | URL | サービスから Web サービスがアクセスされる ServiceNow インスタンスの URL。 |
[表 : 1. パラメーター]

{#NWeb-makeWebService-async_S__table_wct_ldx_kqb} {#NWeb-makeWebService-async_S__table_xct_ldx_kqb__entry__2}

| タイプ | Description (説明) |
|-|-|
| [NowWeb サービス](https://servicenow-prod.fluidtopics.net/pmzK7g3nZQ4vUHv~tc0mhw#NowWebServiceiOSAPI "NowWebService クラスは、ServiceNowインスタンス上の Web ページの参照を可能にする関数を提供します。") | 成功した場合は、初期化された NowWebService オブジェクトを返します。 |
| NowServiceError | メソッドが失敗した場合は、次のいずれかのエラーをスローします。 可能な値： * sdkNotConfigured * serviceConfigurationInvalid * serviceDisabled * serviceSettingsInvalid * serviceSettingsNotFound * serviceSettingsRetrievalFailed |
[表 : 2. 返される内容]

{#NWeb-makeWebService-async_S__table_xct_ldx_kqb}  
次のコード例は、このメソッドを呼び出す方法を示しています。

    do {
        let service = try await NowWeb.makeWebService(instanceUrl: instanceUrl)
        self.webService = service
    } catch {
        debugPrint("Web Service creation failed with error: \(error.localizedDescription)") 
    }

## NowWeb - makeWebService(instanceUrl: URL, completion: @escaping ((Result\<NowWebService, NowServiceError\>) -\> Void)) {#ariaid-title3}

前に指定した構成を使用して NowWebService のインスタンスを作成します。終了すると、指定された完了ハンドラーを呼び出します。
この関数を呼び出す前に SDK を初期化する必要があり、そうでない場合は完了ブロックが `sdkNotConfigured` エラーで呼び出されます。SDK を初期化するには、必要な構成で NowSDK.configure() を呼び出します。
{#NWeb-makeWebService_S_O__table_lry_wbx_kqb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| instanceUrl | URL | サービスから Web サービスがアクセスされる ServiceNow インスタンスの URL。 |
| 完了 | @escaping ((Result\<[NowWebService](https://servicenow-prod.fluidtopics.net/pmzK7g3nZQ4vUHv~tc0mhw#NowWebServiceiOSAPI "NowWebService クラスは、ServiceNowインスタンス上の Web ページの参照を可能にする関数を提供します。"), NowServiceError\>) -\> 無効) | 初期化された `NowWebService` インスタンスまたは初期化が失敗した理由を示す `NowServiceError` のいずれかを含む `Result<NowWebService、NowServiceError>` で呼び出される完了ハンドラー。 |
[表 : 3. パラメーター]

{#NWeb-makeWebService_S_O__table_lry_wbx_kqb} {#NWeb-makeWebService_S_O__table_mry_wbx_kqb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 4. 返される内容]

{#NWeb-makeWebService_S_O__table_mry_wbx_kqb}  
<br />

    func initializeNowSDK(userEmail: String) {
      currentUser = userEmail
      let sdkConfig = NowSDKConfiguration(authorizationProvider: self, permissionDelegate: self, logLevel: .debug)
            
      do {
          try NowSDK.configure(with: sdkConfig)
          configureAnalytics()
      } catch {
          debugPrint("Could not initialize NowSDK. Error: \(error.localizedDescription)")
      }
    }

## NowWeb - makeWebService(instanceUrl: URL) {#ariaid-title4}

前に指定した構成を使用して NowWebService のインスタンスを作成します。
注:  
このメソッドは廃止されました。代わりに、メソッドの async/await 実装を使用する必要があります。

この関数を呼び出す前に SDK を初期化する必要があり、そうでない場合は完了ブロックが `sdkNotConfigured` エラーで呼び出されます。SDK を初期化するには、必要な構成で NowSDK.configure() を呼び出します。
{#NWeb-makeWebService_S__table_wct_ldx_kqb__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| instanceUrl | URL | サービスから Web サービスがアクセスされる ServiceNow インスタンスの URL。 |
[表 : 5. パラメーター]

{#NWeb-makeWebService_S__table_wct_ldx_kqb} {#NWeb-makeWebService_S__table_xct_ldx_kqb__entry__2}

| タイプ | Description (説明) |
|-|-|
| AnyPublisher\<[NowWebService](https://servicenow-prod.fluidtopics.net/pmzK7g3nZQ4vUHv~tc0mhw#NowWebServiceiOSAPI "NowWebService クラスは、ServiceNowインスタンス上の Web ページの参照を可能にする関数を提供します。")、NowServiceError\> | 成功した場合は、初期化された NowWebService オブジェクトを返します。失敗した場合は、NowServiceError オブジェクトを返します。 |
[表 : 6. 返される内容]

{#NWeb-makeWebService_S__table_xct_ldx_kqb}  
<br />

    func initializeWebService() {
      NowWeb.makeWebService(instanceUrl: instanceUrl)
        .sink { completion in
          if case .failure(let error) = completion {
            debugPrint("Web Service creation failed with error: \(error.localizedDescription)")
          }
        } receiveValue: { [weak self] service in
            self?.webService = service
        }
        .store(in: &subscriptions)
      }