다음을 통해 공유

WebSearchOptionalParams interface

패키지:
@azure/cognitiveservices-websearch

선택적 매개 변수입니다.

Extends
RequestOptionsBase

속성

acceptLanguage

사용자 인터페이스 문자열에 사용할 하나 이상의 언어에 대한 쉼표로 구분된 목록입니다. 목록이 기본 설정 순서를 줄입니다. 예상 형식을 비롯한 자세한 내용은 RFC2616참조하세요. 이 헤더와 setLang 쿼리 매개 변수는 상호 배타적입니다. 둘 다 지정하지 않습니다. 이 헤더를 설정하는 경우 cc 쿼리 매개 변수도 지정해야 합니다. Bing은 목록에서 찾은 첫 번째 지원되는 언어를 사용하고 해당 언어를 cc 매개 변수 값과 결합하여 결과를 반환할 시장을 결정합니다. 목록에 지원되는 언어가 포함되지 않은 경우 Bing은 요청을 지원하는 가장 가까운 언어 및 시장을 찾게 되며, 지정된 언어 대신 결과에 대해 집계 또는 기본 시장을 사용할 수 있습니다. 여러 언어를 지정하는 경우에만 이 헤더와 cc 쿼리 매개 변수를 사용해야 합니다. 그렇지 않으면 mkt 및 setLang 쿼리 매개 변수를 사용해야 합니다. 사용자 인터페이스 문자열은 사용자 인터페이스에서 레이블로 사용되는 문자열입니다. JSON 응답 개체에는 사용자 인터페이스 문자열이 거의 없습니다. Bing.com 속성에 대한 응답 개체의 링크는 지정된 언어를 적용합니다.
answerCount

응답을 포함할 답변 수입니다. Bing이 반환하는 답변은 순위를 기반으로 합니다. 예를 들어 Bing이 요청에 대한 웹 페이지, 이미지, 비디오 및 relatedSearches를 반환하고 이 매개 변수를 2로 설정하면 응답에 웹 페이지와 이미지가 포함됩니다. responseFilter 쿼리 매개 변수를 동일한 요청에 포함하고 웹 페이지 및 뉴스로 설정한 경우 응답에는 웹 페이지만 포함됩니다.
clientId

Bing은 이 헤더를 사용하여 Bing API 호출에서 일관된 동작을 사용자에게 제공합니다. Bing은 종종 새로운 기능과 개선 사항을 플라이트하며, 클라이언트 ID를 다른 항공편의 트래픽을 할당하기 위한 키로 사용합니다. 여러 요청에서 사용자에 대해 동일한 클라이언트 ID를 사용하지 않는 경우 Bing은 충돌하는 여러 항공편에 사용자를 할당할 수 있습니다. 충돌하는 여러 항공편에 할당하면 일관되지 않은 사용자 환경이 발생할 수 있습니다. 예를 들어 두 번째 요청에 첫 번째 요청과 다른 플라이트 할당이 있는 경우 환경이 예기치 않을 수 있습니다. 또한 Bing은 클라이언트 ID를 사용하여 웹 결과를 해당 클라이언트 ID의 검색 기록에 맞게 조정하여 사용자에게 더 풍부한 환경을 제공할 수 있습니다. 또한 Bing은 이 헤더를 사용하여 클라이언트 ID로 생성된 활동을 분석하여 결과 순위를 향상시킵니다. 관련성 개선은 Bing API에서 제공하는 결과의 품질 향상에 도움이 되며, 결과적으로 API 소비자에 대한 클릭률도 높아집니다. 중요: 선택 사항이지만 이 헤더가 필요하다고 고려해야 합니다. 동일한 최종 사용자 및 디바이스 조합에 대한 여러 요청에서 클라이언트 ID를 유지하면 1) API 소비자가 일관된 사용자 환경을 받을 수 있으며, 2) Bing API의 결과 품질을 향상하여 클릭률도 높아집니다. 디바이스에서 애플리케이션을 사용하는 각 사용자에게는 고유한 Bing 생성 클라이언트 ID가 있어야 합니다. 요청에 이 헤더를 포함하지 않으면 Bing은 ID를 생성하고 XMSEdge-ClientID 응답 헤더에 반환합니다. 요청에 이 헤더를 포함하지 않아야 하는 유일한 시간은 사용자가 해당 디바이스에서 앱을 처음 사용하는 시간입니다. 앱이 디바이스에서 이 사용자를 위해 만드는 각 Bing API 요청에 대해 클라이언트 ID를 사용합니다. 클라이언트 ID를 유지합니다. 브라우저 앱에서 ID를 유지하려면 영구 HTTP 쿠키를 사용하여 ID가 모든 세션에서 사용되는지 확인합니다. 세션 쿠키를 사용하지 마세요. 모바일 앱과 같은 다른 앱의 경우 디바이스의 영구 스토리지를 사용하여 ID를 유지합니다. 다음에 사용자가 해당 디바이스에서 앱을 사용할 때 유지된 클라이언트 ID를 가져옵니다. Bing 응답은 이 헤더를 포함하거나 포함하지 않을 수 있습니다. 응답에 이 헤더가 포함된 경우 클라이언트 ID를 캡처하고 해당 디바이스의 사용자에 대한 모든 후속 Bing 요청에 사용합니다. X-MSEdge-ClientID를 포함하는 경우 요청에 쿠키를 포함하면 안 됩니다.
clientIp

