Comentários Editar

Configurar respostas de pesquisa administrativa para usuários em uma organização (versão prévia)

  • Artigo
  • 2 minutos para o fim da leitura

A Pesquisa da Microsoft permite que os administradores associem termos de pesquisa a significados ou páginas da Web específicas de suas organizações e incluam essas associações como respostas de pesquisa. Por exemplo, os usuários em uma organização podem encontrar um acrônimo desconhecido que representa um nome de projeto interno ou um nome de equipe associado a uma página da Web da equipe. Os administradores podem configurar acrônimos, indicadores ou QnA no Centro de administração do Microsoft 365, em Pesquisa & inteligência. Isso permite que os usuários usem a pesquisa para navegar e se familiarizar com seu trabalho.

Os administradores também podem usar a API de Pesquisa da Microsoft no Microsoft Graph para gerenciar programaticamente as respostas de pesquisa administrativa na organização. Essas respostas são exibidas nos resultados da Pesquisa da Microsoft quando disparadas por um acrônimo ou palavra-chave definido nos tipos de recursos de resposta de pesquisa disponíveis: acrônimo , indicador e recursos de QnA .

Quando disparadas por um acrônimo ou palavra-chave definido, essas respostas de pesquisa aparecem na parte superior da página de resultados da pesquisa em sua organização.

Exemplo 1: Criar um novo acrônimo

A solicitação a seguir cria um novo acrônimo que será exibido na página de resultados da pesquisa quando um usuário o procurar.

Solicitação

POST https://graph.microsoft.com/beta/search/acronyms
Content-Type: application/json

{
  "displayName": "GDPR",
  "standsFor": "General Data Protection Regulation",
  "description": "A European Union (EU) regulation on data protection and privacy in the EU and the European Economic Area (EEA) that enhances individuals' control and rights over their personal data, simplifies the regulatory environment for international business, and addresses the transfer of personal data outside the EU and EEA areas.",
  "webUrl": "http://contoso.com/GDPR",
  "state": "published"
}

Resposta

Veja a seguir um exemplo da resposta.

HTTP/1.1 200 Ok
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}

Exemplo 2: Criar um novo indicador

A solicitação a seguir cria um novo indicador que será exibido na página de resultados da pesquisa quando um usuário procurar pelo menos uma de suas palavras-chave.

Solicitação

POST https://graph.microsoft.com/beta/search/bookmarks
Content-Type: application/json

{
  "displayName": "Contoso Install Site",
  "webUrl": "http://www.contoso.com/",
  "description": "Try or buy Contoso for Home or Business and view product information",
  "keywords":  {
    "keywords": ["Contoso", "install"],
    "reservedKeywords": ["Contoso"],
    "matchSimilarKeywords": true
  },
  "state": "published"
}

Resposta

Veja a seguir um exemplo da resposta.

HTTP/1.1 201 CREATED
Location: /733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}

Próximas etapas