Referência autosuggest API v7

Aviso

As APIs de Pesquisa de Bing estão a mover-se dos Serviços Cognitivos para os Serviços de Pesquisa Bing. A partir de 30 de outubro de 2020, quaisquer novos casos de Bing Search devem ser adquir-se na sequência do processo aquidocumentado. Bing Search APIs aforados usando Serviços Cognitivos será suportado durante os próximos três anos ou até o final do seu Contrato de Empresa, o que acontecer primeiro. Para obter instruções de migração, consulte os Serviços de Busca Bing.

A API autosuggest permite-lhe enviar um termo de consulta parcial de pesquisa para Bing e obter de volta uma lista de consultas sugeridas que outros utilizadores pesquisaram. Além de incluir pesquisas feitas por outros, a lista pode incluir sugestões com base na intenção do utilizador.

Normalmente, você usa esta API para suportar uma experiência de caixa de pesquisa mais rica. Por exemplo, conforme o utilizador insere cada caráter do respetivo termo de pesquisa, chamaria esta API e preencheria a lista pendente da caixa de pesquisa com as cadeias de consulta sugeridas.

Esta secção fornece detalhes técnicos sobre os parâmetros de consulta e cabeçalhos que o pedido pode incluir, e a resposta JSON que contém as consultas sugeridas. Por exemplo, que mostram como fazer pedidos, ver Obter os termos de pesquisa sugeridos.

Para obter informações sobre os cabeçalhos que deve incluir no pedido, consulte Cabeçalhos pedidos.

Para obter informações sobre os parâmetros de consulta que deve incluir no pedido, consulte Parâmetros de Consulta.

Para obter informações sobre os objetos JSON que a resposta pode incluir, consulte Objetos de Resposta.

Para obter informações sobre a utilização permitida e exibição de resultados, consulte os requisitos de utilização e visualização da API de pesquisa de BingSearch .

Nota

Como os formatos e parâmetros de URL estão sujeitos a alterações sem aviso prévio, utilize todos os URLs como está. Não deve assumir dependências do formato URL ou parâmetros, exceto quando for anotado.

Ponto final

Para solicitar sugestões de consulta, envie um pedido GET para:

https://api.cognitive.microsoft.com/bing/v7.0/suggestions

Para subscrições multi-serviços, deve incluir a região no URL. Por exemplo: westus.api.cognitive.microsoft.com. Ver Regiões Apoiadas.

O pedido tem de utilizar o protocolo HTTPS.

Nota

O comprimento máximo de URL é de 2.048 caracteres. Para garantir que o comprimento do URL não exceda o limite, o comprimento máximo dos seus parâmetros de consulta deve ser inferior a 1.500 caracteres. Se o URL exceder 2.048 caracteres, o servidor retorna 404 Não encontrado.

Cabeçalhos

Seguem-se os cabeçalhos que um pedido e resposta podem incluir.

Cabeçalho Description
Aceitar Cabeçalho de pedido opcional.

O tipo de mídia predefinido é aplicação/json. Para especificar que a utilização da resposta JSON-LD,desa estale o cabeçalho Aceitar para aplicação/ld+json.
Accept-Language Cabeçalho de pedido opcional.

Uma lista separada por vírgulas dos idiomas que vão ser utilizados nas cadeias da interface de utilizador. A lista está em ordem decrescente de preferência. Para obter mais informações, incluindo o formato esperado, veja RFC2616.

Este cabeçalho e o parâmetro de consulta setLang são mutuamente exclusivos — não os especifique a ambos.

Se definir este cabeçalho, também tem de especificar o parâmetro de consulta cc. Para determinar o mercado do qual devolver resultados, o Bing utiliza o primeiro idioma suportado que encontra na lista e combina-o com o valor do parâmetro cc. Se a lista não incluir um idioma suportado, o Bing encontra o idioma e o mercado mais parecidos que suportem o pedido ou utiliza um mercado agregado ou predefinido para devolver os resultados. Para determinar o mercado que o Bing utiliza, veja o cabeçalho BingAPIs-Market.

Utilize este cabeçalho o parâmetro de consulta cc apenas se especificar vários idiomas. Caso contrário, utilize os parâmetros de consulta mkt e setLang.