클라이언트 디바이스의 IPv4 또는 IPv6 주소입니다. IP 주소는 사용자의 위치를 검색하는 데 사용됩니다. Bing은 위치 정보를 사용하여 안전한 검색 동작을 확인합니다. 선택 사항이지만 항상 이 헤더와 XSearch-Location 헤더를 지정하는 것이 좋습니다. 주소를 난독 처리하지 마세요(예: 마지막 8진을 0으로 변경). 주소를 난독 처리하면 위치가 디바이스의 실제 위치 근처에 있지 않아 Bing에서 잘못된 결과를 제공하게 될 수 있습니다.
count

응답에서 반환할 검색 결과 수입니다. 기본값은 10이고 최대값은 50입니다. 배달된 실제 숫자는 요청보다 적을 수 있습니다. 오프셋 매개 변수와 함께 이 매개 변수를 사용하여 결과를 페이지로 이동합니다. 예를 들어 사용자 인터페이스에 페이지당 검색 결과가 10개 표시되면 개수를 10으로 설정하고 오프셋을 0으로 설정하여 결과의 첫 번째 페이지를 가져옵니다. 각 후속 페이지에 대해 오프셋을 10씩 증분합니다(예: 0, 10, 20). 여러 페이지에 결과에서 일부 겹침을 포함할 수 있습니다.
countryCode

결과가 생성되는 국가의 2자 국가 코드입니다. 이 API는 미국 시장만 지원합니다. 이 쿼리 매개 변수를 지정하는 경우 이 매개 변수를 설정해야 합니다. 이 매개 변수를 설정하는 경우 Accept-Language 헤더도 지정해야 합니다. Bing은 언어 목록에서 찾은 첫 번째 지원되는 언어를 사용하고, 해당 언어를 지정한 국가 코드와 결합하여 결과를 반환할 시장을 결정합니다. 언어 목록에 지원되는 언어가 포함되지 않은 경우 Bing은 요청을 지원하는 가장 가까운 언어 및 시장을 찾거나 지정된 언어 대신 결과에 집계 또는 기본 시장을 사용할 수 있습니다. 여러 언어를 지정하는 경우에만 이 쿼리 매개 변수와 Accept-Language 쿼리 매개 변수를 사용해야 합니다. 그렇지 않으면 mkt 및 setLang 쿼리 매개 변수를 사용해야 합니다. 이 매개 변수와 mkt 쿼리 매개 변수는 상호 배타적입니다. 둘 다 지정하지 마세요.
freshness

검색 결과를 다음과 같은 연령 값으로 필터링합니다. Day - Bing이 지난 24시간 이내에 검색한 웹 페이지를 반환합니다. 주 - Bing이 지난 7일 이내에 검색한 웹 페이지를 반환합니다. Month - 지난 30일 이내에 검색된 웹 페이지를 반환합니다. 이 필터는 뉴스 및 이미지와 같은 다른 결과에는 적용되지 않고 웹 페이지 결과에만 적용됩니다. 가능한 값은 'Day', 'Week', 'Month'입니다.
location

클라이언트의 지리적 위치를 설명하는 키/값 쌍의 세미콜론으로 구분된 목록입니다. Bing은 위치 정보를 사용하여 안전한 검색 동작을 확인하고 관련 로컬 콘텐츠를 반환합니다. 키/값 쌍을 key:value로 <지정합니다>.<> 다음은 사용자의 위치를 지정하는 데 사용하는 키입니다. 위도(필수): 클라이언트 위치의 위도(도)입니다. 위도는 -90.0보다 크거나 같아야 하며 +90.0보다 작거나 같아야 합니다. 음수 값은 남부 위도를 나타내고 양수 값은 북부 위도를 나타냅니다. long(필수): 클라이언트 위치의 경도(도)입니다. 경도는 -180.0보다 크거나 같아야 하며 +180.0보다 작거나 같아야 합니다. 음수 값은 서쪽 경도를 나타내고 양수 값은 동부 경도를 나타냅니다. re(필수): 좌표의 가로 정확도를 지정하는 반경(미터)입니다. 디바이스의 위치 서비스에서 반환된 값을 전달합니다. 일반적인 값은 GPS/Wi-Fi의 경우 22m, 셀 타워 삼각측량의 경우 380m, 역방향 IP 조회의 경우 18,000m일 수 있습니다. ts(선택 사항): 클라이언트가 위치에 있었던 시점의 UTC UNIX 타임스탬프입니다. (UNIX 타임스탬프는 1970년 1월 1일 이후의 초 수입니다.) 헤드(선택 사항): 클라이언트의 상대 제목 또는 이동 방향입니다. 진북을 기준으로 시계 방향으로 계산하여 이동 방향을 0에서 360까지의 각도로 지정합니다. sp 키가 0이 아닌 경우에만 이 키를 지정합니다. sp(선택 사항): 클라이언트 디바이스가 이동하는 수평 속도(속도)(초당 미터)입니다. alt(선택 사항): 클라이언트 디바이스의 고도(미터)입니다. 는 (선택 사항): 좌표의 세로 정확도를 지정하는 반경(미터)입니다. 대체 키를 지정하는 경우에만 이 키를 지정합니다. 많은 키가 선택 사항이지만 더 많은 정보를 제공할수록 위치 결과가 더 정확해집니다. 선택 사항이지만 항상 사용자의 지리적 위치를 지정하는 것이 좋습니다. 클라이언트의 IP 주소가 사용자의 실제 위치(예: 클라이언트가 VPN을 사용하는 경우)를 정확하게 반영하지 않는 경우 위치를 제공하는 것이 특히 중요합니다. 최적의 결과를 얻으려면 이 헤더와 XMSEdge-ClientIP 헤더를 포함해야 하지만 최소한 이 헤더를 포함해야 합니다.
market

