SpellCheckClient.SpellCheckerWithHttpMessagesAsync Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.CognitiveServices.Language.SpellCheck

Ensamblado:: Microsoft.Azure.CognitiveServices.Language.SpellCheck.dll

Paquete:: Microsoft.Azure.CognitiveServices.Language.SpellCheck v4.0.0

Paquete:: Microsoft.Azure.CognitiveServices.Language.SpellCheck v4.1.0-preview.1

Source:: SpellCheckClient.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Bing Spell Check API permite comprobar la gramática y la ortografía en contexto. Bing ha desarrollado corrector ortográfico basado en web que aprovecha el aprendizaje automático y la traducción automática estadística para entrenar dinámicamente a un algoritmo en constante evolución y altamente contextual. El corrector ortográfico se basa en un gran corpus de documentos y búsquedas web.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Language.SpellCheck.Models.SpellCheckModel>> SpellCheckerWithHttpMessagesAsync (string text, string acceptLanguage = default, string pragma = default, string userAgent = default, string clientId = default, string clientIp = default, string location = default, string actionType = default, string appName = default, string countryCode = default, string clientMachineName = default, string docId = default, string market = default, string sessionId = default, string setLang = default, string userId = default, string mode = default, string preContextText = default, string postContextText = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member SpellCheckerWithHttpMessagesAsync : string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Language.SpellCheck.Models.SpellCheckModel>>
override this.SpellCheckerWithHttpMessagesAsync : string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Language.SpellCheck.Models.SpellCheckModel>>

Public Function SpellCheckerWithHttpMessagesAsync (text As String, Optional acceptLanguage As String = Nothing, Optional pragma As String = Nothing, Optional userAgent As String = Nothing, Optional clientId As String = Nothing, Optional clientIp As String = Nothing, Optional location As String = Nothing, Optional actionType As String = Nothing, Optional appName As String = Nothing, Optional countryCode As String = Nothing, Optional clientMachineName As String = Nothing, Optional docId As String = Nothing, Optional market As String = Nothing, Optional sessionId As String = Nothing, Optional setLang As String = Nothing, Optional userId As String = Nothing, Optional mode As String = Nothing, Optional preContextText As String = Nothing, Optional postContextText As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of SpellCheckModel))

Parámetros

text: String

Cadena de texto que se va a comprobar si hay errores ortográficos y gramaticales. La longitud combinada de la cadena de texto, la cadena preContextText y la cadena postContextText pueden no superar los 10 000 caracteres. Puede especificar este parámetro en la cadena de consulta de una solicitud GET o en el cuerpo de una solicitud POST. Debido al límite de longitud de cadena de consulta, normalmente usará una solicitud POST a menos que solo compruebe cadenas cortas.

acceptLanguage: String

Lista delimitada por comas de uno o varios idiomas que se usarán para las cadenas de la interfaz de usuario. La lista se muestra en orden de preferencia decreciente. Para obtener más información, incluido el formato esperado, consulte RFC2616. Este encabezado y el parámetro de consulta setLang son mutuamente excluyentes; no especifique ambos. Si establece este encabezado, debe especificar también el parámetro de consulta cc. Bing usará el primer idioma admitido que encuentra en la lista y combinará ese idioma con el valor del parámetro cc para determinar el mercado para el que se devolverán los resultados. Si la lista no incluye un idioma admitido, Bing encontrará el idioma y el mercado más cercanos que admite la solicitud, y puede usar un mercado agregado o predeterminado para los resultados en lugar de uno especificado. Debe usar este encabezado y el parámetro de consulta cc solo si especifica varios idiomas; De lo contrario, debe usar los parámetros de consulta mkt y setLang. Una cadena de interfaz de usuario es aquella que se usa como etiqueta en una interfaz de usuario. Hay muy pocas cadenas de interfaz de usuario en los objetos de respuesta JSON. Los vínculos de los objetos de respuesta a Bing.com propiedades aplicarán el idioma especificado.

