SpellCheckClientExtensions.SpellCheckerAsync Methode

text

String

Die Textzeichenfolge, die auf Rechtschreib- und Grammatikfehler überprüft werden soll. Die kombinierte Länge der Textzeichenfolge, der preContextText-Zeichenfolge und der postContextText-Zeichenfolge darf 10.000 Zeichen nicht überschreiten. Sie können diesen Parameter in der Abfragezeichenfolge einer GET-Anforderung oder im Textkörper einer POST-Anforderung angeben. Aufgrund der Längenbegrenzung für Abfragezeichenfolgen verwenden Sie in der Regel eine POST-Anforderung, es sei denn, Sie überprüfen nur kurze Zeichenfolgen.

acceptLanguage

String

Eine durch Trennzeichen getrennte Liste einer oder mehrerer Sprachen, die für Benutzeroberflächenzeichenfolgen verwendet werden soll. Die Liste ist absteigend nach Präferenz sortiert. Weitere Informationen, einschließlich des erwarteten Formats, finden Sie unter RFC2616. Dieser Header und der abfrageparameter setLang schließen sich gegenseitig aus. Geben Sie nicht beides an. Wenn Sie diesen Header festlegen, müssen Sie auch den Abfrageparameter „cc“ angeben. Bing verwendet die erste unterstützte Sprache, die es aus der Liste findet, und kombiniert diese Sprache mit dem cc-Parameterwert, um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen. Wenn die Liste keine unterstützte Sprache enthält, findet Bing die nächstgelegene Sprache und den nächstgelegenen Markt, der die Anforderung unterstützt, und verwendet möglicherweise einen aggregierten oder Standardmarkt für die Ergebnisse anstelle eines angegebenen. Sie sollten diesen Header und den cc-Abfrageparameter nur verwenden, wenn Sie mehrere Sprachen angeben. Andernfalls sollten Sie die Abfrageparameter mkt und setLang verwenden. Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird. In den JSON-Antwortobjekten gibt es nur sehr wenige Benutzeroberflächenzeichenfolgen. Alle Links in den Antwortobjekten zu Bing.com Eigenschaften wenden die angegebene Sprache an.

pragma

String

Als Standardeinstellung gibt Bing zwischengespeicherte Inhalte (sofern vorhanden) zurück. Wenn Sie dies verhindern möchten, legen Sie den Pragma-Header auf „no-cache“ fest (z.B. „Pragma: no-cache“).

userAgent

String

Der Benutzer-Agent, von dem die Anforderung stammt. Bing verwendet den Benutzer-Agent, um die Erfahrung mobiler Benutzer zu optimieren. Obwohl optional, wird dringend empfohlen, diesen Header immer anzugeben. Der Benutzer-Agent sollte dieselbe Zeichenfolge aufweisen, die jeder häufig verwendete Browser senden würde. Informationen zu Benutzer-Agents finden Sie in RFC 2616.

clientId

String