결과가 나오는 시장입니다. 일반적으로 mkt는 사용자가 요청을 하는 국가입니다. 그러나 사용자가 Bing에서 결과를 제공하는 국가에 있지 않은 경우 다른 국가일 수 있습니다. 시장은 언어 코드>-<국가 코드> 형식<이어야 합니다. 예를 들어 en-US. 문자열은 대/소문자를 구분하지 않습니다. 알려진 경우 항상 시장을 지정하는 것이 좋습니다. 시장을 지정하면 Bing이 요청을 라우팅하고 적절하고 최적의 응답을 반환하는 데 도움이 됩니다. 시장 코드에 나열되지 않은 시장을 지정하는 경우 Bing은 변경될 수 있는 내부 매핑에 따라 가장 적합한 시장 코드를 사용합니다. 이 매개 변수와 cc 쿼리 매개 변수는 상호 배타적입니다. 둘 다 지정하지 마세요. 기본값: 'en-us'.
offset

결과를 반환하기 전에 건너뛸 검색 결과 수를 나타내는 0부터 시작하는 오프셋입니다. 기본값은 0입니다. 오프셋은 (totalEstimatedMatches - count)보다 작아야 합니다. 이 매개 변수를 count 매개 변수와 함께 사용하여 결과를 페이지로 표시합니다. 예를 들어 사용자 인터페이스에 페이지당 검색 결과가 10개 표시되면 개수를 10으로 설정하고 오프셋을 0으로 설정하여 결과의 첫 번째 페이지를 가져옵니다. 각 후속 페이지에 대해 오프셋을 10씩 증분합니다(예: 0, 10, 20). 여러 페이지가 결과에 겹치는 것을 포함할 수 있습니다.
pragma

기본적으로 Bing은 캐시된 콘텐츠를 반환합니다(사용 가능한 경우). Bing이 캐시된 콘텐츠를 반환하지 않도록 하려면 Pragma 헤더를 no-cache(예: Pragma: no-cache)로 설정합니다.
promote

순위에 관계없이 응답을 포함할 쉼표로 구분된 답변 목록입니다. 예를 들어, answerCount)를 2(2)로 설정하여 Bing이 상위 2개의 순위 응답을 반환하지만 응답에 뉴스도 포함하도록 하려면 홍보를 뉴스로 설정합니다. 순위가 가장 높은 답변이 웹 페이지, 이미지, 비디오 및 relatedSearches인 경우 뉴스가 순위가 지정된 답변이 아니므로 응답에 웹 페이지 및 이미지가 포함됩니다. 그러나 비디오로 승격을 설정하면 Bing은 비디오 답변을 응답으로 승격하고 웹 페이지, 이미지 및 비디오를 반환합니다. 승격하려는 답변은 answerCount 제한에 포함되지 않습니다. 예를 들어 순위가 지정된 답변이 뉴스, 이미지 및 비디오이고 answerCount를 1로 설정하고 뉴스로 승격하는 경우 응답에 뉴스와 이미지가 포함됩니다. 또는 순위가 지정된 답변이 비디오, 이미지 및 뉴스인 경우 응답에 비디오 및 뉴스가 포함됩니다. 가능한 값은 계산, 이미지, 뉴스, RelatedSearches, SpellSuggestions, TimeZone, 비디오, 웹 페이지입니다. answerCount를 지정하는 경우에만 사용합니다.
responseFilter

응답에 포함할 쉼표로 구분된 답변 목록입니다. 이 매개 변수를 지정하지 않으면 응답에 관련 데이터가 있는 모든 검색 답변이 포함됩니다. 가능한 필터 값은 계산, 이미지, 뉴스, RelatedSearches, SpellSuggestions, TimeZone, 비디오, 웹 페이지입니다. 이 필터를 사용하여 단일 답변을 얻을 수 있지만 보다 풍부한 결과를 얻으려면 대신 답변별 엔드포인트를 사용해야 합니다. 예를 들어 이미지만 받으려면 Image Search API 엔드포인트 중 하나에 요청을 보냅니다. RelatedSearches 및 SpellSuggestions 답변은 Image Search API와 같은 별도의 엔드포인트를 지원하지 않습니다(Web Search API만 반환). 순위 때문에 제외되는 답변을 포함하려면 승격 쿼리 매개 변수를 참조하세요.
safeSearch