pragma: String

De forma predeterminada, Bing devuelve contenido almacenado en caché, si está disponible. Para que Bing no devuelva contenido almacenado en caché, establezca el encabezado Pragma en no-cache (por ejemplo, Pragma: no-cache).

userAgent: String

El agente de usuario que origina la solicitud. Bing usa el agente de usuario para proporcionar a los usuarios de dispositivos móviles una experiencia optimizada. Aunque es opcional, se recomienda encarecidamente especificar siempre este encabezado. El agente de usuario debe ser la misma cadena que enviaría cualquier explorador usado habitualmente. Para obtener información acerca de los agentes de usuario, consulte RFC 2616.

clientId: String

Bing usa este encabezado para proporcionar a los usuarios un comportamiento coherente en las llamadas API de Bing. Bing incorpora a menudo mejoras y características piloto nuevas, y usa el identificador de cliente como clave para asignar el tráfico en distintos paquetes piloto. Si no usa el mismo identificador de cliente para un usuario en varias solicitudes, Bing puede asignar el usuario a varios paquetes piloto en conflicto. La asignación a varios paquetes piloto en conflicto puede generar una experiencia de usuario incoherente. Por ejemplo, si la segunda solicitud tiene una asignación de paquete piloto distinta de la primera, puede que se produzca una experiencia inesperada. Además, Bing puede usar el identificador de cliente para personalizar los resultados web en el historial de búsqueda del identificador de cliente, lo que proporciona una experiencia enriquecida para el usuario. Bing también utiliza este encabezado para ayudar a mejorar las clasificaciones de resultados mediante el análisis de la actividad que genera un identificador de cliente. Las mejoras de relevancia ayudan con una mayor calidad de los resultados que devuelven las API de Bing y, a su vez, permiten un mayor porcentaje de clics para el consumidor de la API. IMPORTANTE: Aunque es opcional, considere este encabezado como obligatorio. Conservar el identificador de cliente en varias solicitudes para la misma combinación de usuario final y dispositivo permite 1) que el consumidor de API reciba una experiencia de usuario coherente y 2) un mayor porcentaje de clics a través de una mejor calidad de los resultados de las API de Bing. Cada usuario que utiliza la aplicación en el dispositivo debe tener un identificador de cliente único generado por Bing. Si no incluye este encabezado en la solicitud, Bing genera un identificador y lo devuelve en el encabezado de respuesta X-MSEdge-ClientID. La única ocasión en que NO debe incluir este encabezado en una solicitud es la primera vez que el usuario usa la aplicación en el dispositivo. Use el identificador de cliente para cada solicitud de API de Bing que haga la aplicación para este usuario en el dispositivo. Conserve el identificador de cliente. Para conservar el identificador en una aplicación de explorador, use una cookie HTTP persistente para asegurarse de que se use ese identificador en todas las sesiones. No use una cookie de sesión. Para otras aplicaciones, como aplicaciones móviles, use el almacenamiento persistente del dispositivo para conservar el identificador. La próxima vez que el usuario use la aplicación en ese dispositivo, obtenga el identificador de cliente que conservó. Las respuestas de Bing pueden incluir este encabezado o no incluirlo. Si la respuesta incluye este encabezado, capture el identificador de cliente y úselo para todas las solicitudes posteriores de Bing del usuario en dicho dispositivo. Si incluye X-MSEdge-ClientID, no debe incluir cookies en la solicitud.

clientIp: String

Dirección IPv4 o IPv6 del dispositivo cliente. La dirección IP se usa para detectar la ubicación del usuario. Bing usa la información de ubicación para determinar el comportamiento de la búsqueda segura. Aunque es opcional, se recomienda especificar siempre tanto este encabezado como el encabezado X-Search-Location. No ofusque la dirección (por ejemplo, cambiando el último octeto a 0). Al ofuscar los resultados de dirección, la ubicación no se encuentra cerca de la ubicación real, lo que puede provocar que Bing devuelva resultados erróneos.