Bing verwendet diesen Header, um Benutzern beim Aufrufen der Bing-API ein konsistentes Verhalten bereitzustellen. Bing testet häufig neue Funktionen und Verbesserungen und verwendet dabei die Client-ID als Schlüssel für die Zuweisung von Datenverkehr an verschiedene Flights. Wenn Sie für einen Benutzer bei unterschiedlichen Anforderungen nicht dieselbe Client-ID verwenden, weist Bing den Benutzer möglicherweise mehreren widersprüchlichen Flights zu. Die Zuweisung zu mehreren widersprüchlichen Flights kann zu einer inkonsistenten Benutzererfahrung führen. Weist die zweite Anforderung beispielsweise eine andere Flight-Zuweisung als die erste auf, kann dies zu einer unerwarteten Benutzererfahrung führen. Außerdem kann Bing die Client-ID zur Anpassung der Webergebnisse an den Suchverlauf dieser Client-ID verwenden. Dies führt zu einer noch besseren Benutzererfahrung. Bing verwendet den Header auch, um die Rangfolge der Ergebnisse zu verbessern, indem es die Aktivität der Client-ID analysiert. Durch die verbesserte Relevanz erhöht sich die Qualität der von Bing-APIs bereitgestellten Ergebnisse, was wiederum zu höheren Durchklickraten für den API-Consumer führt. WICHTIG: Auch wenn er optional ist, sollten Sie diesen Header als erforderlich betrachten. Das Beibehalten der Client-ID für dieselbe Kombination aus Benutzer und Gerät über mehrere Anforderungen hinweg ermöglicht 1) dem API-Consumer eine konsistente Benutzererfahrung sowie 2) höhere Durchklickraten durch eine bessere Qualität der Bing-API-Ergebnisse. Jeder Benutzer, der die Anwendung auf dem Gerät verwendet, muss über eine eindeutige, von Bing generierte Client-ID verfügen. Wenn Sie diesen Header nicht in die Anforderung einfügen, generiert Bing eine ID, die im Antwortheader „X-MSEdge-ClientID“ zurückgegeben wird. Der einzige Zeitpunkt, zu dem dieser Header NICHT in eine Anforderung eingeschlossen werden sollte, ist bei der erstmaligen Verwendung der App auf dem Gerät. Verwenden Sie die Client-ID für jede Anforderung der Bing-API, die die App für diesen Benutzer auf dem Gerät durchführt. Behalten Sie die Client-ID bei. Verwenden Sie ein permanentes HTTP-Cookie, um sicherzustellen, dass die ID in einer Browser-App bei allen Sitzungen verwendet wird. Verwenden Sie kein Sitzungscookie. Verwenden Sie für andere Apps wie z.B. mobile Apps den permanenten Speicher des Geräts, um die ID beizubehalten. Rufen Sie bei der nächsten Verwendung der App auf dem Gerät durch den Benutzer die gespeicherte Client-ID ab. Bing-Antworten können diesen Header enthalten, müssen es aber nicht. Enthält die Antwort diesen Header, erfassen Sie die Client-ID, und verwenden Sie sie für alle nachfolgenden Bing-Anforderungen des Benutzers auf diesem Gerät. Wenn Sie den Header „X-MSEdge-ClientID“ einfügen, dürfen Sie in die Anforderung nicht gleichzeitig Cookies einschließen.

clientIp

String

Die IPv4- oder IPv6-Adresse des Clientgeräts. Die IP-Adresse wird verwendet, um den Standort des Benutzers zu ermitteln. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten. Auch wenn dies optional ist, sollten Sie diesen Header und den Header „X-Search-Location“ immer angeben. Verschleiern Sie nicht die Adresse (z.B. durch Ändern des letzten Oktetts in 0). Durch Verschleiern der Adresse stimmen Ihr Standort und der tatsächliche Gerätestandort nicht überein, wodurch Bing möglicherweise fehlerhafte Ergebnisse anzeigt.

location

String

Eine durch Semikolons getrennte Liste mit Schlüssel/Wert-Paaren, die den geografischen Standort des Clients beschreiben. Bing verwendet die Standortinformationen für ein sicheres Suchverhalten und zur Rückgabe von lokalen relevanten Inhalten. Geben Sie das Schlüssel-Wert-Paar im Format <Schlüssel>:<Wert> an. Verwenden Sie die folgenden Schlüssel zur Angabe des Benutzerstandorts. lat (erforderlich): Der Breitengrad des Clientstandorts in Grad. Der Breitengrad muss größer als oder gleich -90,0 und kleiner als oder gleich +90,0 sein. Negative Werte geben südliche Breitengrade und positive Werte nördliche Breitengrade an. long (erforderlich): Der Längengrad des Clientstandorts in Grad. Der Längengrad muss größer als oder gleich -180,0 und kleiner als oder gleich +180,0 sein. Negative Werte geben westliche Längengrade und positive Werte östliche Längengrade an. re (erforderlich): Der Radius in Metern, der die horizontale Genauigkeit der Koordinaten angibt. Übergeben Sie den Wert, der vom Standortdienst des Geräts zurückgegeben wird. Typische Werte sind 22 m für GPS/WLAN, 380 m für die Funkmasttriangulation und 18.000 m für die umgekehrte IP-Suche. ts (optional): Der UTC-UNIX-Zeitstempel des Zeitpunkts, an dem sich der Client am Standort befand. (Der UNIX-Zeitstempel ist die Anzahl von Sekunden seit dem 1. Januar 1970.) head (optional): Die relative Richtung oder Fahrtrichtung des Clients. Geben Sie die Reiserichtung von 0 bis 360 (in Grad) im Uhrzeigersinn ausgehend vom geografischen Norden an. Geben Sie diesen Schlüssel nur an, wenn der SP-Schlüssel nichtzero ist. sp (optional): Die horizontale Geschwindigkeit (Geschwindigkeit) in Metern pro Sekunde, die das Clientgerät unterwegs ist. alt (optional): Die Höhe des Clientgeräts in Metern. sind (optional): Der Radius in Metern, der die vertikale Genauigkeit der Koordinaten angibt. Geben Sie diesen Schlüssel nur an, wenn Sie die Alt-Taste angeben. Auch wenn viele der Schlüssel optional sind, werden die Standortergebnisse immer genauer, je mehr Informationen Sie bereitstellen. Auch wenn dies optional ist, sollten Sie den geografischen Standort des Benutzers immer angeben. Besonders wichtig ist die Standortangabe dann, wenn die IP-Adresse des Clients den physischen Standort des Benutzers nicht exakt wiedergibt (wenn der Client beispielsweise VPN verwendet). Um optimale Ergebnisse zu erzielen, sollten Sie diesen Header und den X-Search-ClientIP-Header einschließen, aber mindestens diesen Header einschließen.

