다음을 통해 공유

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를 생성하고 X-MSEdge-ClientID 응답 헤더에 반환합니다. 요청에 이 헤더를 포함해서는 안 되는 경우는 사용자가 해당 디바이스에서 앱을 처음 사용할 때뿐입니다. 앱이 디바이스에서 이 사용자와 관련하여 수행하는 각 Bing API 요청에 대해 클라이언트 ID를 사용합니다. 클라이언트 ID를 유지합니다. 브라우저 앱에서 ID를 유지하려면 영구적 HTTP 쿠키를 사용하여 모든 세션에서 해당 ID가 사용되도록 합니다. 세션 쿠키를 사용하면 안 됩니다. 모바일 앱과 같은 다른 앱의 경우 디바이스의 영구적 스토리지를 사용하여 ID를 유지합니다. 다음에 사용자가 해당 디바이스에서 앱을 사용하는 경우 유지된 클라이언트 ID를 가져옵니다. 이 헤더는 Bing 응답에 포함되거나 포함되지 않을 수도 있습니다. 응답에 이 헤더가 포함된 경우, 클라이언트 ID를 캡처하여 해당 디바이스에서 사용자에 대해 수행되는 모든 후속 Bing 요청에 사용합니다. X-MSEdge-ClientID가 포함되는 경우 요청에 쿠키를 포함하면 안 됩니다.
clientIp

클라이언트 디바이스의 IPv4 또는 IPv6 주소입니다. IP 주소는 사용자 위치를 검색하는 데 사용됩니다. Bing은 위치 정보를 사용하여 유해 정보 차단 동작을 결정합니다. 이 헤더와 X-Search-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은 위치 정보를 사용하여 유해 정보 차단 동작을 결정하고 관련된 로컬 콘텐츠를 반환합니다. 키/값 쌍을 :로 지정합니다. 다음은 사용자 위치를 지정하는 데 사용하는 키입니다. 위도(필수): 클라이언트 위치의 위도(도)입니다. 위도는 -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일 이후의 초 수입니다.) head(선택 사항): 클라이언트의 상대 제목 또는 이동 방향입니다. 정북을 기준으로 시계 반대 방향으로 계산해서, 이동 방향을 0에서 360 사이의 도로 지정합니다. sp 키가 0이 아닌 경우에만 이 키를 지정합니다. sp(선택 사항): 클라이언트 디바이스가 이동하는 수평 속도(속도)(초당 미터)입니다. alt(선택 사항): 클라이언트 디바이스의 고도(미터)입니다. 는 (선택 사항): 좌표의 세로 정확도를 지정하는 반경(미터)입니다. 대체 키를 지정하는 경우에만 이 키를 지정합니다. 많은 키가 선택 사항이지만 제공하는 정보가 많을수록 위치 결과가 더 정확합니다. 사용자의 지리적 위치는 선택 사항이지만 항상 지정하는 것이 좋습니다. 클라이언트의 IP 주소가 사용자의 실제 위치를 정확하게 반영하지 않는 경우(예: 클라이언트가 VPN을 사용하는 경우) 위치를 제공하는 것이 특히 중요합니다. 최적의 결과를 얻으려면 이 헤더와 X-MSEdge-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, Videos, Webpages입니다. answerCount를 지정하는 경우에만 사용합니다.
responseFilter

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

성인 콘텐츠를 필터링하는 데 사용되는 필터입니다. 끄기: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환합니다. 보통: 성인 텍스트가 있는 웹 페이지를 반환하지만 성인 이미지나 비디오는 반환하지 않습니다. Strict: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환하지 마세요. 기본값은 Moderate입니다. 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를 생성하고 X-MSEdge-ClientID 응답 헤더에 반환합니다. 요청에 이 헤더를 포함해서는 안 되는 경우는 사용자가 해당 디바이스에서 앱을 처음 사용할 때뿐입니다. 앱이 디바이스에서 이 사용자와 관련하여 수행하는 각 Bing API 요청에 대해 클라이언트 ID를 사용합니다. 클라이언트 ID를 유지합니다. 브라우저 앱에서 ID를 유지하려면 영구적 HTTP 쿠키를 사용하여 모든 세션에서 해당 ID가 사용되도록 합니다. 세션 쿠키를 사용하면 안 됩니다. 모바일 앱과 같은 다른 앱의 경우 디바이스의 영구적 스토리지를 사용하여 ID를 유지합니다. 다음에 사용자가 해당 디바이스에서 앱을 사용하는 경우 유지된 클라이언트 ID를 가져옵니다. 이 헤더는 Bing 응답에 포함되거나 포함되지 않을 수도 있습니다. 응답에 이 헤더가 포함된 경우, 클라이언트 ID를 캡처하여 해당 디바이스에서 사용자에 대해 수행되는 모든 후속 Bing 요청에 사용합니다. X-MSEdge-ClientID가 포함되는 경우 요청에 쿠키를 포함하면 안 됩니다.

clientId?: string

속성 값

string

clientIp

클라이언트 디바이스의 IPv4 또는 IPv6 주소입니다. IP 주소는 사용자 위치를 검색하는 데 사용됩니다. Bing은 위치 정보를 사용하여 유해 정보 차단 동작을 결정합니다. 이 헤더와 X-Search-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은 위치 정보를 사용하여 유해 정보 차단 동작을 결정하고 관련된 로컬 콘텐츠를 반환합니다. 키/값 쌍을 :로 지정합니다. 다음은 사용자 위치를 지정하는 데 사용하는 키입니다. 위도(필수): 클라이언트 위치의 위도(도)입니다. 위도는 -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일 이후의 초 수입니다.) head(선택 사항): 클라이언트의 상대 제목 또는 이동 방향입니다. 정북을 기준으로 시계 반대 방향으로 계산해서, 이동 방향을 0에서 360 사이의 도로 지정합니다. sp 키가 0이 아닌 경우에만 이 키를 지정합니다. sp(선택 사항): 클라이언트 디바이스가 이동하는 수평 속도(속도)(초당 미터)입니다. alt(선택 사항): 클라이언트 디바이스의 고도(미터)입니다. 는 (선택 사항): 좌표의 세로 정확도를 지정하는 반경(미터)입니다. 대체 키를 지정하는 경우에만 이 키를 지정합니다. 많은 키가 선택 사항이지만 제공하는 정보가 많을수록 위치 결과가 더 정확합니다. 사용자의 지리적 위치는 선택 사항이지만 항상 지정하는 것이 좋습니다. 클라이언트의 IP 주소가 사용자의 실제 위치를 정확하게 반영하지 않는 경우(예: 클라이언트가 VPN을 사용하는 경우) 위치를 제공하는 것이 특히 중요합니다. 최적의 결과를 얻으려면 이 헤더와 X-MSEdge-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, Videos, Webpages입니다. answerCount를 지정하는 경우에만 사용합니다.

promote?: AnswerType[]

속성 값

AnswerType[]

responseFilter

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

responseFilter?: AnswerType[]

속성 값

AnswerType[]

safeSearch

성인 콘텐츠를 필터링하는 데 사용되는 필터입니다. 끄기: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환합니다. 보통: 성인 텍스트가 있는 웹 페이지를 반환하지만 성인 이미지나 비디오는 반환하지 않습니다. Strict: 성인 텍스트, 이미지 또는 비디오가 있는 웹 페이지를 반환하지 마세요. 기본값은 Moderate입니다. 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에서 상속됨