성인 콘텐츠를 필터링하는 데 사용되는 필터입니다. Off: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환합니다. 보통: 성인 텍스트가 있는 웹 페이지를 반환하지만 성인 이미지나 비디오는 반환하지 않습니다. Strict: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환하지 마세요. 기본값은 보통입니다. Bing의 성인 정책이 safeSearch를 Strict로 설정하도록 요구하는 시장의 요청이 있으면 Bing은 safeSearch 값을 무시하고 Strict를 사용합니다. 사이트: 쿼리 연산자를 사용하는 경우 safeSearch 쿼리 매개 변수가 설정된 내용에 관계없이 응답에 성인 콘텐츠가 포함될 수 있습니다. 사이트 사용: 사이트의 콘텐츠를 알고 있고 시나리오에서 성인 콘텐츠의 가능성을 지원하는 경우에만 가능합니다. 가능한 값은 'Off', 'Moderate', 'Strict'입니다.
setLang

사용자 인터페이스 문자열에 사용할 언어입니다. ISO 639-1 2자 언어 코드를 사용하여 언어를 지정합니다. 예를 들어 영어의 언어 코드는 EN입니다. 기본값은 EN(영어)입니다. 선택 사항이지만 항상 언어를 지정해야 합니다. 일반적으로 사용자가 다른 언어로 표시되는 사용자 인터페이스 문자열을 원하지 않는 한 setLang을 mkt에서 지정한 동일한 언어로 설정합니다. 이 매개 변수와 Accept-Language 헤더는 함께 사용할 수 없습니다. 둘 다 지정하지 않습니다. 사용자 인터페이스 문자열은 사용자 인터페이스에서 레이블로 사용되는 문자열입니다. JSON 응답 개체에는 몇 가지 사용자 인터페이스 문자열이 있습니다. 또한 응답 개체의 Bing.com 속성에 대한 링크는 지정된 언어를 적용합니다.
textDecorations

표시 문자열에 적중 항목 강조 표시 문자와 같은 장식 표식이 포함되어야 하는지 여부를 결정하는 부울 값입니다. true이면 문자열에 표식이 포함될 수 있습니다. 기본값은 false입니다. 유니코드 문자 또는 HTML 태그를 표식으로 사용할지 여부를 지정하려면 textFormat 쿼리 매개 변수를 참조하세요.
textFormat

텍스트 장식에 사용할 표식의 형식입니다(textDecorations 쿼리 매개 변수 참조). 가능한 값은 Raw입니다. 유니코드 문자를 사용하여 특수 서식이 필요한 콘텐츠를 표시합니다. 유니코드 문자는 E000~E019 범위에 있습니다. 예를 들어 Bing은 E000 및 E001을 사용하여 적중 항목 강조 표시에 대한 쿼리 용어의 시작 및 끝을 표시합니다. HTML - HTML 태그를 사용하여 특수 서식이 필요한 콘텐츠를 표시합니다. 예를 들어 태그를 사용하여 표시 문자열에서 쿼리 용어를 강조 표시합니다. 기본값은 Raw입니다. <, >및 &같은 이스케이프 가능한 HTML 문자가 포함된 표시 문자열의 경우 textFormat이 HTML로 설정된 경우 Bing은 문자를 적절하게 이스케이프합니다(예: <<이스케이프됨). 가능한 값은 'Raw', 'Html'입니다.
userAgent

요청을 시작하는 사용자 에이전트입니다. Bing은 사용자 에이전트를 사용하여 모바일 사용자에게 최적화된 환경을 제공합니다. 선택 사항이지만 항상 이 헤더를 지정하는 것이 좋습니다. 사용자 에이전트는 일반적으로 사용되는 브라우저에서 보내는 것과 동일한 문자열이어야 합니다. 사용자 에이전트에 대한 자세한 내용은 RFC 2616참조하세요.

상속된 속성

abortSignal

요청을 중단하는 데 사용할 수 있는 신호입니다.
customHeaders

요청을 보내기 전에 적용할 사용자 정의 사용자 지정 요청 헤더입니다.
onDownloadProgress

다운로드 진행 시 발생하는 콜백입니다.
onUploadProgress

업로드 진행률에 따라 발생하는 콜백입니다.
timeout

요청이 자동으로 종료되기 전에 걸릴 수 있는 시간(밀리초)입니다.

속성 세부 정보

acceptLanguage

