Freigeben über

Create Lesezeichen

  • Artikel

Namespace: microsoft.graph.search

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Create ein neues Lesezeichenobjekt.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

HTTP-Anforderung

POST /search/bookmarks

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Lesezeichenobjekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen eines Lesezeichens verfügbar sind.

Eigenschaft Typ Beschreibung
availabilityEndDateTime DateTimeOffset Datum und Uhrzeit, zu dem das Lesezeichen nicht mehr als Suchergebnis angezeigt wird. Legen Sie als null für always available fest. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
availabilityStartDateTime DateTimeOffset Datum und Uhrzeit, zu dem das Lesezeichen als Suchergebnis angezeigt wird. Legen Sie als null für always available fest. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
categories String collection Kategorien, die häufig zum Beschreiben dieses Lesezeichens verwendet werden. Beispiel: IT und HR.
description String Die Textmarkenbeschreibung, die auf der Suchergebnisseite angezeigt wird. Geerbt von searchAnswer.
displayName String Der Textmarkenname, der in den Suchergebnissen angezeigt wird. Geerbt von searchAnswer.
groupIds Zeichenfolgenauflistung Die Liste der Sicherheitsgruppen, die dieses Lesezeichen anzeigen können.
"keywords" microsoft.graph.search.answerKeyword Schlüsselwörter, die auslösen, dass dieses Lesezeichen in Suchergebnissen angezeigt wird.
languageTags String-Sammlung Eine Liste mit geografisch spezifischen Sprachnamen, in denen dieses Lesezeichen angezeigt werden kann. Jeder Sprachtagwert folgt dem Muster {language}-{region}. Beispielsweise ist Englisch, en-us wie in der USA verwendet. Eine Liste der möglichen Werte finden Sie unter Unterstützte Sprachtags.
Plattformen microsoft.graph.devicePlatformType-Sammlung Liste der Geräte und Betriebssysteme, die dieses Lesezeichen anzeigen können. Mögliche Werte: android, androidForWork, ios, macOS, windowsPhone81, windowsPhone81AndLater, windows10AndLater, androidWorkProfile, unknown, androidASOP, androidMobileApplicationManagement, iOSMobileApplicationManagement, unknownFutureValue.
powerAppIds Zeichenfolgensammlung Liste der Power Apps, die diesem Lesezeichen zugeordnet sind. Wenn Benutzer vorhandene Power Apps zu einem Lesezeichen hinzufügen, können sie Aufgaben direkt auf der Suchergebnisseite ausführen, z. B. die Eingabe von Urlaubszeiten oder das Melden von Ausgaben.
state microsoft.graph.search.answerState Status des Lesezeichens. Mögliche Werte: published, draft, excluded, unknownFutureValue
targetedVariations microsoft.graph.search.answerVariant-Sammlung Variationen eines Lesezeichens für verschiedene Länder oder Geräte. Verwenden Sie diese Option, wenn Sie benutzern je nach Gerät, Land/Region oder beidem unterschiedliche Inhalte anzeigen müssen. Die Datums- und Gruppeneinstellungen gelten für alle Variationen.
webUrl String Der URL-Link für das Lesezeichen. Wenn Benutzer dieses Lesezeichen aus den Suchergebnissen auswählen, werden sie an die angegebene URL weitergeleitet. Geerbt von searchAnswer.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode mit der ID des erstellten Lesezeichens zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/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": ["Unique keyword"],
    "matchSimilarKeywords": true
  },
  "availabilityStartDateTime": null,
  "availabilityEndDateTime": null,
  "platforms": ["windows"],
  "targetedVariations": [
    {
      "languageTag": "es-es",
      "displayName": "Sitio de instalación Contoso",
      "description": "Pruebe o compre Contoso hogar o negocios y vea la información del producto"
    }
  ],
  "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"
}