Utiliser l’API Recherche Microsoft pour rechercher des questions et des réponses

  • Article
  • 2 minutes de lecture

Vous pouvez utiliser l’API Recherche Microsoft dans Microsoft Graph pour rechercher des questions et réponses (Q&As). La ressource qna représente Q&As dans Recherche Microsoft. Les administrateurs peuvent créer des Q&As dans le Centre d'administration Microsoft 365 ou via l’API Créer qna.

Attention

Le schéma de l’API de recherche a changé dans la version bêta. Certaines propriétés d’une demande de recherche et d’une réponse ont été renommées ou supprimées. Pour plus d’informations, consultez Avertissement de dépréciation de modification de schéma. Les exemples de cette rubrique montrent le schéma à jour.

Après avoir créé vos Q&As, vous pouvez utiliser l’API Recherche Microsoft Graph pour les rechercher. Pour ce faire, spécifiez qna comme valeur dans la propriété entityTypes dans le corps de votre demande de recherche, puis fournissez une chaîne de requête appropriée, comme illustré dans l’exemple suivant.

Exemple : Rechercher Q&As

Demande

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

{
  "requests": [
    {
      "entityTypes": [
        "qna"
      ],
      "query": {
        "queryString":"what is Microsoft Azure"
      }
    }
  ]
}

Réponse

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#search",
  "value": [
  {
   "@odata.type": "#microsoft.graph.searchResponse",
   "hitsContainers": [
    {
     "@odata.type": "#microsoft.graph.searchHitsContainer",
     "hits": [
      {
        "hitId": "2364ebd9-cd11-4f47-b785-fe378c6233f3",
        "rank": 1,
        "resource": {
          "@odata.type": "#microsoft.graph.search.qna",
          "id": "2364ebd9-cd11-4f47-b785-fe378c6233f3",
          "displayName": "what is Microsoft Azure",
          "description": "Microsoft Azure is a cloud computing platform and an online portal that allows you to access and manage cloud services and resources provided by Microsoft.",
          "webUrl": "https://azure.microsoft.com/en-us/resources/cloud-computing-dictionary/what-is-azure/"
        }
      }
     ],
     "total": 1,
     "moreResultsAvailable": false
    }
   ]
  }
 ]
}

Problèmes connus

  • Le tri, l’agrégation et la pagination ne sont pas pris en charge pour les recherches [qna]((/graph/api/resources/search-qna).
  • La recherche combinée avec des entityTypes non-Answer (par exemple, driveItem, list) n’est pas prise en charge. Seule la recherche combinée avec les autres signets, qna et acronyme answer entityTypes est prise en charge.

Prochaines étapes