As cadeias da interface de utilizador são cadeias utilizadas como etiquetas na interface de utilizador. Os objetos de resposta JSON têm poucas cadeias de interface de utilizador. Todas as ligações para propriedades de Bing.com nos objetos de resposta aplicam o idioma especificado.
BingAPIs-Market O cabeçalho da resposta.

O mercado que o pedido utiliza. O formulário <languageCode> - <countryCode> é. Por exemplo: en-US.

Se especificar um mercado que não esteja listado nos Códigos de Mercado,este valor poderá diferir do mercado especificado no parâmetro de consulta mkt. O mesmo acontece se especificar valores para cc e Língua de Aceitação que não podem ser reconciliados.
BingAPIs-TraceId O cabeçalho da resposta.

O ID da entrada de registo que contém os detalhes do pedido. Quando ocorrer um erro, capture este ID. Se não conseguir determinar nem resolver o problema, inclua o ID juntamente com as outras informações que enviar à equipa de suporte.
Ocp-Apim-Subscription-Key Cabeçalho de pedido obrigatório.

A chave de subscrição que recebeu quando se inscreveu neste serviço nos Serviços Cognitivos.
Pragma Cabeçalho de pedido opcional

Por predefinição, o Bing devolve conteúdo em cache, se disponível. Para evitar o conteúdo em cache, coloque o cabeçalho Pragma sem cache (por exemplo, Pragma: sem cache).
Redação após O cabeçalho da resposta.

A resposta inclui este cabeçalho se exceder o número de consultas permitidas por segundo (QPS) ou por mês (QPM). O cabeçalho contém o número de segundos que deve esperar antes de enviar outro pedido.
User-Agent Cabeçalho de pedido opcional.

O agente de utilizador que origina o pedido. O Bing utiliza o agente de utilizador para proporcionar uma experiência otimizada aos utilizadores de dispositivos móveis. Embora seja opcional, recomenda-se que especifique sempre este cabeçalho.

O agente de utilizador deve ser a mesma cadeia que qualquer browser geralmente utilizado envia. Para obter informações sobre os agentes de utilizador, veja RFC 2616.

Pode ver exemplos de cadeias de agente de utilizador abaixo:
  • Windows Phone—Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

  • Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like Gecko

  • iPad—Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID Cabeçalho de pedido e resposta opcional.

O Bing utiliza este cabeçalho para proporcionar um comportamento consistente nas chamada à API do Bing aos utilizadores. O Bing lança, muitas vezes, funcionalidades e melhorias novas e utiliza o ID de cliente como uma chave para atribuir tráfego aos diferentes lançamentos. Se não utilizar o mesmo ID de cliente para um utilizador em vários pedidos, o Bing poderá atribuir esse utilizador a vários lançamentos sobrepostos. A atribuição a vários lançamentos sobrepostos pode provocar uma experiência de utilizador inconsistente. Por exemplo, se a atribuição de lançamento do segundo pedido for diferente da do primeiro, a experiência poderá ser inesperada. Além disso, o Bing pode usar o ID do cliente para adaptar os resultados web ao histórico de pesquisa desse cliente, proporcionando uma experiência mais rica para o utilizador.

O Bing também utiliza este cabeçalho para ajudar a melhorar as classificações dos resultados ao analisar a atividade gerada por um ID de cliente. As melhorias à relevância ajudam a que as APIs do Bing devolvam resultados com melhor qualidade, o que, por sua vez, origina taxas de cliques mais altas para o consumidor da API.

IMPORTANTE: embora seja opcional, deve ver este cabeçalho como obrigatório. Persistir o ID de cliente em vários pedidos para a mesma combinação de utilizador final e dispositivo permite 1) que o consumidor da API receba uma experiência de utilizador consistente e 2) taxas de cliques mais altas, através de resultados com melhor qualidade das APIs do Bing.