location: String

Una lista delimitada por punto y coma de pares clave-valor que describen la ubicación geográfica del cliente. Bing usa la información de ubicación para determinar el comportamiento de la búsqueda segura y devolver contenido local apropiado. Especifique el par clave-valor como <clave>:<valor>. A continuación se incluyen las claves que usan para especificar la ubicación del usuario. lat (obligatorio): latitud de la ubicación del cliente, en grados. La latitud debe ser mayor o igual que -90.0, y menor o igual que +90.0. Los valores negativos indican latitudes del sur, mientras que los valores positivos indican latitudes del norte. long (obligatorio): longitud de la ubicación del cliente, en grados. La longitud debe ser mayor o igual que -180.0, y menor o igual que +180.0. Los valores negativos indican longitudes del oeste, mientras que los valores positivos indican longitudes del este. re (obligatorio): radio, en metros, que especifica la precisión horizontal de las coordenadas. Pase el valor que devuelve el servicio de ubicación del dispositivo. Los valores típicos pueden ser 22 m para GPS/Wi-Fi, 380 m para la triangulación de antenas repetidoras de telefonía móvil y 18 000 m para la búsqueda inversa de IP. ts (opcional): marca de tiempo DE UNIX UTC de cuando el cliente estaba en la ubicación. (La marca de tiempo de UNIX es el número de segundos desde el 1 de enero de 1970). head (opcional): encabezado relativo del cliente o dirección de viaje. Especifique la dirección de desplazamiento como grados de 0 a 360, en la dirección de las agujas del reloj con respecto al norte verdadero. Especifique esta clave solo si la clave sp no es cero. sp (opcional): velocidad horizontal (velocidad), en metros por segundo, que el dispositivo cliente está viajando. alt (opcional): la altitud del dispositivo cliente, en metros. are (opcional): radio, en metros, que especifica la precisión vertical de las coordenadas. Especifique esta clave solo si especifica la tecla alt. Aunque muchas de las claves son opcionales, cuanta más información proporcione, más precisos serán los resultados de ubicación. Aunque es opcional, se recomienda especificar siempre la ubicación geográfica del usuario. Proporcionar la ubicación es especialmente importante si la dirección IP del cliente no refleja con precisión la ubicación física del usuario (por ejemplo, si el cliente utiliza VPN). Para obtener resultados óptimos, debe incluir este encabezado y el encabezado X-Search-ClientIP, pero como mínimo, debe incluir este encabezado.

actionType: String

Cadena que usa el registro para determinar si la solicitud procede de una sesión interactiva o una carga de página. Los posibles valores son los siguientes. 1) Editar: la solicitud procede de una sesión interactiva 2) Cargar: la solicitud procede de una carga de página. Entre los valores posibles se incluyen: "Edit", "Load"

appName: String

Nombre único de la aplicación. Bing debe conocer el nombre. No incluya este parámetro a menos que se haya contactado previamente con Bing para obtener un nombre de aplicación único. Para obtener un nombre único, póngase en contacto con el administrador de desarrollo empresarial de Bing.

countryCode: String

Un código de país de 2 caracteres del país del que provienen los resultados. Esta API solo admite el mercado de Estados Unidos. Si especifica este parámetro de consulta, debe establecerse en nosotros. Si establece este parámetro, debe especificar también el encabezado Accept-Language. Bing usa el primer idioma admitido que encuentra en la lista de idiomas y combina ese idioma con el código de país que especifiques para determinar el mercado para el que se devuelven los resultados. Si la lista de idiomas no incluye un idioma admitido, Bing busca el idioma y el mercado más cercanos que admiten la solicitud, o bien puede usar un mercado agregado o predeterminado para los resultados en lugar de uno especificado. Debe usar este parámetro de consulta y el parámetro de consulta Accept-Language solo si especifica varios idiomas; De lo contrario, debe usar los parámetros de consulta mkt y setLang. Este parámetro y el parámetro de consulta mkt son mutuamente excluyentes: no especifique los dos.

