WebOperations Clase
Operaciones de WebOperations.
No debe crear instancias directamente de esta clase, sino crear una instancia de cliente que la creará automáticamente y la asociará como atributo.
- Herencia
-
builtins.objectWebOperations
Constructor
WebOperations(client, config, serializer, deserializer)Parámetros
- client
Cliente para solicitudes de servicio.
- config
Configuración del cliente de servicio.
- serializer
Serializador de modelo de objetos.
- deserializer
Deserializador de modelo de objetos.
Variables
- x_bing_apis_sdk
Active el cumplimiento de Swagger. Valor constante: "true".
Métodos
| search |
Web Search API le permite enviar una consulta de búsqueda a Bing y obtener resultados de búsqueda que incluyen vínculos a páginas web, imágenes, etc. |
search
Web Search API le permite enviar una consulta de búsqueda a Bing y obtener resultados de búsqueda que incluyen vínculos a páginas web, imágenes, etc.
search(query, accept_language=None, pragma=None, user_agent=None, client_id=None, client_ip=None, location=None, answer_count=None, country_code=None, count=None, freshness=None, market='en-us', offset=None, promote=None, response_filter=None, safe_search=None, set_lang=None, text_decorations=None, text_format=None, custom_headers=None, raw=False, **operation_config)Parámetros
- query
- str
Término de consulta de búsqueda del usuario. Es posible que el término no esté vacío. El término puede contener operadores avanzados de Bing. Por ejemplo, para limitar los resultados a un dominio específico, use el operador site: .
- accept_language
- str
Lista delimitada por comas de uno o varios idiomas que se van a usar para las cadenas de la interfaz de usuario. La lista se muestra en orden de preferencia decreciente. Para 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 devolver 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
- str
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).
- user_agent
- str
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 cualquier explorador usado habitualmente enviaría. Para obtener información acerca de los agentes de usuario, consulte RFC 2616.
- client_id
- str
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 adaptar los resultados web al historial de búsqueda del identificador de cliente, lo que proporciona una experiencia más completa 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.
- client_ip
- str
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
- str
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 :. 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): la 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): el encabezado relativo o la dirección del viaje del cliente. 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 es distinta de cero. sp (opcional): velocidad horizontal (velocidad), en metros por segundo, que el dispositivo cliente está viajando. alt (opcional): altitud del dispositivo cliente, en metros. are (opcional): el 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, debería incluir tanto este encabezado como X-MSEdge-ClientIP pero, como mínimo, debe incluir este.
- answer_count
- int
Número de respuestas que desea que incluya la respuesta. Las respuestas que devuelve Bing se basan en la clasificación. Por ejemplo, si Bing devuelve páginas web, imágenes, vídeos y relatedSearches para una solicitud y establece este parámetro en dos (2), la respuesta incluye páginas web e imágenes. Si incluyó el parámetro de consulta responseFilter en la misma solicitud y lo estableció en páginas web y noticias, la respuesta incluiría solo páginas web.
- country_code
- str
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 devolverán 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.
- count
- int
Número de resultados de búsqueda que se devolverán en la respuesta. El valor predeterminado es 10 y el valor máximo es 50. El número real entregado puede ser menor que el solicitado. Use este parámetro junto con el parámetro offset para los resultados de la página. Por ejemplo, si la interfaz de usuario muestra 10 resultados de búsqueda por página, establezca recuento en 10 y desplazamiento en 0 para obtener la primera página de resultados. Para cada página posterior, incremente el desplazamiento en 10 (por ejemplo, 0, 10, 20). Es posible que varias páginas incluyan alguna superposición en los resultados.
Filtrar los resultados de búsqueda por los siguientes valores de edad: Día: devuelve páginas web que Bing detectó en las últimas 24 horas. Semana: devuelve páginas web que Bing detectó en los últimos 7 días. Mes: devuelve páginas web detectadas en los últimos 30 días. Este filtro solo se aplica a los resultados de la página web y no a los demás resultados, como noticias e imágenes. Entre los valores posibles se incluyen: 'Day', 'Week', 'Month'
- market
- str
Mercado de dónde proceden los resultados. Normalmente, mkt es el país desde el que el usuario realiza la solicitud. Sin embargo, podría ser un país diferente si el usuario no se encuentra en un país donde Bing entrega resultados. El mercado debe tener el formato -. Por ejemplo, en-US. La cadena no distingue mayúsculas de minúsculas. Si se sabe, se recomienda especificar siempre el mercado. Especificar el mercado ayuda a Bing a enrutar la solicitud y devolver una respuesta adecuada y óptima. Si especifica un mercado que no aparece en Códigos de mercado, Bing usa un código de mercado adecuado basado en una asignación interna que está sujeta a cambios. Este parámetro y el parámetro de consulta cc son mutuamente excluyentes: no especifique los dos.
- offset
- int
Desplazamiento de base cero que indica el número de resultados de búsqueda que se omitirán antes de devolver los resultados. El valor predeterminado es 0. El desplazamiento debe ser menor que (totalEstimatedMatches - count). Use este parámetro junto con el parámetro count para los resultados de la página. Por ejemplo, si la interfaz de usuario muestra 10 resultados de búsqueda por página, establezca recuento en 10 y desplazamiento en 0 para obtener la primera página de resultados. Para cada página posterior, incremente el desplazamiento en 10 (por ejemplo, 0, 10, 20). es posible que varias páginas incluyan alguna superposición en los resultados.
- promote
- list[str o AnswerType]
Lista delimitada por comas de respuestas que desea que la respuesta incluya independientemente de su clasificación. Por ejemplo, si establece answerCount) en dos (2) para que Bing devuelva las dos respuestas clasificadas principales, pero también quiere que la respuesta incluya noticias, establecería promover a noticias. Si las respuestas clasificadas principales son páginas web, imágenes, vídeos y relatedSearches, la respuesta incluye páginas web e imágenes porque las noticias no son una respuesta clasificada. Pero si establece la promoción en vídeo, Bing promovería la respuesta de vídeo en la respuesta y devolvería páginas web, imágenes y vídeos. Las respuestas que desea promover no cuentan con el límite answerCount. Por ejemplo, si las respuestas clasificadas son noticias, imágenes y vídeos, y establece answerCount en 1 y promueve a noticias, la respuesta contiene noticias e imágenes. O bien, si los resultados clasificados son vídeos, imágenes y noticias, la respuesta contiene vídeos y noticias. Los valores posibles son Computation, Images, News, RelatedSearches, SpellSuggestions, TimeZone, Videos, Páginas web. Use solo si especifica answerCount.
- response_filter
- list[str o AnswerType]
Lista delimitada por comas de respuestas que se van a incluir en la respuesta. Si no especifica este parámetro, la respuesta incluye todas las respuestas de búsqueda para las que hay datos pertinentes. Los valores de filtro posibles son Computation, Images, News, RelatedSearches, SpellSuggestions, TimeZone, Videos, Páginas web. Aunque puede usar este filtro para obtener una única respuesta, en su lugar debe usar el punto de conexión específico de la respuesta para obtener resultados más completos. Por ejemplo, para recibir solo imágenes, envíe la solicitud a uno de los puntos de conexión de Image Search API. Las respuestas RelatedSearches y SpellSuggestions no admiten un punto de conexión independiente, como lo hace Image Search API (solo web Search API los devuelve). Para incluir respuestas que, de lo contrario, se excluirían debido a la clasificación, consulte el parámetro de promoción de la consulta.
- safe_search
- str o SafeSearch
Filtro que se usa para filtrar el contenido para adultos. Desactivado: devuelve páginas web con texto, imágenes o vídeos para adultos. Moderado: devuelve páginas web con texto para adultos, pero no imágenes o vídeos para adultos. Estricto: no devuelva páginas web con texto para adultos, imágenes o vídeos. El valor predeterminado es Moderado. Si la solicitud procede de un mercado que la directiva para adultos de Bing requiere que safeSearch esté establecido en Strict, Bing omite el valor safeSearch y usa Strict. Si usa el operador de consulta site: query, existe la posibilidad de que la respuesta contenga contenido para adultos, independientemente de cuál sea el parámetro de consulta safeSearch establecido en. Sitio de uso: solo si conoce el contenido en el sitio y su escenario admite la posibilidad de contenido para adultos. Entre los valores posibles se incluyen: "Off", "Moderate", "Strict"
- set_lang
- str
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 ambos. 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.
- text_decorations
- bool
Valor booleano que determina si las cadenas de presentación deben contener marcadores de decoración, como caracteres de resaltado de aciertos. Si es true, las cadenas pueden incluir marcadores. El valor predeterminado es false. Para especificar si se deben usar caracteres Unicode o etiquetas HTML como marcadores, consulte el parámetro de consulta textFormat.
- text_format
- str o TextFormat
Tipo de marcadores que se van a usar para las decoraciones de texto (vea el parámetro de consulta textDecorations). Los valores posibles son Raw: use caracteres Unicode para marcar el contenido que necesita formato especial. Los caracteres Unicode están en el intervalo E000 a E019. Por ejemplo, Bing usa E000 y E001 para marcar el principio y el final de los términos de consulta para el resaltado de aciertos. HTML: use etiquetas HTML para marcar el contenido que necesita formato especial. Por ejemplo, use etiquetas para resaltar los términos de consulta en cadenas para mostrar. El valor predeterminado es Raw. En el caso de las cadenas de presentación que contienen caracteres HTML ineludibles, como <, >y &, si textFormat está establecido en HTML, Bing escapa de los caracteres según corresponda (por ejemplo, < se escapa a <). Entre los valores posibles se incluyen: "Raw", "Html"
- raw
- bool
devuelve la respuesta directa junto con la respuesta deserializada.
- operation_config
Invalidaciones de configuración de la operación.
Devoluciones
SearchResponse o ClientRawResponse si raw=true
Tipo de valor devuelto
Excepciones
Atributos
models
models = <module 'azure.cognitiveservices.search.websearch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\search\\websearch\\models\\__init__.py'>
Azure SDK for Python