Utiliser l’API Microsoft Search dans Microsoft Graph pour rechercher des fichiersUse the Microsoft Search API in Microsoft Graph to search files

Vous pouvez utiliser l’API de recherche de Microsoft pour rechercher des fichiers stockés dans SharePoint ou OneDrive.You can use the Microsoft Search API to search files stored in SharePoint or OneDrive. L’API Microsoft Search utilise un modèle de pertinence qui utilise des signaux de Microsoft Graph concernant les relations et les activités des utilisateurs.The Microsoft Search API uses a relevance model that makes use of signals from Microsoft Graph about users' relationships and activities. Cela vous permet de renvoyer et de promouvoir le contenu que les utilisateurs intéressent, dans une expérience de recherche de fichiers cohérente avec l’onglet fichiers qui répertorie les résultats de recherche dans SharePoint.This enables you to return and promote the content that users care about, in a file search experience that is consistent with the Files tab that lists search results in SharePoint.

Important

Les connecteurs Microsoft Graph et les API Microsoft Search (requête et index) sont actuellement en état d’aperçu.Microsoft Graph connectors and Microsoft Search APIs (query and index) are currently in preview status. Pour utiliser des connecteurs avec Microsoft Search ou pour créer des connecteurs, vous devez vous inscrire au programme d’aperçu des connecteurs.To use connectors with Microsoft Search or to build connectors, you must sign up for the connectors preview program. Pour rejoindre le programme d’aperçu, envoyez le formulaire d’inscription de l' aperçu des connecteurs Microsoft Graph.To join the preview program, submit the Microsoft Graph connectors preview sign-up form.

Rechercher des fichiers SharePoint ou OneDriveSearch SharePoint or OneDrive files

Vous pouvez utiliser KQL dans les termes de recherche pour SharePoint et OneDrive.You can use KQL in search terms of queries for SharePoint and OneDrive. Par exemple :For example:

  • "query": "contoso filetype:docx OR filetype:doc"étend la requête aux documents Word."query": "contoso filetype:docx OR filetype:doc" scopes the query to Word documents.
  • "query": "test path:\"https://contoso.sharepoint.com/sites/Team Site/Documents/Project\\""étend la requête à un dossier particulier au sein d’un site."query": "test path:\"https://contoso.sharepoint.com/sites/Team Site/Documents/Project\\"" scopes the query to a particular folder within a site.

Pour être valide, la restriction des propriétés doit spécifier un nom de propriété gérée utilisable dans une requête valide dans la condition.In order to be valid, properties restriction should specify a valid, queryable managed property name in the condition.

ExempleExample

DemandeRequest

POST /search/query
Content-Type: application/json
{
  "requests": [
    {
      "entityTypes": [
        "driveItem"
      ],
      "query": {
        "query_string": {
          "query": "contoso"
        }
      },
      "from": 0,
      "size": 25
    }
  ]
}

RéponseResponse

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#search",
  "value": [
    {
      "searchTerms": [
        "test"
      ],
      "hitsContainers": [
        {
          "total": 350,
          "moreResultsAvailable": true,
          "hits": [
            {
              "_id": "FlULeN/ui/1GjLx1rUfio5UAAEl",
              "_score": 1,
              "_sortField": "Relevance",
              "_summary": "<c0>Contoso</c0> Detailed Design <ddd/>",
              "_source": {
                "@odata.type": "#microsoft.graph.driveItem",
                "createdDateTime": "2019-06-10T06:37:43Z",
                "lastModifiedDateTime": "2019-06-10T06:37:43Z",
                "name": "web_part_test_long Notebook",
                "webUrl": "https://contoso.sharepoint.com/sites/contoso-team/contoso-designs.docx",
                "lastModifiedBy": {
                  "user": {
                    "displayName": "Richard Mayer"
                  }
                },
                "fileSystemInfo": {
                  "createdDateTime": "2019-06-10T06:37:43Z",
                  "lastModifiedDateTime": "2019-06-10T06:37:43Z"
                }
              }
            }
          ]
        }
      ]
    }
  ]
}

Étapes suivantesNext steps