사용자 인터페이스 문자열에 사용할 하나 이상의 언어에 대한 쉼표로 구분된 목록입니다. 목록이 기본 설정 순서를 줄입니다. 예상 형식을 비롯한 자세한 내용은 RFC2616참조하세요. 이 헤더와 setLang 쿼리 매개 변수는 상호 배타적입니다. 둘 다 지정하지 않습니다. 이 헤더를 설정하는 경우 cc 쿼리 매개 변수도 지정해야 합니다. Bing은 목록에서 찾은 첫 번째 지원되는 언어를 사용하고 해당 언어를 cc 매개 변수 값과 결합하여 결과를 반환할 시장을 결정합니다. 목록에 지원되는 언어가 포함되지 않은 경우 Bing은 요청을 지원하는 가장 가까운 언어 및 시장을 찾게 되며, 지정된 언어 대신 결과에 대해 집계 또는 기본 시장을 사용할 수 있습니다. 여러 언어를 지정하는 경우에만 이 헤더와 cc 쿼리 매개 변수를 사용해야 합니다. 그렇지 않으면 mkt 및 setLang 쿼리 매개 변수를 사용해야 합니다. 사용자 인터페이스 문자열은 사용자 인터페이스에서 레이블로 사용되는 문자열입니다. JSON 응답 개체에는 사용자 인터페이스 문자열이 거의 없습니다. Bing.com 속성에 대한 응답 개체의 링크는 지정된 언어를 적용합니다.

acceptLanguage?: string

속성 값

string

answerCount

응답을 포함할 답변 수입니다. Bing이 반환하는 답변은 순위를 기반으로 합니다. 예를 들어 Bing이 요청에 대한 웹 페이지, 이미지, 비디오 및 relatedSearches를 반환하고 이 매개 변수를 2로 설정하면 응답에 웹 페이지와 이미지가 포함됩니다. responseFilter 쿼리 매개 변수를 동일한 요청에 포함하고 웹 페이지 및 뉴스로 설정한 경우 응답에는 웹 페이지만 포함됩니다.

answerCount?: number

속성 값

number

clientId

Bing은 이 헤더를 사용하여 Bing API 호출에서 일관된 동작을 사용자에게 제공합니다. Bing은 종종 새로운 기능과 개선 사항을 플라이트하며, 클라이언트 ID를 다른 항공편의 트래픽을 할당하기 위한 키로 사용합니다. 여러 요청에서 사용자에 대해 동일한 클라이언트 ID를 사용하지 않는 경우 Bing은 충돌하는 여러 항공편에 사용자를 할당할 수 있습니다. 충돌하는 여러 항공편에 할당하면 일관되지 않은 사용자 환경이 발생할 수 있습니다. 예를 들어 두 번째 요청에 첫 번째 요청과 다른 플라이트 할당이 있는 경우 환경이 예기치 않을 수 있습니다. 또한 Bing은 클라이언트 ID를 사용하여 웹 결과를 해당 클라이언트 ID의 검색 기록에 맞게 조정하여 사용자에게 더 풍부한 환경을 제공할 수 있습니다. 또한 Bing은 이 헤더를 사용하여 클라이언트 ID로 생성된 활동을 분석하여 결과 순위를 향상시킵니다. 관련성 개선은 Bing API에서 제공하는 결과의 품질 향상에 도움이 되며, 결과적으로 API 소비자에 대한 클릭률도 높아집니다. 중요: 선택 사항이지만 이 헤더가 필요하다고 고려해야 합니다. 동일한 최종 사용자 및 디바이스 조합에 대한 여러 요청에서 클라이언트 ID를 유지하면 1) API 소비자가 일관된 사용자 환경을 받을 수 있으며, 2) Bing API의 결과 품질을 향상하여 클릭률도 높아집니다. 디바이스에서 애플리케이션을 사용하는 각 사용자에게는 고유한 Bing 생성 클라이언트 ID가 있어야 합니다. 요청에 이 헤더를 포함하지 않으면 Bing은 ID를 생성하고 XMSEdge-ClientID 응답 헤더에 반환합니다. 요청에 이 헤더를 포함하지 않아야 하는 유일한 시간은 사용자가 해당 디바이스에서 앱을 처음 사용하는 시간입니다. 앱이 디바이스에서 이 사용자를 위해 만드는 각 Bing API 요청에 대해 클라이언트 ID를 사용합니다. 클라이언트 ID를 유지합니다. 브라우저 앱에서 ID를 유지하려면 영구 HTTP 쿠키를 사용하여 ID가 모든 세션에서 사용되는지 확인합니다. 세션 쿠키를 사용하지 마세요. 모바일 앱과 같은 다른 앱의 경우 디바이스의 영구 스토리지를 사용하여 ID를 유지합니다. 다음에 사용자가 해당 디바이스에서 앱을 사용할 때 유지된 클라이언트 ID를 가져옵니다. Bing 응답은 이 헤더를 포함하거나 포함하지 않을 수 있습니다. 응답에 이 헤더가 포함된 경우 클라이언트 ID를 캡처하고 해당 디바이스의 사용자에 대한 모든 후속 Bing 요청에 사용합니다. X-MSEdge-ClientID를 포함하는 경우 요청에 쿠키를 포함하면 안 됩니다.

clientId?: string

속성 값

string

clientIp

클라이언트 디바이스의 IPv4 또는 IPv6 주소입니다. IP 주소는 사용자의 위치를 검색하는 데 사용됩니다. Bing은 위치 정보를 사용하여 안전한 검색 동작을 확인합니다. 선택 사항이지만 항상 이 헤더와 XSearch-Location 헤더를 지정하는 것이 좋습니다. 주소를 난독 처리하지 마세요(예: 마지막 8진을 0으로 변경). 주소를 난독 처리하면 위치가 디바이스의 실제 위치 근처에 있지 않아 Bing에서 잘못된 결과를 제공하게 될 수 있습니다.

