Freigeben über


Einrichten administrativer Suchantworten für Benutzer in einem organization

Mit Microsoft Search können Administratoren Suchbegriffe mit Bedeutungen oder Webseiten zuordnen, die für ihre Organisation spezifisch sind, und diese Zuordnungen als Suchantworten einschließen. Beispielsweise können Benutzer in einem organization auf ein unbekanntes Akronym stoßen, das einen internen Projektnamen darstellt, oder auf einen Teamnamen, der einer Teamwebsite zugeordnet ist. Administratoren können Akronyme, Lesezeichen oder QnAs im Microsoft 365 Admin Center unter Search & Intelligence einrichten. Auf diese Weise können Benutzer die Suche verwenden, um zu navigieren und sich mit ihrer Arbeit vertraut zu machen.

Administratoren können auch die Microsoft Search-API in Microsoft Graph verwenden, um administrative Suchantworten im organization programmgesteuert zu verwalten. Diese Antworten werden in Microsoft Search Ergebnissen angezeigt, wenn sie durch ein Akronym oder Schlüsselwort (keyword) ausgelöst werden, das in den verfügbaren Ressourcentypen für Suchantworten definiert ist: Akronym, Lesezeichen und qna-Ressourcen.

Wenn sie durch ein definiertes Akronym oder Schlüsselwort (keyword) ausgelöst werden, werden diese Suchantworten oben auf der Suchergebnisseite in Ihrem organization angezeigt.

Beispiel 1: Erstellen eines neuen Akronyms

Die folgende Anforderung erstellt ein neues Akronym, das auf der Suchergebnisseite angezeigt wird, wenn ein Benutzer danach sucht.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Content-Type: application/json

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

Beispiel 2: Erstellen eines neuen Lesezeichens

Die folgende Anforderung erstellt ein neues Lesezeichen, das auf der Suchergebnisseite angezeigt wird, wenn ein Benutzer nach mindestens einem seiner Schlüsselwörter sucht.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

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

Nächste Schritte