actionType

String

Eine Zeichenfolge, die von der Protokollierung verwendet wird, um zu bestimmen, ob die Anforderung aus einer interaktiven Sitzung oder einem Seitenladen stammt. Folgende Werte sind möglich: 1) Bearbeiten – Die Anforderung stammt aus einer interaktiven Sitzung 2) Laden– Die Anforderung stammt aus einer Seitenlade. Mögliche Werte: "Bearbeiten", "Load"

appName

String

Der eindeutige Name Ihrer App. Der Name muss Bing bekannt sein. Schließen Sie diesen Parameter nicht ein, es sei denn, Sie haben sich zuvor mit Bing in Verbindung setzen, um einen eindeutigen App-Namen zu erhalten. Wenden Sie sich an Ihren Bing Business Development Manager, um einen eindeutigen Namen zu erhalten.

countryCode

String

Ein zweistelliger Ländercode des Landes, aus dem die Ergebnisse stammen. Diese API unterstützt nur den USA Markt. Wenn Sie diesen Abfrageparameter angeben, muss er auf uns festgelegt werden. Wenn Sie diesen Parameter festlegen, müssen Sie auch den Header Accept-Language angeben. Bing verwendet die erste unterstützte Sprache, die aus der Sprachenliste gefunden wird, und kombiniert diese Sprache mit dem von Ihnen angegebenen Ländercode, um den Markt zu bestimmen, für den Ergebnisse zurückgegeben werden sollen. Wenn die Sprachenliste keine unterstützte Sprache enthält, findet Bing die nächstgelegene Sprache und den nächstgelegenen Markt, der die Anforderung unterstützt, oder es kann einen aggregierten oder Standardmarkt für die Ergebnisse anstelle eines angegebenen verwenden. Sie sollten diesen Abfrageparameter und den Accept-Language Abfrageparameter nur verwenden, wenn Sie mehrere Sprachen angeben. Andernfalls sollten Sie die Abfrageparameter mkt und setLang verwenden. Dieser Parameter und der Abfrageparameter mkt schließen sich gegenseitig aus. Geben Sie daher nicht beide an.

clientMachineName

String

Ein eindeutiger Name des Geräts, von dem die Anforderung ausgeführt wird. Generieren Sie einen eindeutigen Wert für jedes Gerät (der Wert ist unwichtig). Der Dienst verwendet die ID, um Probleme zu debuggen und die Qualität von Korrekturen zu verbessern.

docId

String

Eine eindeutige ID, die das Dokument identifiziert, zu dem der Text gehört. Generieren Sie einen eindeutigen Wert für jedes Dokument (der Wert ist unwichtig). Der Dienst verwendet die ID, um Probleme zu debuggen und die Qualität von Korrekturen zu verbessern.

market

String

Der Markt, aus dem die Ergebnisse stammen. Es wird dringend empfohlen, immer den Markt anzugeben, sofern bekannt. Die Angabe des Marktes ermöglicht Bing, die Anforderung weiterzuleiten und eine geeignete und optimale Antwort zurückzugeben. Dieser Parameter und der Abfrageparameter cc schließen sich gegenseitig aus. Geben Sie daher nicht beide an.