clientMachineName: String

Nombre único del dispositivo desde el que se realiza la solicitud. Genere un valor único para cada dispositivo (el valor no es importante). El servicio usa el identificador para ayudar a depurar problemas y mejorar la calidad de las correcciones.

docId: String

Identificador único que identifica el documento al que pertenece el texto. Genere un valor único para cada documento (el valor no es importante). El servicio usa el identificador para ayudar a depurar problemas y mejorar la calidad de las correcciones.

market: String

Mercado de dónde proceden los resultados. Se recomienda encarecidamente especificar siempre el mercado, si se conoce. Especificar el mercado ayuda a Bing a enrutar la solicitud y devolver una respuesta adecuada y óptima. Este parámetro y el parámetro de consulta cc son mutuamente excluyentes: no especifique los dos.

sessionId: String

Identificador único que identifica esta sesión de usuario. Genere un valor único para cada sesión de usuario (el valor no es importante). El servicio usa el identificador para ayudar a depurar problemas y mejorar la calidad de las correcciones.

setLang: String

Idioma que se usará para las cadenas de la interfaz de usuario. Especifique el idioma con el código ISO 639-1 de 2 letras. Por ejemplo, el código de idioma de inglés es EN. El valor predeterminado es EN (inglés). Aunque sea opcional, siempre debe especificar el idioma. Normalmente, establece setLang en el mismo idioma especificado por mkt a menos que el usuario quiera que las cadenas de la interfaz de usuario se muestren en un idioma diferente. Este parámetro y el encabezado Accept-Language son mutuamente excluyentes: no especifique los dos. Una cadena de interfaz de usuario es aquella que se usa como etiqueta en una interfaz de usuario. Hay pocas cadenas de interfaz de usuario en los objetos de respuesta JSON. Además, los vínculos a las propiedades de Bing.com de los objetos de respuesta aplican el idioma especificado.

userId: String

Identificador único que identifica al usuario. Genere un valor único para cada usuario (el valor no es importante). El servicio usa el identificador para ayudar a depurar problemas y mejorar la calidad de las correcciones.

mode: String

Tipo de revisión ortográfica y gramatical que se va a realizar. A continuación se muestran los valores posibles (los valores no distinguen mayúsculas de minúsculas). El valor predeterminado es Proof. 1) Prueba: encuentra la mayoría de los errores ortográficos y gramaticales. 2) Ortografía: busca la mayoría de los errores ortográficos, pero no encuentra algunos de los errores gramaticales que proof detecta (por ejemplo, mayúsculas y palabras repetidas). Entre los valores posibles se incluyen: "proof", "spell"

preContextText: String

Cadena que proporciona contexto a la cadena de texto. Por ejemplo, el pétalo de cadena de texto es válido. Sin embargo, si establece preContextText en bike, el contexto cambia y la cadena de texto no es válida. En este caso, la API sugiere que cambia el pétalo al pedal (como en el pedal de bicicleta). Este texto no se comprueba si hay errores gramaticales o ortográficos. La longitud combinada de la cadena de texto, la cadena preContextText y la cadena postContextText no pueden superar los 10 000 caracteres. Puede especificar este parámetro en la cadena de consulta de una solicitud GET o en el cuerpo de una solicitud POST.

postContextText: String

Cadena que proporciona contexto a la cadena de texto. Por ejemplo, la cadena de texto leída es válida. Sin embargo, si establece postContextText en moqueta, el contexto cambia y la cadena de texto no es válida. En este caso, la API sugiere que cambia la lectura a rojo (como en alfombra roja). Este texto no se comprueba si hay errores gramaticales o ortográficos. La longitud combinada de la cadena de texto, la cadena preContextText y la cadena postContextText no pueden superar los 10 000 caracteres. Puede especificar este parámetro en la cadena de consulta de una solicitud GET o en el cuerpo de una solicitud POST.