As regras abaixo são as regras de utilização básicas aplicáveis a este cabeçalho.
  • Cada utilizador que utilize a sua aplicação no dispositivo tem de ter um ID de cliente exclusivo e gerado pelo Bing.

    Se não incluir este cabeçalho no pedido, o Bing gera um ID e devolve-o no cabeçalho da resposta X-MSEdge-ClientID. O único momento em que NÃO deve incluir este cabeçalho num pedido é na primeira vez que o utilizador utiliza a sua aplicação nesse dispositivo.

  • Utilize o ID de cliente para cada pedido da API do Bing que a sua aplicação fizer para este utilizador no dispositivo.

  • ATENÇÃO: Tem de garantir que este ID do Cliente não está ligado a nenhuma informação autenticada da conta de utilizador.

  • Persista o ID de cliente. Para persistir o ID numa aplicação de browser, utilize um cookie HTTP persistente para garantir que esse ID é utilizado em todas as sessões. Não utilize um cookie de sessão. Relativamente a outras aplicações, como aplicações móveis, utilize o armazenamento persistente do dispositivo para persistir o ID.

    Da próxima vez que o utilizador utilizar a aplicação nesse dispositivo, recebe o ID de cliente que foi persistido.

NOTA: as respostas do Bing podem incluir ou não este cabeçalho. Se a resposta incluir este cabeçalho, capture o ID de cliente e utilize-o em todos os pedidos do Bing subsequentes do utilizador nesse dispositivo.

NOTA: se incluir X-MSEdge-ClientID, não pode incluir cookies no pedido.
X-MSEdge-ClientIP Cabeçalho de pedido opcional.

O endereço IPv4 ou IPv6 do dispositivo cliente. O endereço IP é utilizado para detetar a localização do utilizador. O Bing utiliza as informações de localização para determinar o comportamento do safesearch.

NOTA: embora seja opcional, recomenda-se que especifique sempre este cabeçalho e o cabeçalho X-Search-Location.

Não ofusque a morada (por exemplo, ao alterar o último octeto para 0). Ofuscar a morada faz com que a localização não esteja perto da localização efetiva do dispositivo, o que pode fazer com que o Bing sirva resultados errados.
X-Search-Location Cabeçalho de pedido opcional.

Uma lista separada por ponto e vírgula de pares de chaves/valores que descreve a localização geográfica do cliente. O Bing utiliza as informações de localização para determinar o comportamento do safesearch e para devolver conteúdos locais relevantes. Especifique o par chave/valor como <key> : <value> . As chaves seguintes são as chaves utilizadas para especificar a localização do utilizador.

  • lat—Required. A latitude da localização do cliente, em graus. Tem de ser igual ou superior a -90,0 e inferior ou igual a +90,0. Os valores negativos indicam latitudes no hemisfério sul e os positivos latitudes no hemisfério norte.

  • long—Required. A longitude da localização do cliente, em graus. Tem de ser igual ou superior a -180.0 e inferior ou igual a +180.0. Os valores negativos indicam longitudes a ocidente e os positivos a oriente.

  • re—Required. O raio, em metros, que especifica a exatidão horizontal das coordenadas. Transmita o valor que o serviço de localização do dispositivo devolve. Os valores mais comuns podem ser 22 m para GPS/Wi-Fi, 380 m para triangulação de antenas e 18 000 m para pesquisa de IP inversa.

  • ts—Optional. O carimbo de data/hora UNIX UTC de quando o cliente estava na localização (o carimbo de data/hora é o número de segundos desde 1 de janeiro de 1970.)

  • head—Optional. O cabeçalho relativo do cliente ou a direção de deslocamento. Especifique a direção de deslocamento em graus, de 0 a 360, a contar no sentido dos ponteiros do relógio em relação ao norte verdadeiro. Especifique esta chave apenas se a chave sp não for zero.

  • sp—Optional. A velocidade horizontal, em metros por segundo, a que o dispositivo cliente se está a deslocar.

  • alt—Optional. A altitude do dispositivo cliente, em metros.

  • are—Optional. O raio, em metros, que especifica a exatidão vertical das coordenadas. Especifique esta chave apenas se especificar a chave alt.

  • disp — Opcional. A localização geográfica do utilizador no formulário, disp:<City, State>. Por exemplo, disp: Seattle, Washington. Esta é a versão de texto de exibição da localização do utilizador que especificou utilizando as teclas lat/long. Se este valor entrar em conflito com as coordenadas lat/long, bing utiliza o valor de disp como localização do utilizador.