clientIp?: string

속성 값

string

count

응답에서 반환할 검색 결과 수입니다. 기본값은 10이고 최대값은 50입니다. 배달된 실제 숫자는 요청보다 적을 수 있습니다. 오프셋 매개 변수와 함께 이 매개 변수를 사용하여 결과를 페이지로 이동합니다. 예를 들어 사용자 인터페이스에 페이지당 검색 결과가 10개 표시되면 개수를 10으로 설정하고 오프셋을 0으로 설정하여 결과의 첫 번째 페이지를 가져옵니다. 각 후속 페이지에 대해 오프셋을 10씩 증분합니다(예: 0, 10, 20). 여러 페이지에 결과에서 일부 겹침을 포함할 수 있습니다.

count?: number

속성 값

number

countryCode

결과가 생성되는 국가의 2자 국가 코드입니다. 이 API는 미국 시장만 지원합니다. 이 쿼리 매개 변수를 지정하는 경우 이 매개 변수를 설정해야 합니다. 이 매개 변수를 설정하는 경우 Accept-Language 헤더도 지정해야 합니다. Bing은 언어 목록에서 찾은 첫 번째 지원되는 언어를 사용하고, 해당 언어를 지정한 국가 코드와 결합하여 결과를 반환할 시장을 결정합니다. 언어 목록에 지원되는 언어가 포함되지 않은 경우 Bing은 요청을 지원하는 가장 가까운 언어 및 시장을 찾거나 지정된 언어 대신 결과에 집계 또는 기본 시장을 사용할 수 있습니다. 여러 언어를 지정하는 경우에만 이 쿼리 매개 변수와 Accept-Language 쿼리 매개 변수를 사용해야 합니다. 그렇지 않으면 mkt 및 setLang 쿼리 매개 변수를 사용해야 합니다. 이 매개 변수와 mkt 쿼리 매개 변수는 상호 배타적입니다. 둘 다 지정하지 마세요.

countryCode?: string

속성 값

string

freshness

검색 결과를 다음과 같은 연령 값으로 필터링합니다. Day - Bing이 지난 24시간 이내에 검색한 웹 페이지를 반환합니다. 주 - Bing이 지난 7일 이내에 검색한 웹 페이지를 반환합니다. Month - 지난 30일 이내에 검색된 웹 페이지를 반환합니다. 이 필터는 뉴스 및 이미지와 같은 다른 결과에는 적용되지 않고 웹 페이지 결과에만 적용됩니다. 가능한 값은 'Day', 'Week', 'Month'입니다.

freshness?: Freshness

속성 값

Freshness

location

클라이언트의 지리적 위치를 설명하는 키/값 쌍의 세미콜론으로 구분된 목록입니다. Bing은 위치 정보를 사용하여 안전한 검색 동작을 확인하고 관련 로컬 콘텐츠를 반환합니다. 키/값 쌍을 key:value로 <지정합니다>.<> 다음은 사용자의 위치를 지정하는 데 사용하는 키입니다. 위도(필수): 클라이언트 위치의 위도(도)입니다. 위도는 -90.0보다 크거나 같아야 하며 +90.0보다 작거나 같아야 합니다. 음수 값은 남부 위도를 나타내고 양수 값은 북부 위도를 나타냅니다. long(필수): 클라이언트 위치의 경도(도)입니다. 경도는 -180.0보다 크거나 같아야 하며 +180.0보다 작거나 같아야 합니다. 음수 값은 서쪽 경도를 나타내고 양수 값은 동부 경도를 나타냅니다. re(필수): 좌표의 가로 정확도를 지정하는 반경(미터)입니다. 디바이스의 위치 서비스에서 반환된 값을 전달합니다. 일반적인 값은 GPS/Wi-Fi의 경우 22m, 셀 타워 삼각측량의 경우 380m, 역방향 IP 조회의 경우 18,000m일 수 있습니다. ts(선택 사항): 클라이언트가 위치에 있었던 시점의 UTC UNIX 타임스탬프입니다. (UNIX 타임스탬프는 1970년 1월 1일 이후의 초 수입니다.) 헤드(선택 사항): 클라이언트의 상대 제목 또는 이동 방향입니다. 진북을 기준으로 시계 방향으로 계산하여 이동 방향을 0에서 360까지의 각도로 지정합니다. sp 키가 0이 아닌 경우에만 이 키를 지정합니다. sp(선택 사항): 클라이언트 디바이스가 이동하는 수평 속도(속도)(초당 미터)입니다. alt(선택 사항): 클라이언트 디바이스의 고도(미터)입니다. 는 (선택 사항): 좌표의 세로 정확도를 지정하는 반경(미터)입니다. 대체 키를 지정하는 경우에만 이 키를 지정합니다. 많은 키가 선택 사항이지만 더 많은 정보를 제공할수록 위치 결과가 더 정확해집니다. 선택 사항이지만 항상 사용자의 지리적 위치를 지정하는 것이 좋습니다. 클라이언트의 IP 주소가 사용자의 실제 위치(예: 클라이언트가 VPN을 사용하는 경우)를 정확하게 반영하지 않는 경우 위치를 제공하는 것이 특히 중요합니다. 최적의 결과를 얻으려면 이 헤더와 XMSEdge-ClientIP 헤더를 포함해야 하지만 최소한 이 헤더를 포함해야 합니다.