sessionId

String

Eine eindeutige ID, die diese Benutzersitzung identifiziert. Generieren Sie einen eindeutigen Wert für jede Benutzersitzung (der Wert ist unwichtig). Der Dienst verwendet die ID, um Probleme zu debuggen und die Qualität von Korrekturen zu verbessern.

setLang

String

Die Sprache, die für Zeichenfolgen der Benutzeroberfläche verwendet werden soll. Geben Sie die Sprache mithilfe des zweistelligen Sprachcodes nach ISO 639-1 an. Der Sprachcode für Englisch lautet z.B. „EN“. Der Standardwert ist „EN“ (Englisch). Auch wenn dies optional ist, sollten Sie immer eine Sprache angeben. In der Regel legen Sie setLang auf dieselbe Sprache fest, die von mkt angegeben wird, es sei denn, der Benutzer möchte, dass die Benutzeroberfläche-Zeichenfolgen in einer anderen Sprache angezeigt werden. Dieser Parameter und der Header Accept-Language schließen sich gegenseitig aus. Geben Sie daher nicht beide an. Eine Zeichenfolge der Benutzeroberfläche ist eine Zeichenfolge, die als Bezeichnung in einer Benutzeroberfläche verwendet wird. Die JSON-Antwortobjekte enthalten nur wenige Zeichenfolgen für Benutzeroberflächen. Die angegebene Sprache wird auch in Links zu Eigenschaften von „bing.com“ in den Antwortobjekten verwendet.

userId

String

Eine eindeutige ID, die den Benutzer identifiziert. Generieren Sie einen eindeutigen Wert für jeden Benutzer (der Wert ist unwichtig). Der Dienst verwendet die ID, um Probleme zu debuggen und die Qualität von Korrekturen zu verbessern.

mode

String

Der Typ der durchzuführenden Rechtschreib- und Grammatikprüfungen. Im Folgenden sind die möglichen Werte aufgeführt (bei den Werten wird die Groß-/Kleinschreibung nicht beachtet). Der Standardwert ist Proof. 1) Proof – Findet die meisten Rechtschreib- und Grammatikfehler. 2) Rechtschreibfehler– Findet die meisten Rechtschreibfehler, findet jedoch einige der Grammatikfehler, die Proof abfängt (z. B. Großschreibung und wiederholte Wörter). Mögliche Werte: "proof", "spell"

preContextText

String

Eine Zeichenfolge, die der Textzeichenfolge Kontext gibt. Beispielsweise ist das Textzeichenfolgenblatt gültig. Wenn Sie preContextText jedoch auf bike festlegen, ändert sich der Kontext, und die Textzeichenfolge wird ungültig. In diesem Fall schlägt die API vor, dass Sie Blütenblätter auf Pedal ändern (wie beim Fahrradpedal). Dieser Text wird nicht auf Grammatik- oder Rechtschreibfehler überprüft. Die kombinierte Länge der Textzeichenfolge, der preContextText-Zeichenfolge und der postContextText-Zeichenfolge darf 10.000 Zeichen nicht überschreiten. Sie können diesen Parameter in der Abfragezeichenfolge einer GET-Anforderung oder im Textkörper einer POST-Anforderung angeben.

postContextText

String

Eine Zeichenfolge, die der Textzeichenfolge Kontext gibt. Beispielsweise ist der Textzeichenfolgenlesevorgang gültig. Wenn Sie postContextText jedoch auf carpet festlegen, ändert sich der Kontext, und die Textzeichenfolge wird ungültig. In diesem Fall schlägt die API vor, dass Sie Lesezugriff in Rot ändern (wie beim roten Teppich). Dieser Text wird nicht auf Grammatik- oder Rechtschreibfehler überprüft. Die kombinierte Länge der Textzeichenfolge, der preContextText-Zeichenfolge und der postContextText-Zeichenfolge darf 10.000 Zeichen nicht überschreiten. Sie können diesen Parameter in der Abfragezeichenfolge einer GET-Anforderung oder im Textkörper einer POST-Anforderung angeben.

cancellationToken

CancellationToken

Das Abbruchtoken.