Type de ressource searchRequest

Espace de noms: microsoft.graph

Demande de recherche mise en forme dans un objet blob JSON.

L’objet blob JSON contient les types de ressources attendus dans la réponse, les sources sous-jacentes, les paramètres de pagination, les options de tri, les agrégations et les champs demandés, ainsi que la requête de recherche réelle. Consultez des exemples de demandes de recherche sur diverses ressources.

Remarque

Tenez compte des limitations connues concernant la recherche de combinaisons spécifiques de types d’entités et le tri ou l’agrégation des résultats de recherche.

Propriétés

Propriété Type Description
aggregationFilters String collection Contient un ou plusieurs filtres pour obtenir des résultats de recherche agrégés et filtrés sur une valeur spécifique d’un champ. Optional.
Créez ce filtre en fonction d’une recherche précédente qui agrège par le même champ. À partir de la réponse de la recherche précédente, identifiez le searchBucket qui filtre les résultats sur la valeur spécifique du champ, utilisez la chaîne dans sa propriété aggregationFilterToken et générez une chaîne de filtre d’agrégation au format « {field} :\"{aggregationFilterToken}\ » ».
Si plusieurs valeurs pour le même champ doivent être fournies, utilisez les chaînes de sa propriété aggregationFilterToken et générez une chaîne de filtre d’agrégation au format « {field} :or(\"{aggregationFilterToken1}\ »,\"{aggregationFilterToken2}\ ») ».
Par exemple, la recherche et l’agrégation d’éléments de lecteur par type de fichier retournent un searchBucket pour le type docx de fichier dans la réponse. Vous pouvez facilement utiliser l’agrégationFilterToken retournée pour ce searchBucket dans une requête de recherche ultérieure et filtrer les correspondances vers le docx bas pour les éléments du type de fichier. Les exemples 1 et 2 montrent les demandes et réponses réelles.
aggregations collection aggregationOption Spécifie les agrégations (également appelées affinements) à retourner avec les résultats de la recherche. Optional.
collapseProperties collection collapseProperty Contient la collection ordonnée de champs et limite pour réduire les résultats. Optional.
contentSources String collection Contient la connexion à cibler.
enableTopResults Valeur booléenne Cela déclenche un tri hybride pour les messages : les 3 premiers messages sont les plus pertinents. Cette propriété s’applique uniquement à entityType=message. Optional.
entityTypes collection entityType Un ou plusieurs types de ressources attendus dans la réponse. Les valeurs possibles sont les suivantes : event, message, driveItem, externalItem, site, list, listItem, drive, chatMessage, person, acronym et bookmark. Notez que vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : chatMessage, person, acronym, bookmark. Consultez les limitations connues pour les combinaisons de deux types d’entités ou plus pris en charge dans la même demande de recherche. Obligatoire.
fields String collection Contient les champs à retourner pour chaque objet de ressource spécifié dans entityTypes, ce qui permet la personnalisation des champs retournés par défaut ; sinon, en incluant des champs supplémentaires tels que des propriétés gérées personnalisées à partir de SharePoint et OneDrive, ou des champs personnalisés dans externalItem à partir du contenu que les connecteurs Microsoft Graph apportent. La propriété fields peut utiliser les étiquettes sémantiques appliquées aux propriétés. Par exemple, si une propriété est étiquetée comme titre, vous pouvez la récupérer à l’aide de la syntaxe suivante : label_title. Optional.
de Int32 Spécifie le décalage pour les résultats de la recherche. Offset 0 retourne le tout premier résultat. Optional.
requête searchQuery Contient les termes de la requête. Obligatoire.
queryAlterationOptions searchAlterationOptions Options de modification de requête mises en forme dans un objet blob JSON qui contient deux indicateurs facultatifs liés à la correction orthographique. Optional.
région Chaîne Emplacement géographique de la recherche. Obligatoire pour les recherches qui utilisent des autorisations d’application. Pour plus d’informations, consultez Obtenir la valeur de la région.
resultTemplateOptions collection resultTemplateOption Fournit les options du modèle de résultat de recherche pour afficher les résultats de recherche à partir de connecteurs.
sharePointOneDriveOptions sharePointOneDriveOptions Indique le type de contenu à rechercher lorsqu’une recherche est effectuée à l’aide d’autorisations d’application. Optional.
size Int32 Taille de la page à récupérer. La valeur maximale est 500. Optional.
sortProperties collection sortProperty Contient la collection ordonnée de champs et de direction pour trier les résultats. La collection peut comporter au maximum 5 propriétés de tri. Optional.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "aggregationFilters": ["String"],
  "aggregations": [{"@odata.type": "microsoft.graph.aggregationOption"}],
  "collapseProperties": [{"@odata.type": "microsoft.graph.collapseProperty"}],
  "enableTopResults": "Boolean",
  "entityTypes": ["String"],
  "contentSources": ["String"],
  "fields": ["String"],
  "from": "Int32",
  "query": {"@odata.type": "microsoft.graph.searchQuery"},
  "queryAlterationOptions": {"@odata.type": "microsoft.graph.searchAlterationOptions"},
  "region": "String",
  "resultTemplateOptions": [{"@odata.type": "microsoft.graph.resultTemplateOption"}],
  "sharePointOneDriveOptions": {"@odata.type": "microsoft.graph.sharePointOneDriveOptions"},
  "size": "Int32"
}