NOTA: Bing ignora este cabeçalho se a consulta incluir uma localização. Por exemplo, se este cabeçalho refletir a localização do utilizador como São Francisco, mas a consulta são restaurantes seattle , Bing devolve restaurantes localizados em Seattle, Washington.

NOTA: embora muitas das chaves sejam opcionais, quanto mais informações fornecer, mais precisos serão os resultados da localização.

NOTA: embora seja opcional, recomenda-se que especifique sempre a localização geográfica do utilizador. Especificar a localização é particularmente importante se o endereço IP do cliente não refletir, com precisão, a localização física do utilizador (por exemplo, se este utilizar VPN). Para obter os melhores resultados, deverá incluir este cabeçalho e o cabeçalho X-Search-ClientIP, mas no mínimo, deverá incluir este cabeçalho.

Nota

Não se esqueça de que os Termos de Utilização requerem conformidade com toda a legislação aplicável, incluindo a relativa à utilização destes cabeçalhos. Por exemplo, em determinadas jurisdições, como a Europa, há requisitos para obter o consentimento do utilizador antes de colocar certos tipos de dispositivos de monitorização nos dispositivos dos utilizadores.

Parâmetros de consulta

Seguem-se os parâmetros de consulta que o pedido pode incluir. A coluna Necessário indica se tem de especificar o parâmetro. Tem de codificar com URL os valores dos parâmetros de consulta.

Name Valor Tipo Necessário
cc Um código de país de dois carateres do país de onde os resultados provêm. Para obter uma lista de valores possíveis, consulte códigos de mercado.

Se definir este parâmetro, também tem de especificar o cabeçalho Accept-Language. Bing usa a primeira língua suportada que encontra nas línguas especificadas e combina-a com o código do país para determinar o mercado para devolver resultados. Se a lista de idiomas não incluir um idioma suportado, o Bing encontra o idioma e o mercado mais parecidos que suportem o pedido. Ou, Bing pode usar um mercado agregado ou padrão para os resultados.

Utilize este parâmetro de consulta e o Accept-Language cabeçalho apenas se especificar vários idiomas. Caso contrário, deve utilizar os mkt parâmetros e setLang consultar.

Este parâmetro e o parâmetro de consulta mkt são mutuamente exclusivos — não os especifique a ambos.
String No
mkt O mercado de onde os resultados provêm. Tipicamente, mkt é o país onde o utilizador está a fazer o pedido. No entanto, poderia ser um país diferente se o utilizador não estiver localizado num país onde bing produz resultados. O mercado deve estar na <language code> - <country code> forma. Por exemplo: en-US. A corda é insensível. Para obter uma lista de possíveis valores de mercado, consulte códigos de mercado.

NOTA: Se for conhecido, é encorajado a especificar sempre o mercado. Desta forma, ajuda o Bing a encaminhar o pedido e a devolver a resposta adequada e ideal. Se especificar um mercado que não está listado nos Códigos de Mercado,o Bing utiliza um código de mercado mais adequado com base num mapeamento interno que está sujeito a alterações.

Este parâmetro e o parâmetro de consulta cc são mutuamente exclusivos — não os especifique a ambos.
String No
q A cadeia de consulta de pesquisa do utilizador.

A cadeia de consulta não deve estar vazia. Se estiver vazio ou não especificado, a lista de sugestões na resposta está vazia.

A API não suporta os Operadores Avançados Bing. Se a cadeia de consulta incluir operadores Bing, os operadores são tratados como parte da cadeia de consulta, e não como um operador.
String No
setLang O idioma a utilizar nas cadeias da interface de utilizador. Pode especificar o idioma usando um código de 2 letras ou 4 letras. É preferível a utilização de códigos de 4 letras.

Para obter uma lista de códigos linguísticos suportados, consulte as línguas apoiadas por Bing.

Bing carrega as cordas localizadas se setlang contiver um código de cultura neutro de 2 letras válido (fr) ou um código de cultura específico válido de 4 letras (fr-ca). Por exemplo, para fr-ca, Bing carrega as cordas de código de cultura neutra fr.

