---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowCoreService 클래스 - iOS

# NowCoreService 클래스 - iOS {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 12분

NowCoreService 클래스는 다양한 SDK 기능 서비스에 기본 서비스를 제공합니다. 이 클래스는 NowSDK에 의해서만 인스턴스화되어야 합니다.

Now Analytics 및 NowChat과 같은 기능 서비스는 NowSDK.core 속성을 통해 공유 코어 인스턴스에 액세스할 수 있습니다.

## NowCoreService - accessTokenDidFail(서비스의 경우: NowService) {#ariaid-title2}

지정된 서비스의 인스턴스에 대한 ServiceNow API 요청을 승인하는 데 사용되는 액세스 토큰이 더 이상 유효하지 않음을 SDK 코어에 알립니다.
SDK 코어는 유효한 액세스 토큰을 생성할 수 있거나 오류를 반환하는 경우 유효한 액세스 토큰을 반환합니다.  
주:  
이 방법은 더 이상 사용되지 않습니다. 대신 메서드의 async/await 구현을 사용해야 합니다.
{#NCoreServ-accessTokenDidFail_O__table_p5n_vcb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | [Now서비스](https://servicenow-prod.fluidtopics.net/PbzBMM1l7IQ5OtjiNCv5Ig#NowServiceiOSProtocol "NowService 프로토콜은 모든 기능 서비스에 대해 NowSDK에 대한 단일 인터페이스를 제공합니다. 인스턴스에 액세스하는 데 필요한 구성 매개변수를 정의합니다 ServiceNow .") | 접근 토큰을 요청하는 기능 서비스입니다. |
[표 1. 매개변수]

{#NCoreServ-accessTokenDidFail_O__table_p5n_vcb_npb} {#NCoreServ-accessTokenDidFail_O__table_q5n_vcb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| AnyPublisher\<NowSDK.AccessToken, AccessTokenProviderError\> | 성공: 올바른 접근 토큰입니다. 실패: AccessTokenProviderError 가능한 값: * userSessionError * accessTokenRetrievalFailed * hostReturnedNoTokens - 게스트 사용자를 나타냅니다. |
[표 2. 반환]

{#NCoreServ-accessTokenDidFail_O__table_q5n_vcb_npb}  
<br />

    NowSDK.core()?.accessTokenDidFail(for: someService)
      .mapError { YourCustomError.accessTokenFailed($0) }

    .flatMap(self.handleFailedAccessToken())
      .eraseToAnyPublisher()

## NowCoreService - accessTokenDidFail(서비스의 경우: NowService) 비동기 throw {#ariaid-title3}

지정된 서비스의 인스턴스에 대한 ServiceNow API 요청을 승인하는 데 사용되는 액세스 토큰이 더 이상 유효하지 않음을 SDK 코어에 알립니다.
SDK 코어는 유효한 액세스 토큰을 생성할 수 있거나 오류를 반환하는 경우 유효한 액세스 토큰을 반환합니다.
{#NCoreServ-accessTokDidFail-async_O__table_p5n_vcb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | [Now서비스](https://servicenow-prod.fluidtopics.net/PbzBMM1l7IQ5OtjiNCv5Ig#NowServiceiOSProtocol "NowService 프로토콜은 모든 기능 서비스에 대해 NowSDK에 대한 단일 인터페이스를 제공합니다. 인스턴스에 액세스하는 데 필요한 구성 매개변수를 정의합니다 ServiceNow .") | 접근 토큰을 요청하는 기능 서비스입니다. |
[표 3. 매개변수]

{#NCoreServ-accessTokDidFail-async_O__table_p5n_vcb_npb} {#NCoreServ-accessTokDidFail-async_O__table_q5n_vcb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| NowSDK.AccessToken | 메서드가 성공하면 반환됩니다. 올바른 접근 토큰입니다. |
| AccessTokenProviderError | 메서드가 실패할 때 throw됩니다. 액세스 토큰을 검색하는 동안 오류가 발생했음을 나타냅니다. 가능한 값: * userSessionError * accessTokenRetrievalFailed * hostReturnedNoTokens - 게스트 사용자를 나타냅니다. |
[표 4. 반환]

{#NCoreServ-accessTokDidFail-async_O__table_q5n_vcb_npb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    do {
        let accessToken = try await NowSDK.core()?.accessTokenDidFail(for: someService)
    } catch {
        self.handleFailedAccessToken(error)
    }

## NowCoreService - canRequestPermission(_ permission: DevicePermission) {#ariaid-title4}

서비스가 장치 권한을 요청할 수 있는지 여부를 호스트 애플리케이션에 쿼리합니다.
이 함수는 권한을 요청하지 않고, 장치 권한을 쿼리할 수 있는지 여부만 요청합니다. 피처 서비스는 이 함수를 호출하여 원하는 장치 권한을 요청할 수 있는지 여부를 확인해야 합니다.
{#NCoreServ-canReqPermission_S__table_t4p_c1b_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 권한 | 장치 권한 | 요청이 이루어지는 장치입니다. 가능한 값(대/소문자 구분): * 카메라 * 위치 * 마이크 * 사진 라이브러리 * 스피치 인식 |
[표 5. 매개변수]

{#NCoreServ-canReqPermission_S__table_t4p_c1b_npb} {#NCoreServ-canReqPermission_S__table_u4p_c1b_npb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 호스트 애플리케이션에서 SDK가 지정된 디바이스 권한을 요청할 수 있도록 허용하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 장치 권한을 요청할 수 있습니다. * 아니오: 장치 권한을 요청할 수 없습니다. |
[표 6. 반환]

{#NCoreServ-canReqPermission_S__table_u4p_c1b_npb}  
<br />

    extension AppDelegate: DevicePermissionDelegate {
      func canRequestPermission(_ permission: DevicePermission) -> Bool {
        return true
      }
    }

## NowCoreService - isGuestUser(서비스용: NowService) 비동기 {#ariaid-title5}

현재 사용자가 게스트 사용자인지 확인합니다.
{#NCoreServ-isGuestUser-async_O__table_ugj_4w2_lxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | Now서비스 | 게스트 사용자 확인을 수행할 기능 서비스입니다. |
[표 7. 매개변수]

{#NCoreServ-isGuestUser-async_O__table_ugj_4w2_lxb} {#NCoreServ-isGuestUser-async_O__table_vgj_4w2_lxb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자가 게스트 사용자인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 지정된 서비스의 현재 사용자가 게스트 사용자입니다. * false: 지정된 서비스의 현재 사용자가 게스트 사용자가 아닙니다. |
[표 8. 반환]

{#NCoreServ-isGuestUser-async_O__table_vgj_4w2_lxb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    let isGuestUser = await NowSDK.core()?.isGuestUser(for: someService)

## NowCoreService - refreshAllSettings() {#ariaid-title6}

활성 서버에서 다시 가져와 모든 서비스에 대한 모든 SDK 설정을 새로 고칩니다.
새로 고칠 때마다 업데이트된 SDK 설정 값을 받으려면 함수에서 제공하는 게시자를 구독합니다 [NowCoreService - settingsPublisher(서비스의 경우: NowService)](https://servicenow-prod.fluidtopics.net/9lvnGNDWVn1fjUmjA7r4ZA#NCoreServ-settingsPublisher_O "지정된 서비스의 게시자에 대한 설정을 검색합니다.") .
{#NCoreServ-refreshAllSettings__table_ckb_zgb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 9. 매개변수]

{#NCoreServ-refreshAllSettings__table_ckb_zgb_npb} {#NCoreServ-refreshAllSettings__table_dkb_zgb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 10. 반환]

{#NCoreServ-refreshAllSettings__table_dkb_zgb_npb}  
<br />

    NowSDK.core()?.refreshAllSettings()

## NowCoreService - refreshSettings(서비스용: NowService) {#ariaid-title7}

서버에서 지정된 서비스에 대한 SDK 설정을 다시 가져와 새로 고칩니다.
주:  
이 방법은 더 이상 사용되지 않습니다. 대신 메서드의 async/await 구현을 사용해야 합니다.
{#NCoreServ-refreshSettings_S__table_qv3_knb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | Now서비스 | 설정 새로 고침을 요청하는 NowChat 또는 NowAnalytics와 같은 기능 서비스입니다. |
[표 11. 매개변수]

{#NCoreServ-refreshSettings_S__table_qv3_knb_npb} {#NCoreServ-refreshSettings_S__table_rv3_knb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| AnyPublisher\<설정, SettingsError\> | 성공: 새로 고침된 SDK 설정의 딕셔너리입니다. 기능 서비스는 반환된 데이터에서 특정 기능과 관련된 설정을 검사해야 합니다. 실패: SettingsError - 발생한 오류의 유형 및 설명입니다. 가능한 값: * fetchError * fetch실패 * invalidJSON * invalid공급자 * 인증되지 않음 * sdk라이센스 없음 * settingNotFound * 알 수 없음 |
[표 12. 반환]

{#NCoreServ-refreshSettings_S__table_rv3_knb_npb}  
<br />

    var subscriptions = Set<AnyCancellable>()
    NowSDK.core?.refreshSettings(for: someService)
      .sink(receiveCompletion: { completion in
        if case .failure(let error) = completion {
          print("Refresh failed with error:\ (error)")
        }
      }, receiveValue: { settings in
        print("Received refreshed settings:\ (settings)")
      })
      .store(in: &subscriptions)

## NowCoreService - refreshSettings(서비스용: NowService) 비동기 throw {#ariaid-title8}

서버에서 지정된 서비스에 대한 SDK 설정을 다시 가져와 새로 고칩니다.
{#NCoreServ-refreshSettings-async_S__table_qv3_knb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | Now서비스 | 설정 새로 고침을 요청하는 NowChat 또는 NowAnalytics와 같은 기능 서비스입니다. |
[표 13. 매개변수]

{#NCoreServ-refreshSettings-async_S__table_qv3_knb_npb} {#NCoreServ-refreshSettings-async_S__table_rv3_knb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| 설정 | 메서드가 성공하면 반환됩니다. 새로 고침된 SDK 설정의 딕셔너리입니다. 기능 서비스는 반환된 데이터에서 특정 기능과 관련된 설정을 검사해야 합니다. |
| 설정오류 | 메서드가 실패할 때 throw됩니다. 가능한 값: * fetchError * fetch실패 * invalidJSON * invalid공급자 * 인증되지 않음 * sdk라이센스 없음 * settingNotFound * 알 수 없음 |
[표 14. 반환]

{#NCoreServ-refreshSettings-async_S__table_rv3_knb_npb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    do {
        let settings = try await NowSDK.core()?.refreshSettings(for: someService)
        print("Received refreshed settings: \(settings)")
    } catch {
        print("Refresh failed with Settings error: \(error)")
    }

## NowCoreService - requestAccessToken(서비스용: NowService) {#ariaid-title9}

지정된 서비스에 대한 접근 토큰을 획득합니다.
주:  
이 방법은 더 이상 사용되지 않습니다. 대신 메서드의 async/await 구현을 사용해야 합니다.
{#NCoreServ-requestAccessToken_O__table_dt1_ftb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | [Now서비스](https://servicenow-prod.fluidtopics.net/PbzBMM1l7IQ5OtjiNCv5Ig#NowServiceiOSProtocol "NowService 프로토콜은 모든 기능 서비스에 대해 NowSDK에 대한 단일 인터페이스를 제공합니다. 인스턴스에 액세스하는 데 필요한 구성 매개변수를 정의합니다 ServiceNow .") | 접근 토큰을 요청하는 기능 서비스입니다. |
[표 15. 매개변수]

{#NCoreServ-requestAccessToken_O__table_dt1_ftb_npb} {#NCoreServ-requestAccessToken_O__table_et1_ftb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| AnyPublisher\<NowSDK.AccessToken, AccessTokenProviderError\> | 성공: NowSDK.AccessToken - 인스턴스에 대한 API 요청을 승인하는 데 사용할 액세스 토큰입니다.ServiceNow 실패: AccessTokenProviderError - 발생한 오류의 유형 및 설명입니다. 가능한 값: * accessTokenRetrievalFailed * hostReturnedNoTokens - 게스트 사용자를 나타냅니다. * userSessionError |
[표 16. 반환]

{#NCoreServ-requestAccessToken_O__table_et1_ftb_npb}  
<br />

    NowSDK.core()?.requestAccessToken(for: someService)

## NowCoreService - requestAccessToken(서비스의 경우: NowService) 비동기 throw {#ariaid-title10}

지정된 서비스에 대한 접근 토큰을 획득합니다.
{#NCoreServ-requestAccessToken-async_O__table_dt1_ftb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | [Now서비스](https://servicenow-prod.fluidtopics.net/PbzBMM1l7IQ5OtjiNCv5Ig#NowServiceiOSProtocol "NowService 프로토콜은 모든 기능 서비스에 대해 NowSDK에 대한 단일 인터페이스를 제공합니다. 인스턴스에 액세스하는 데 필요한 구성 매개변수를 정의합니다 ServiceNow .") | 접근 토큰을 요청하는 기능 서비스입니다. |
[표 17. 매개변수]

{#NCoreServ-requestAccessToken-async_O__table_dt1_ftb_npb} {#NCoreServ-requestAccessToken-async_O__table_et1_ftb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| NowSDK.AccessToken | 메서드가 성공하면 반환됩니다. 인스턴스에 대한 API 요청을 승인하는 데 사용할 접근 토큰입니다.ServiceNow |
| AccessTokenProviderError | 메서드가 실패할 때 throw됩니다. 액세스 토큰을 검색하는 동안 오류가 발생했음을 나타냅니다. 가능한 값: * accessTokenRetrievalFailed * hostReturnedNoTokens - 게스트 사용자를 나타냅니다. * userSessionError |
[표 18. 반환]

{#NCoreServ-requestAccessToken-async_O__table_et1_ftb_npb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    do {
        let accessToken = try await NowSDK.core()?.requestAccessToken(for: someService)
    } catch {
        self.handleFailedAccessToken(error)
    }

## NowCoreService - requestNetworkService(서비스용: NowService) {#ariaid-title11}

API 요청을 수행하는 데 사용할 수 있는 공유 네트워크 서비스에 대한 참조를 반환합니다.
주:  
공유 서비스입니다. 설정을 변경하거나 세션을 종료하면 이 세션을 공유하는 다른 기능 서비스에 문제가 발생할 수 있습니다.
{#NCoreServ-reqNetworkService_O__table_zmb_tpb_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | [Now서비스](https://servicenow-prod.fluidtopics.net/PbzBMM1l7IQ5OtjiNCv5Ig#NowServiceiOSProtocol "NowService 프로토콜은 모든 기능 서비스에 대해 NowSDK에 대한 단일 인터페이스를 제공합니다. 인스턴스에 액세스하는 데 필요한 구성 매개변수를 정의합니다 ServiceNow .") | 네트워크 서비스를 요청하는 기능 서비스입니다. |
[표 19. 매개변수]

{#NCoreServ-reqNetworkService_O__table_zmb_tpb_npb} {#NCoreServ-reqNetworkService_O__table_dkb_zgb_npb__entry__2}

| 유형 | 설명 |
|-|-|
| 네트워크 서비스 | API 호출을 수행하는 데 사용할 수 있는 공유 네트워크 서비스입니다. |
[표 20. 반환]

{#NCoreServ-reqNetworkService_O__table_dkb_zgb_npb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    NowSDK.core()?.settingsPublisher(for: chatService)
    .sink(receiveCompletion: { completion in
      if case .failure(let error) = completion {
        // Setting publisher failed with error
      }
    }, receiveValue: { updatedSettings in
      // Receive array of SDK settings for chatService
    })
    .store(in: &subscriptions)

## NowCoreService - requestSettings(forservice: NowService) {#ariaid-title12}

지정된 기능 서비스에 대한 SDK 설정을 반환합니다.
주:  
이 방법은 더 이상 사용되지 않습니다. 대신 메서드의 async/await 구현을 사용해야 합니다.
{#NCoreServ-requestSettings_O__table_qwv_s5b_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| forservice | Now서비스 | 설정을 요청하는 기능 서비스입니다. |
[표 21. 매개변수]

{#NCoreServ-requestSettings_O__table_qwv_s5b_npb} {#NCoreServ-requestSettings_O__table_rwv_s5b_npb__entry__2}

| 유형 | 설명 |
|-|-|
| AnyPublisher\<설정, SettingsError\> | 성공: 설정 - 지정된 피처 서비스에 대한 SDK 설정의 배열입니다. 실패: SettingsError - 관련 오류의 유형 및 설명입니다. 가능한 값: * fetchError * fetch실패 * invalidJSON * invalid공급자 * 인증되지 않음 * sdk라이센스 없음 * settingNotFound * 알 수 없음 |
[표 22. 반환]

{#NCoreServ-requestSettings_O__table_rwv_s5b_npb}  
<br />

    NowSDK.core()?.requestSettings(for: someService)

## NowCoreService - requestSettings(서비스용: NowService) 비동기 발생 {#ariaid-title13}

지정된 기능 서비스에 대한 SDK 설정을 반환합니다.
{#NCoreServ-requestSettings-async_O__table_qwv_s5b_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | Now서비스 | 설정을 요청하는 기능 서비스입니다. |
[표 23. 매개변수]

{#NCoreServ-requestSettings-async_O__table_qwv_s5b_npb} {#NCoreServ-requestSettings-async_O__table_rwv_s5b_npb__entry__2}

| 유형 | 설명 |
|-|-|
| 설정 | 메서드가 성공하면 반환됩니다. 지정된 기능 서비스에 대한 SDK 설정의 배열입니다. |
| 설정오류 | 메서드가 실패할 때 throw됩니다. 관련 오류의 유형 및 설명입니다. 가능한 값: * fetchError * fetch실패 * invalidJSON * invalid공급자 * 인증되지 않음 * sdk라이센스 없음 * settingNotFound * 알 수 없음 |
[표 24. 반환]

{#NCoreServ-requestSettings-async_O__table_rwv_s5b_npb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    do {
        let settings = try await NowSDK.core()?.requestSettings(for: someService)
        print("Received settings: \(settings)")
    } catch {
        print("Refresh saved with Settings error: \(error)")
    }

## NowCoreService - settingsPublisher(서비스의 경우: NowService) {#ariaid-title14}

지정된 서비스의 게시자에 대한 설정을 검색합니다.
{#NCoreServ-settingsPublisher_O__table_jbw_j1c_npb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 서비스용 | [NowService 프로토콜 - iOS](https://servicenow-prod.fluidtopics.net/PbzBMM1l7IQ5OtjiNCv5Ig#NowServiceiOSProtocol "NowService 프로토콜은 모든 기능 서비스에 대해 NowSDK에 대한 단일 인터페이스를 제공합니다. 인스턴스에 액세스하는 데 필요한 구성 매개변수를 정의합니다 ServiceNow .") | 게시자 구독을 요청하는 기능 서비스입니다. |
[표 25. 매개변수]

{#NCoreServ-settingsPublisher_O__table_jbw_j1c_npb} {#NCoreServ-settingsPublisher_O__table_kbw_j1c_npb__entry__2}

| 유형 | 설명 |
|-|-|
| AnyPublisher\<설정, 안 함\> | 성공: 설정 - 지정된 피처 서비스에 대한 SDK 설정의 배열입니다. |
[표 26. 반환]

{#NCoreServ-settingsPublisher_O__table_kbw_j1c_npb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    NowSDK.core()?.settingsPublisher(for: chatService)
    .sink(receiveCompletion: { completion in
      if case .failure(let error) = completion {
        // Setting publisher failed with error
      }
    }, receiveValue: { updatedSettings in
      // Receive array of SDK settings for chatService
    })
    .store(in: &subscriptions)