Compartilhar via


Configurar respostas de pesquisa administrativa para usuários em uma organização

O Microsoft Pesquisa permite que os administradores associem os termos de pesquisa a significados ou páginas da Web específicos para suas organizações e incluam essas associações como respostas de pesquisa. Por exemplo, os usuários de 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 QnAs 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 do Microsoft Pesquisa no Microsoft Graph para gerenciar programaticamente respostas de pesquisa administrativa na organização. Essas respostas são exibidas na Microsoft Pesquisa resultados quando disparadas por um acrônimo ou palavra-chave definidas nos tipos de recurso de resposta de pesquisa disponíveis: recursos de sigla, indicador e 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 é exibido na página de resultados da pesquisa quando um usuário o pesquisa.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/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

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created
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 é exibido na página de resultados da pesquisa quando um usuário pesquisa pelo menos uma de suas palavras-chave.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/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

O exemplo a seguir mostra a 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