Se setlang não for válido (por exemplo, zh) ou Bing não suporta a língua (por exemplo, af, af-na), Bing defaults to en (inglês).

Para especificar o código de 2 letras, desa um parâmetro para um código linguístico ISO 639-1.

Para especificar o código de 4 letras, utilize o formulário -<> país/região onde se encontra um código linguístico ISO 639-1 (cultura neutra) e <> país/região iso 3166 (cultura específica). Por exemplo, use en-US para inglês dos Estados Unidos.

Embora seja opcional, deve indicar sempre o idioma. Normalmente, setLang é definido como o mesmo idioma especificado por mkt, a não ser que o utilizador queira que as cadeias da interface de utilizador sejam apresentadas noutro idioma.

Este parâmetro e o cabeçalho Accept-Language são mutuamente exclusivos — não especifique ambos.

As cadeias da interface de utilizador são cadeias utilizadas como etiquetas na interface de utilizador. Os objetos de resposta JSON têm poucas cadeias de interface de utilizador. Além disso, todas as ligações para propriedades de Bing.com nos objetos de resposta aplicam o idioma especificado.
String No

Objetos de resposta

Seguem-se os objetos JSON que a resposta pode incluir. Se o pedido for bem sucedido, o objeto de nível superior na resposta é o objeto Sugestões. Se o pedido falhar, o objeto de nível superior é ErrorResponse.

Objeto Description
Erro Define o erro que ocorreu.
Resposta de erros O objeto de nível superior que a resposta inclui quando o pedido falha.
QueryContexto Define o termo de consulta que Bing usou para o pedido.
SearchAction Define a consulta de pesquisa sugerida.
Grupo de Sugestões Define um grupo de sugestões do mesmo tipo.
Sugestões O objeto de nível superior que a resposta inclui quando o pedido é bem sucedido.

Erro

Define o erro que ocorreu.

Elemento Descrição Tipo
código O código de erro que identifica a categoria de erro. Para obter uma lista de códigos possíveis, consulte Códigos de Erro. String
Mensagem Descrição do erro. String
moreDetails Uma descrição que fornece informações adicionais sobre o erro. String
parâmetro O parâmetro de consulta no pedido que causou o erro. String
subCódigo O código de erro que identifica o erro. Por exemplo, se code for InválidaRequest, subCode pode ser ParâmetroInvalid ou ParameterInvalidValue. String
valor O valor do parâmetro de consulta que não era válido. String

Resposta de erros

O objeto de nível superior que a resposta inclui quando o pedido falha.

Name Valor Tipo
_type Tipo dica. String
erros Uma lista de erros que descrevem as razões pelas quais o pedido falhou. Erro[]

QueryContexto

Define o termo de consulta que Bing usou para o pedido.

Elemento Descrição Tipo
adultoIntente Não usado. Booleano
alterationOverrideQuery Não usado. String
alteradoQuery Não usado. String
askUserForLocation Não usado. String
OriginalQuery O termo de consulta do utilizador. String

SearchAction

Define uma sugestão de pesquisa de consulta.

Name Valor Tipo
displayText O termo de consulta sugerido para exibir numa interface de utilizador. String
consulta O termo de consulta sugerido.

Se o utilizador selecionar o termo de consulta a partir da lista de sugestões, utilize o termo num pedido de API Bing e apresente os resultados da pesquisa por si mesmo. Ou, utilize o URL no url campo para enviar o utilizador para a página de resultados de pesquisa de Bing para a consulta sugerida.
String
searchKind O tipo de sugestão. Seguem-se os valores possíveis.
  • CustomSearch — A sugestão é de uma fonte de dados de sugestão de pesquisa não-Web.
  • WebSearch — A sugestão é de uma fonte de dados de sugestão de pesquisa web.
String
url O URL que leva o utilizador à página de resultados de pesquisa de Bing para a consulta sugerida. String

Grupo de Sugestões

Define um grupo de sugestões do mesmo tipo.