location?: string

속성 값

string

market

결과가 나오는 시장입니다. 일반적으로 mkt는 사용자가 요청을 하는 국가입니다. 그러나 사용자가 Bing에서 결과를 제공하는 국가에 있지 않은 경우 다른 국가일 수 있습니다. 시장은 언어 코드>-<국가 코드> 형식<이어야 합니다. 예를 들어 en-US. 문자열은 대/소문자를 구분하지 않습니다. 알려진 경우 항상 시장을 지정하는 것이 좋습니다. 시장을 지정하면 Bing이 요청을 라우팅하고 적절하고 최적의 응답을 반환하는 데 도움이 됩니다. 시장 코드에 나열되지 않은 시장을 지정하는 경우 Bing은 변경될 수 있는 내부 매핑에 따라 가장 적합한 시장 코드를 사용합니다. 이 매개 변수와 cc 쿼리 매개 변수는 상호 배타적입니다. 둘 다 지정하지 마세요. 기본값: 'en-us'.

market?: string

속성 값

string

offset

결과를 반환하기 전에 건너뛸 검색 결과 수를 나타내는 0부터 시작하는 오프셋입니다. 기본값은 0입니다. 오프셋은 (totalEstimatedMatches - count)보다 작아야 합니다. 이 매개 변수를 count 매개 변수와 함께 사용하여 결과를 페이지로 표시합니다. 예를 들어 사용자 인터페이스에 페이지당 검색 결과가 10개 표시되면 개수를 10으로 설정하고 오프셋을 0으로 설정하여 결과의 첫 번째 페이지를 가져옵니다. 각 후속 페이지에 대해 오프셋을 10씩 증분합니다(예: 0, 10, 20). 여러 페이지가 결과에 겹치는 것을 포함할 수 있습니다.

offset?: number

속성 값

number

pragma

기본적으로 Bing은 캐시된 콘텐츠를 반환합니다(사용 가능한 경우). Bing이 캐시된 콘텐츠를 반환하지 않도록 하려면 Pragma 헤더를 no-cache(예: Pragma: no-cache)로 설정합니다.

pragma?: string

속성 값

string

promote

순위에 관계없이 응답을 포함할 쉼표로 구분된 답변 목록입니다. 예를 들어, answerCount)를 2(2)로 설정하여 Bing이 상위 2개의 순위 응답을 반환하지만 응답에 뉴스도 포함하도록 하려면 홍보를 뉴스로 설정합니다. 순위가 가장 높은 답변이 웹 페이지, 이미지, 비디오 및 relatedSearches인 경우 뉴스가 순위가 지정된 답변이 아니므로 응답에 웹 페이지 및 이미지가 포함됩니다. 그러나 비디오로 승격을 설정하면 Bing은 비디오 답변을 응답으로 승격하고 웹 페이지, 이미지 및 비디오를 반환합니다. 승격하려는 답변은 answerCount 제한에 포함되지 않습니다. 예를 들어 순위가 지정된 답변이 뉴스, 이미지 및 비디오이고 answerCount를 1로 설정하고 뉴스로 승격하는 경우 응답에 뉴스와 이미지가 포함됩니다. 또는 순위가 지정된 답변이 비디오, 이미지 및 뉴스인 경우 응답에 비디오 및 뉴스가 포함됩니다. 가능한 값은 계산, 이미지, 뉴스, RelatedSearches, SpellSuggestions, TimeZone, 비디오, 웹 페이지입니다. answerCount를 지정하는 경우에만 사용합니다.

promote?: AnswerType[]

속성 값

AnswerType[]

responseFilter

응답에 포함할 쉼표로 구분된 답변 목록입니다. 이 매개 변수를 지정하지 않으면 응답에 관련 데이터가 있는 모든 검색 답변이 포함됩니다. 가능한 필터 값은 계산, 이미지, 뉴스, RelatedSearches, SpellSuggestions, TimeZone, 비디오, 웹 페이지입니다. 이 필터를 사용하여 단일 답변을 얻을 수 있지만 보다 풍부한 결과를 얻으려면 대신 답변별 엔드포인트를 사용해야 합니다. 예를 들어 이미지만 받으려면 Image Search API 엔드포인트 중 하나에 요청을 보냅니다. RelatedSearches 및 SpellSuggestions 답변은 Image Search API와 같은 별도의 엔드포인트를 지원하지 않습니다(Web Search API만 반환). 순위 때문에 제외되는 답변을 포함하려면 승격 쿼리 매개 변수를 참조하세요.

responseFilter?: AnswerType[]

속성 값

AnswerType[]

safeSearch

