---
sourceDocument: 요코하마 ServiceNow AI 플랫폼 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/yokohama/platform-administration

 Release :

    - yokohama

ft:locale :

    - ko-KR

ft:publication_title :

    - 요코하마 ServiceNow AI 플랫폼 관리

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# GraphQL REST API를 사용하여 외부 사용자 검색에서 생성된 제안 보기

# GraphQL REST API를 사용하여 외부 사용자 검색에서 생성된 제안 보기 {#ariaid-title1}

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

GraphQL REST API 엔드포인트에 요청을 제출하여 자체 등록한 외부 사용자의 검색에서 생성된 검색 제안을 검색합니다. 이 엔드포인트를 사용하면 인증되지 않은 게스트 사용자의 액세스가 허용됩니다.

## 시작하기 전에

인스턴스에서 다음 조건이 충족되는지 확인합니다.

* 도메인 분리 플러그인이 활성화되어 있지 않습니다. 이 플러그인에 대한 자세한 내용은 [도메인 분리 플러그인을](https://www.servicenow.com/docs/access?context=domain-sep-plugin&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) 참조하십시오.
* Explicit Roles 플러그인(com.glide.explicit_roles)이 활성화됩니다. 이 플러그인에 대한 자세한 내용은 [명시적 역할을 참조하십시오.](https://www.servicenow.com/docs/access?context=explicit-roles&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)
* snc_external 역할이 있는 외부 사용자가 검색 제안 ServiceNow® 서비스 포털을 생성하는 검색 애플리케이션(예: , Now Mobile, ServiceNow® 가상 에이전트또는 )에서 검색을 제출했습니다.
* glide.search.suggestions.allow_guest_user 시스템 속성이 true로 설정됩니다. 시스템 속성 값 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 [시스템 속성 추가](https://servicenow-prod.fluidtopics.net/9hU5N0LoroJqwZd28uBY2w#t_AddAPropertyUsingSysPropsList "시스템 동작을 제어하는 속성을 추가하거나 생성합니다.").
{#view-ext-user-search-suggestions__ul_fg1_wfq_wpb}  
외부 사용자 검색 제안을 검색할 검색 애플리케이션의 sys_id 가져옵니다.  
주:  
search_application_admin, agent_workspace_user 또는 workspace_user 역할을 가진 사용자는 검색 애플리케이션 구성\[sys_search_context_config\] 테이블의 검색 애플리케이션 기록에서 이 sys_id 복사하여 얻을 수 있습니다.

GraphiQL, Insomnia 또는 Postman 클라이언트와 같은 타사 GraphQL 클라이언트를 다운로드합니다.

필요한 역할: 없음

## 이 태스크 정보

검색 제안은 자체 등록한 외부 사용자가 수행하는 검색에 대한 제안을 생성합니다. 시스템 속성이 glide.search.suggestions.allow_guest_user예로 설정되면 인증되지 않은 게스트 사용자가 인스턴스의 GraphQL REST API 엔드포인트에 액세스하여 검색 애플리케이션에 대한 외부 사용자 검색 제안을 검색할 수 있습니다.  
이 GraphQL REST API 엔드포인트에는 인증이 필요하지 않거나 강제 적용되지 않습니다.  
주:  
인증되지 않은 게스트 사용자는 전역 도메인에서만 검색 제안을 검색할 수 있습니다. 인스턴스에서 도메인 분리가 활성화된 경우 게스트 사용자는 검색 제안을 검색할 수 없습니다.

## 프로시저

1. 타사 GraphQL 클라이언트에서 HTTP POST 메서드를 사용하는 새 요청을 구성합니다.
2. 요청의 엔드포인트를 인스턴스의 GraphQL REST API 엔드포인트 https://\<인스턴스 이름\>.service-now.com/api/now/graphql 로 설정합니다.
3. 요청 본문을 다음 GraphQL 쿼리로 설정하고, 외부 사용자 검색 제안을 검색하려는 검색 애플리케이션의 sys_id로 `<search_application_sys_id>` 바꿉니다.  

       {
         GlideSearch_Query {
           suggestions(searchContextConfigId: "<search_application_sys_id>", searchTerm: "") {
             term
             data {
               name
               records {
                 type
                 columns {
                   label
                   fieldName
                   value
                   displayValue
                 }
               }
             }
           }
         }
       }

## 결과

시스템은 다음 예와 같이 자체 등록한 외부 사용자가 애플리케이션에서 검색한 검색 제안을 JSON 객체로 반환합니다.

    {
      "data": {
        "GlideSearch_Query": {
          "suggestions": {
            "term": "",
            "data": [
              {
                "records": [
                  {
                    "type": "POPULAR_QUERY",
                    "columns": [
                      {
                        "label": "name",
                        "displayValue": "automatic replies",
                        "value": "automatic replies",
                        "fieldName": "name"
                      }
                    ]
                  },
                  {
                    "type": "POPULAR_QUERY",
                    "columns": [
                      {
                        "label": "name",
                        "displayValue": "contact group",
                        "value": "contact group",
                        "fieldName": "name"
                      }
                    ]
                  },
                  {
                    "type": "POPULAR_QUERY",
                    "columns": [
                      {
                        "label": "name",
                        "displayValue": "tablet",
                        "value": "tablet",
                        "fieldName": "name"
                      }
                    ]
                  },
                  {
                    "type": "POPULAR_QUERY",
                    "columns": [
                      {
                        "label": "name",
                        "displayValue": "laptop",
                        "value": "laptop",
                        "fieldName": "name"
                      }
                    ]
                  },
                  {
                    "type": "POPULAR_QUERY",
                    "columns": [
                      {
                        "label": "name",
                        "displayValue": "new email account",
                        "value": "new email account",
                        "fieldName": "name"
                      }
                    ]
                  }
                ],
                "name": "Popular searches"
              }
            ]
          }
        }
      }
    }