Name Valor Tipo
nome O nome do grupo. O nome identifica o tipo de sugestões que o grupo contém. Por exemplo, sugestões de pesquisa na Web. Seguem-se os possíveis nomes de grupo.
  • Personalizado — O grupo contém sugestões de uma fonte de dados de sugestões de pesquisa não web.
  • Web — O grupo contém sugestões de pesquisa na Web.
String
pesquisaSuggestions Uma lista de até 8 sugestões. Se não houver sugestões, a matriz está vazia.

Deve apresentar todas as sugestões na ordem fornecida. A lista está em ordem de diminuir a relevância. A primeira sugestão é a mais relevante e a última sugestão é a menos relevante. O tamanho da lista está sujeito a alterações.
SearchAction[]

Sugestões

O objeto de nível superior que a resposta inclui quando o pedido é bem sucedido.

Se o serviço suspeitar de um ataque de negação de serviço, o pedido é bem sucedido (código de estado HTTP é de 200 OK). No entanto, o corpo da resposta está vazio.

Name Valor Tipo
_type O tipo de dica, que é definido para Sugestões. String
consultaContexto A cadeia de consulta do utilizador. QueryContexto
grupos de sugestões Uma lista de cordas de consulta sugeridas agrupadas por tipo. Por exemplo, sugestões de pesquisa na Web. Grupo de Sugestões[]

Códigos de erro

Seguem-se os possíveis códigos de estado http que um pedido devolve.

Código de Estado Descrição
200 Êxito.
400 Um dos parâmetros de consulta está em falta ou não é válido.
401 Falta a chave de subscrição ou não é válida.
403 O utilizador é autenticado (por exemplo, utilizou uma chave de subscrição válida) mas não tem permissão para o recurso solicitado.

Bing também pode devolver este estatuto se o chamador exceder as suas consultas por mês.
410 O pedido utilizou HTTP em vez do protocolo HTTPS. HTTPS é o único protocolo suportado.
429 O chamador excedeu as suas consultas por segunda quota.
500 Erro de servidor inesperado.

Se o pedido falhar, a resposta contém um objeto ErrorResponse, que contém uma lista de objetos error que descrevem o que causou o erro. Se o erro estiver relacionado com parameter um parâmetro, o campo identifica o parâmetro que é o problema. E se o erro estiver relacionado com value um valor de parâmetro, o campo identifica o valor que não é válido.

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidRequest", 
      "subCode": "ParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidAuthorization", 
      "subCode": "AuthorizationMissing", 
      "message": "Authorization is required.", 
      "moreDetails": "Subscription key is not recognized."
    }
  ]
}

Seguem-se os possíveis códigos de erro e os valores do código de sub-erro.

Código Subcódigo Descrição
Error do servidor Erro Inesperado
Erro de Recursos
Não Implementado
O código de estado HTTP é 500.
Pedido inválido Parâmetros desaparecidos
ParâmetroSInvalidValue
Httpnotado
Bloqueado
Devoluções Bing InvalidRequest sempre que qualquer parte do pedido não for válida. Por exemplo, falta um parâmetro necessário ou não é válido um valor de parâmetro.

Se o erro for ParameterMissing ou ParameterInvalidValue, o código de estado HTTP é de 400.

Se utilizar o protocolo HTTP em vez de HTTPS, bing devolve httpNotAllowed, e o código de estado HTTP é 410.
RateLimitExceeded Sem subcódigos Bing devolve RateLimitExceeded sempre que excede as suas consultas por segundo (QPS) ou consultas por mês (QPM) quota.

Se exceder o QPS, bing devolve o código de estado HTTP 429, e se exceder o QPM, bing devolve 403.
Autorização Inválida Autorização Faltando
AutorizaçãoRedundy
Bing devolve InvalidAuthorization quando Bing não pode autenticar o chamador. Por exemplo, Ocp-Apim-Subscription-Key falta o cabeçalho ou a chave de subscrição não é válida.

O despedimento ocorre se especificar mais do que um método de autenticação.

Se o erro for InvalidAuthorization, o código de estado HTTP é 401.
Autorização Insuficiente AutorizaçãoDeficiente
Autorizações Caducadas
Bing devolve InsuficienteAutorização quando o chamador não tem permissões para aceder ao recurso. Isto pode ocorrer se a chave de subscrição tiver sido desativada ou tiver expirado.