성인 콘텐츠를 필터링하는 데 사용되는 필터입니다. Off: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환합니다. 보통: 성인 텍스트가 있는 웹 페이지를 반환하지만 성인 이미지나 비디오는 반환하지 않습니다. Strict: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환하지 마세요. 기본값은 보통입니다. Bing의 성인 정책이 safeSearch를 Strict로 설정하도록 요구하는 시장의 요청이 있으면 Bing은 safeSearch 값을 무시하고 Strict를 사용합니다. 사이트: 쿼리 연산자를 사용하는 경우 safeSearch 쿼리 매개 변수가 설정된 내용에 관계없이 응답에 성인 콘텐츠가 포함될 수 있습니다. 사이트 사용: 사이트의 콘텐츠를 알고 있고 시나리오에서 성인 콘텐츠의 가능성을 지원하는 경우에만 가능합니다. 가능한 값은 'Off', 'Moderate', 'Strict'입니다.

safeSearch?: SafeSearch

속성 값

SafeSearch

setLang

사용자 인터페이스 문자열에 사용할 언어입니다. ISO 639-1 2자 언어 코드를 사용하여 언어를 지정합니다. 예를 들어 영어의 언어 코드는 EN입니다. 기본값은 EN(영어)입니다. 선택 사항이지만 항상 언어를 지정해야 합니다. 일반적으로 사용자가 다른 언어로 표시되는 사용자 인터페이스 문자열을 원하지 않는 한 setLang을 mkt에서 지정한 동일한 언어로 설정합니다. 이 매개 변수와 Accept-Language 헤더는 함께 사용할 수 없습니다. 둘 다 지정하지 않습니다. 사용자 인터페이스 문자열은 사용자 인터페이스에서 레이블로 사용되는 문자열입니다. JSON 응답 개체에는 몇 가지 사용자 인터페이스 문자열이 있습니다. 또한 응답 개체의 Bing.com 속성에 대한 링크는 지정된 언어를 적용합니다.

setLang?: string

속성 값

string

textDecorations

표시 문자열에 적중 항목 강조 표시 문자와 같은 장식 표식이 포함되어야 하는지 여부를 결정하는 부울 값입니다. true이면 문자열에 표식이 포함될 수 있습니다. 기본값은 false입니다. 유니코드 문자 또는 HTML 태그를 표식으로 사용할지 여부를 지정하려면 textFormat 쿼리 매개 변수를 참조하세요.

textDecorations?: boolean

속성 값

boolean

textFormat

텍스트 장식에 사용할 표식의 형식입니다(textDecorations 쿼리 매개 변수 참조). 가능한 값은 Raw입니다. 유니코드 문자를 사용하여 특수 서식이 필요한 콘텐츠를 표시합니다. 유니코드 문자는 E000~E019 범위에 있습니다. 예를 들어 Bing은 E000 및 E001을 사용하여 적중 항목 강조 표시에 대한 쿼리 용어의 시작 및 끝을 표시합니다. HTML - HTML 태그를 사용하여 특수 서식이 필요한 콘텐츠를 표시합니다. 예를 들어 태그를 사용하여 표시 문자열에서 쿼리 용어를 강조 표시합니다. 기본값은 Raw입니다. <, >및 &같은 이스케이프 가능한 HTML 문자가 포함된 표시 문자열의 경우 textFormat이 HTML로 설정된 경우 Bing은 문자를 적절하게 이스케이프합니다(예: <<이스케이프됨). 가능한 값은 'Raw', 'Html'입니다.

textFormat?: TextFormat

속성 값

TextFormat

userAgent

요청을 시작하는 사용자 에이전트입니다. Bing은 사용자 에이전트를 사용하여 모바일 사용자에게 최적화된 환경을 제공합니다. 선택 사항이지만 항상 이 헤더를 지정하는 것이 좋습니다. 사용자 에이전트는 일반적으로 사용되는 브라우저에서 보내는 것과 동일한 문자열이어야 합니다. 사용자 에이전트에 대한 자세한 내용은 RFC 2616참조하세요.

userAgent?: string

속성 값

string

상속된 속성 세부 정보

abortSignal

요청을 중단하는 데 사용할 수 있는 신호입니다.

abortSignal?: AbortSignalLike

속성 값

AbortSignalLike

msRest.RequestOptionsBase.abortSignal에서 상속된

customHeaders

요청을 보내기 전에 적용할 사용자 정의 사용자 지정 요청 헤더입니다.

customHeaders?: {[key: string]: string}

속성 값

{[key: string]: string}

msRest.RequestOptionsBase.customHeaders에서 상속된

onDownloadProgress

다운로드 진행 시 발생하는 콜백입니다.

onDownloadProgress?: (progress: TransferProgressEvent) => void

속성 값

(progress: TransferProgressEvent) => void

msRest.RequestOptionsBase.onDownloadProgress에서 상속됨

onUploadProgress

업로드 진행률에 따라 발생하는 콜백입니다.

onUploadProgress?: (progress: TransferProgressEvent) => void

속성 값

(progress: TransferProgressEvent) => void

msRest.RequestOptionsBase.onUploadProgress에서 상속된

timeout

요청이 자동으로 종료되기 전에 걸릴 수 있는 시간(밀리초)입니다.

timeout?: number

속성 값

number

msRest.RequestOptionsBase.timeout에서 상속된