Se o erro for insuficiente, o código de estado HTTP é 403.

Códigos de mercado

A tabela que se segue lista os valores de código de mercado que pode utilizar para especificar o parâmetro de mkt consulta. Bing devolve conteúdo apenas para estes mercados. A lista está sujeita a alterações.

Para obter uma lista de códigos cc de país que possa especificar no parâmetro de consulta, consulte os códigos do País.

País/Região Idioma Código de mercado
Argentina Espanhol es-AR
Austrália Inglês en-UA
Áustria Alemão de-AT
Bélgica Neerlandês nl-BE
Bélgica Francês fr-BE
Brasil Português pt-BR
Canadá Inglês en-CA
Canadá Francês fr-CA
Chile Espanhol es-CL
Dinamarca Dinamarquês da-DK
Finlândia Finlandês fi-FI
França Francês fr-FR
Alemanha Alemão de-DE
RAE de Hong Kong Chinês Tradicional zh-HK
Índia Inglês en-IN
Indonésia Inglês en-ID
Itália Italiano it-IT
Japão Japonês ja-JP
Coreia Coreano ko-KR
Malásia Inglês en-MY
México Espanhol es-MX
Países Baixos Neerlandês nl-NL
Nova Zelândia Inglês en-NZ
Noruega Norueguês não-NÃO
República Popular da China Chinês zh-CN
Polónia Polaco pl-PL
República das Filipinas Inglês en-PH
Rússia Russo ru-RU
África do Sul Inglês en-ZA
Espanha Espanhol es-ES
Suécia Sueco sv-SE
Suíça Francês fr-CH
Suíça Alemão de-CH
Taiwan Chinês Tradicional zh-TW
Turquia Turco tr-TR
Reino Unido Inglês en-GB
Estados Unidos Inglês pt-PT
Estados Unidos Espanhol es-EUA

Códigos do país

Seguem-se os códigos do país cc que pode especificar no parâmetro de consulta. A lista está sujeita a alterações.

País/Região Código do País
Argentina AR
Austrália AU
Áustria AT
Bélgica BE
Brasil BR
Canadá CA
Chile CL
Dinamarca DK
Finlândia FI
França FR
Alemanha DE
RAE de Hong Kong HK
Índia IN
Indonésia ID
Itália TI
Japão JP
Coreia KR
Malásia MY
México MX
Países Baixos NL
Nova Zelândia NZ
Noruega NO
República Popular da China CN
Polónia PL
Portugal PT
República das Filipinas PH
Rússia RU
Arábia Saudita SA
África do Sul ZA
Espanha ES
Suécia SE
Suíça CH
Taiwan TW
Turquia TR
Reino Unido GB
Estados Unidos EUA

Bing línguas apoiadas

Seguem-se as línguas apoiadas pelo setLang Bing que pode especificar no parâmetro de consulta. A lista está sujeita a alterações.

Idiomas Suportados Código do Idioma
Árabe ar
Basco eu
Bengalês bn
Búlgaro bg
Catalão ca
Chinês (Simplificado) zh-hans
Chinês (Tradicional) zh-hant
Croata hr
Checo cs
Dinamarquês da
Neerlandês nl
Inglês en
Inglês-Reino Unido en-gb
Estónio et
Finlandês fi
Francês fr
Galego gl
Alemão de
Guzerate gu
Hebraico ele
Hindi Olá
Húngaro hu
Islandês é
Italiano lo
Japonês jp
Canarês kn
Coreano ko
Letão lv
Lituano lt
Malaio ms
Malaiala  ml
Marata mr
Norueguês (Bokmål) nb
Polaco pl
Português (Brasil) pt-br
Português (Portugal) pt-pt
Punjabi pa
Romeno ro
Russo ru
Sérvio (Cyrylic) sr.
Eslovaco sk
Esloveno sl
Espanhol es
Sueco sv
Tâmil ta
Telugu te
Tailandês th
Turco tr
Ucraniano Reino Unido
Vietnamita vi