Informations de référence sur l’API Recherche d’actualités v7
Avertissement
API Recherche Bing sont déplacés de Cognitive Services à Recherche Bing services. À partir du 30 octobre 2020 , toute nouvelle instance de recherche Bing doit être approvisionnée en suivant le processus documenté ici. Les API Recherche Bing approvisionnées à l’aide de Cognitive Services seront prises en charge pendant les trois prochaines années ou jusqu’à la fin de votre Accord Entreprise, selon la première situation. Pour obtenir des instructions de migration, consultez Services recherche Bing.
L’API Recherche d’actualités vous permet d’envoyer une requête de recherche à Bing et de récupérer une liste d’Articles de News pertinents. Cette section fournit des détails techniques sur les paramètres de requête et les en-têtes que vous utilisez pour demander des articles d’actualité et les objets de réponse JSON qui les contiennent. Pour obtenir des exemples qui montrent comment effectuer des demandes, consultez recherche d’actualités sur le Web.
Pour plus d’informations sur les en-têtes que les demandes doivent inclure, consultez en-têtes de demande.
Pour plus d’informations sur les paramètres de requête que les demandes doivent inclure, consultez paramètres de requête.
Pour plus d’informations sur les objets JSON que la réponse peut inclure, consultez objets réponse.
Pour plus d’informations sur l’utilisation autorisée et l’affichage des résultats, consultez Recherche Bing l’utilisation de l' API et exigences d’affichage.
Notes
Étant donné que les paramètres et formats d’URL sont susceptibles de changer sans préavis, utilisez toutes les URL telles quelles. Vous ne devez pas créer de dépendances par rapport au format d’URL ou aux paramètres sauf indication contraire.
Points de terminaison
Pour demander des Articles de News, envoyez une demande d’accès à l’une des URL suivantes :
URL | Description |
---|---|
https://api.cognitive.microsoft.com/bing/v7.0/news |
Retourne les premiers articles d’actualité par catégorie. Par exemple, vous pouvez demander les meilleurs articles sportifs ou Entertainment. Pour plus d’informations sur la spécification des catégories, consultez le paramètre de requête Category . |
https://api.cognitive.microsoft.com/bing/v7.0/news/search |
Retourne des articles d’actualité basés sur la requête de recherche de l’utilisateur. Si la requête de recherche est vide, l’appel renvoie les articles en lien avec des actualités. |
https://api.cognitive.microsoft.com/bing/v7.0/news/trendingtopics |
Retourne des rubriques d’actualité tendances qui sont en cours de tendance sur les réseaux sociaux. Remarque : Disponible uniquement sur les marchés en-US et zh-CN. |
Pour les abonnements à plusieurs services, vous devez inclure la région dans l’URL. Par exemple : westus.api.cognitive.microsoft.com. Consultez régions prises en charge.
La demande doit utiliser le protocole HTTPs ; HTTP n’est pas pris en charge.
Notes
La longueur maximale de l’URL est de 2 048 caractères. Pour que votre URL ne dépasse pas la limite, la longueur maximale de vos paramètres de requête doit être inférieure à 1 500 caractères. Si l’URL dépasse 2 048 caractères, le serveur retourne une erreur 404 (Introuvable).
headers
Voici les en-têtes possibles d’une demande et d’une réponse.
En-tête | Description |
---|---|
Acceptation | En-tête de demande facultatif. Le type de média par défaut est application/json. Pour spécifier que la réponse utilise JSON-LD, donnez la valeur application/ld+json à l’en-tête Accept. |
Accept-Language | En-tête de demande facultatif. Liste délimitée par des virgules des langues à utiliser pour les chaînes d’interface utilisateur. Elle est triée par ordre de préférence décroissant. Pour plus d’informations, notamment le format attendu, voir RFC2616. Cet en-tête et le paramètre de requête setLang s’excluent mutuellement — ne spécifiez pas les deux. Si vous définissez cet en-tête, vous devrez également spécifier le paramètre de requête cc. Pour déterminer pour quel marché les résultats devront être retournés, Bing utilise la première langue prise en charge qu’il trouve dans la liste et la combine avec la valeur du paramètre cc . Si la liste ne comporte pas de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la demande, ou utilise un marché agrégé ou par défaut pour les résultats. Pour identifier le marché utilisé par Bing, voir l’en-tête BingAPIs-Market.N’utilisez cet en-tête et le paramètre de requête cc que si vous spécifiez plusieurs langues. Sinon, utilisez les paramètres de requête mkt et setLang.Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. Les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée. |
BingAPIs-Market | En-tête de réponse. Marché utilisé par la demande. La forme est <languageCode>-<countryCode>. Par exemple, en-US. Si vous spécifiez un marché qui n’est pas listé dans les codes de marché, cette valeur peut différer du marché que vous avez spécifié dans le paramètre de requête MKT . Il en va de même si vous spécifiez des valeurs pour CC et Accept-Language qui ne peuvent pas être rapprochées. |
BingAPIs-TraceId | En-tête de réponse. ID de l’entrée du journal contenant les détails de la demande. Lorsqu’une erreur se produit, capturez cet ID. Si vous ne parvenez pas à identifier ou à résoudre le problème, précisez cet ID avec les autres informations envoyées à l’équipe de support. |
Ocp-Apim-Subscription-Key | En-tête de demande requis. Clé d’abonnement reçue lors de l’inscription à ce service dans Cognitive Services. |
Pragma | En-tête de demande facultatif. Par défaut, Bing retourne le contenu en cache, s’il est disponible. Pour empêcher le contenu mis en cache, affectez à l’en-tête pragma la valeur no-cache (par exemple, Pragma : no-cache). |
Retry-After | En-tête de réponse. La réponse comprend cet en-tête si vous dépassez le nombre de requêtes autorisées par seconde (RPS) ou par mois (RPM). L’en-tête contient le nombre de secondes que vous devez attendre avant d’envoyer une autre demande. |
User-Agent | En-tête de demande facultatif. Agent utilisateur à l’origine de la requête. Bing utilise l’agent utilisateur pour offrir une expérience optimisée aux utilisateurs mobiles. Nous vous conseillons de toujours indiquer cet en-tête, bien qu’il soit facultatif. L’agent utilisateur doit correspondre à la chaîne envoyée par n’importe quel navigateur couramment utilisé. Pour plus d’informations sur les agents utilisateurs, voir RFC 2616. Voici quelques exemples de chaînes de l’agent utilisateur.
|
X-MSEdge-ClientID | En-tête de demande et de réponse facultatif. Bing utilise cet en-tête pour garantir aux utilisateurs un comportement cohérent d’un appel d’API Bing à l’autre. Bing propose souvent de nouvelles fonctionnalités et améliorations, et se sert de l’ID client comme d’une clé pour attribuer le trafic aux différentes versions d’évaluation. Si vous n’assignez pas le même ID client à un utilisateur d’une demande à l’autre, Bing est susceptible d’affecter cet utilisateur à plusieurs versions d’évaluation en conflit, ce qui risque de nuire à l’expérience utilisateur. Par exemple, si la deuxième demande comporte une attribution de version d’évaluation différente de la première, l’expérience se révélera peut-être inattendue. En outre, Bing peut utiliser l’ID client pour adapter les résultats Web à l’historique de recherche de cet ID client, ce qui offre une expérience plus riche pour l’utilisateur. Bing utilise également cet en-tête pour aider à améliorer le classement des résultats en analysant l’activité générée par un ID client. L’amélioration de la pertinence permet d’obtenir des résultats de meilleure qualité de la part des API Bing et, en retour, des taux de clic plus élevés pour le consommateur des API. IMPORTANT : Il est vivement recommandé d’indiquer cet en-tête, bien qu’il soit facultatif. Grâce à la persistance de l’ID client dans plusieurs demandes pour une même combinaison appareil/utilisateur final, (1) le consommateur des API bénéficie d’une expérience utilisateur cohérente et (2) le taux de clic est plus élevé du fait des résultats de meilleure qualité provenant des API Bing. Voici les règles d’utilisation de base qui s’appliquent à cet en-tête.
REMARQUE : Les réponses de Bing ne comportent pas forcément cet en-tête. Si elles l’incluent, capturez l’ID client et utilisez-le pour toutes les demandes Bing suivantes concernant l’utilisateur sur cet appareil. REMARQUE : Si vous insérez l’en-tête X-MSEdge-ClientID, n’incluez pas les cookies dans la requête. |
X-MSEdge-ClientIP | En-tête de demande facultatif. Adresse IPv4 ou IPv6 de l’appareil client. L’adresse IP est utilisée pour découvrir l’emplacement de l’utilisateur. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié. REMARQUE : Nous vous conseillons de toujours indiquer cet en-tête et l’en-tête X-Search-Location, bien qu’ils soient facultatifs. N’obfusquez pas l’adresse (par exemple, en remplaçant le dernier octet par 0). Cela aurait pour effet d’éloigner la localisation de l’emplacement réel de l’appareil, ce qui pourrait conduire Bing à retourner des résultats erronés. |
X-Search-Location | En-tête de demande facultatif. Liste délimitée par des points-virgules de paires clé/valeur qui décrivent la situation géographique du client. Bing utilise les informations de localisation pour déterminer le comportement de recherche approprié et retourner le contenu local pertinent. Spécifiez la paire clé/valeur sous la forme <key>:<value>. Voici les clés permettant de spécifier l’emplacement de l’utilisateur.
REMARQUE : Bien que la plupart des clés soient facultatives, plus vous fournissez d’informations, plus les résultats de localisation sont précis. REMARQUE : Nous vous conseillons de toujours indiquer la situation géographique de l’utilisateur (qui est facultative). C’est particulièrement important si l’adresse IP du client ne reflète pas exactement l’emplacement physique de l’utilisateur (par exemple, si le client utilise un VPN). Pour obtenir des résultats optimaux, vous devez inclure cet en-tête et l’en-tête X-Search-ipclient, mais au minimum, vous devez inclure cet en-tête. |
Notes
N’oubliez pas que les conditions d’utilisation imposent le respect de toutes les lois en vigueur, y compris en ce qui concerne l’utilisation de ces en-têtes. Par exemple, dans certaines juridictions, comme en Europe, il faut obtenir le consentement de l’utilisateur pour pouvoir placer certains dispositifs de suivi sur les appareils des utilisateurs.
Paramètres de requête
Voici les paramètres de requête que la demande peut inclure. La colonne Obligatoire indique si vous devez absolument spécifier le paramètre. Vous devez encoder les valeurs des paramètres de requête dans une URL.
Name | Valeur | Type | Obligatoire |
---|---|---|---|
cc | Code à 2 caractères du pays d'où proviennent les résultats. Pour obtenir la liste des valeurs possibles, consultez la rubrique codes de marché. Si vous définissez ce paramètre, vous devez également spécifier l’en-tête Accept-Language. Bing utilise la première langue prise en charge trouvée dans les langues spécifiées et l’associe à l’indicatif du pays pour déterminer le marché pour lequel retourner les résultats. Si la liste des langues n’inclut de langue prise en charge, Bing recherche la langue et le marché les plus proches qui prennent en charge la requête. Ou, Bing peut utiliser un marché agrégé ou par défaut pour les résultats. Utilisez ce paramètre de requête et l' Accept-Language en-tête uniquement si vous spécifiez plusieurs langues. Dans le cas contraire, vous devez utiliser les mkt setLang paramètres de requête et.Ce paramètre et le paramètre de requête mkt s’excluent mutuellement — ne spécifiez pas les deux. |
String | Non |
catégorie | Catégorie d’articles à retourner. Par exemple, articles sportifs ou Articles de divertissement. Pour obtenir la liste des catégories possibles, consultez catégories d’actualités par marché. Utilisez ce paramètre uniquement avec les demandes de catégorie Actualités (voir le point de terminaison/News). Si vous ne spécifiez pas ce paramètre, la réponse comprend les deux éléments suivants :
Si vous ne spécifiez pas headlineCount et que le marché prend en charge huit catégories, la réponse comprend jusqu’à 44 Articles et clusters (12 Articles et clusters de 12 titres, plus les clusters et articles spécifiques à la catégorie 32). Comme un cluster contient plus d’un article, le nombre d’articles dans cet exemple, 44, peut être plus. Par exemple, la réponse peut inclure 11 Articles en gros et un cluster, qui contient quatre articles associés pour un total de 15 Articles en gros. |
String | Non |
count | Nombre d’Articles de News à retourner dans la réponse. Le nombre réel renvoyé peut être inférieur à ce que vous avez demandé. La valeur par défaut est 10 et la valeur maximale est 100. Pour les rubriques tendance, la valeur par défaut est toutes les actualités tendances (environ 55 Articles). Vous pouvez utiliser ce paramètre avec le offset paramètre pour paginer les résultats. Par exemple, si votre interface utilisateur affiche 20 Articles par page, définissez count sur 20 et offset sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrément de offset 20 (par exemple, 0, 20, 40). Il est possible que plusieurs pages incluent un chevauchement des résultats.Remarque : Les clusters sont comptés comme un seul élément. Par exemple, si vous définissez le nombre sur 10, la réponse peut inclure 9 Articles et 1 cluster, mais le cluster peut contenir 5 Articles. Remarque : Si vous demandez des catégories d’actualités, spécifiez ce paramètre uniquement si vous spécifiez le paramètre Category. Si vous ne spécifiez pas le paramètre Category, Bing ignore ce paramètre. |
UnsignedShort | No |
actualisation | Filtrer les Articles de News en suivant les valeurs d’âge suivantes :
|
String | Non |
headlineCount | Nombre d’articles et de clusters en gros à retourner. La valeur par défaut est 12. Spécifiez ce paramètre uniquement si vous ne spécifiez pas le paramètre Category. Si vous spécifiez le paramètre Category, Bing ignore ce paramètre. Utilisez ce paramètre uniquement avec les demandes de catégorie Actualités. |
UnsignedShort | Non |
mkt | Marché d’où proviennent les résultats. En général, mkt est le pays où l’utilisateur effectue la demande. Toutefois, il peut s’agir d’un pays différent si l’utilisateur ne se trouve pas dans un pays où Bing fournit des résultats. Le marché doit se présenter sous la forme <language code> - <country code> . Par exemple, en-US. La chaîne ne respecte pas la casse. Pour obtenir la liste des valeurs de marché possibles, consultez la rubrique codes de marché.Remarque : S’il est connu, il est recommandé de toujours spécifier le marché. Le fait d’indiquer le marché aide Bing à router la requête et à renvoyer une réponse appropriée et optimale. Si vous spécifiez un marché qui n’est pas listé dans les codes de marché, Bing utilise le code de marché le mieux adapté en fonction d’un mappage interne susceptible d’être modifié. Ce paramètre et le paramètre de requête cc s’excluent mutuellement — ne spécifiez pas les deux. |
String | Non |
offset | Décalage de base zéro qui indique le nombre d’Articles de News à ignorer avant de retourner des articles. La valeur par défaut est 0. Le décalage doit être inférieur à (totalEstimatedMatches - count ).Utilisez ce paramètre avec le count paramètre pour paginer les résultats. Par exemple, si votre interface utilisateur affiche 20 Articles par page, définissez count sur 20 et offset sur 0 pour obtenir la première page de résultats. Pour chaque page suivante, incrément de offset 20 (par exemple, 0, 20, 40). Il est possible que plusieurs pages incluent un chevauchement des résultats.Remarque : Les clusters sont comptés comme un seul élément. Par exemple, si vous définissez le nombre sur 10, la réponse peut inclure 9 Articles et 1 cluster, mais le cluster peut contenir 5 Articles. Remarque : Si vous demandez des catégories de News, spécifiez ce paramètre uniquement si vous spécifiez le paramètre Category. Si vous ne spécifiez pas le paramètre Category, Bing ignore ce paramètre. |
Court non signé | No |
originalImg | Valeur booléenne qui détermine si le de l’image contentUrl contient une URL qui pointe vers une miniature de l’image de l’article d’origine ou de l’image elle-même.Si l’article inclut une image et que ce paramètre a la valeur true , la propriété de l’image contentUrl contient une URL que vous pouvez utiliser pour télécharger l’image d’origine à partir du site Web de l’éditeur. Sinon, si ce paramètre a la valeur false , les URL et de l’image contentUrl thumbnailUrl pointent toutes les deux vers la même image miniature.La valeur par défaut est false. Utilisez ce paramètre uniquement avec l’API Recherche d’actualités. Ne spécifiez pas ce paramètre lors de l’appel de l’API Recherche Web. Les rubriques tendance ignorent ce paramètre. |
Boolean | Non |
q | Terme de requête de recherche de l’utilisateur. Si le terme est vide (par exemple, q =), la réponse comprend les premiers articles d’actualité. Le terme chaîne peut contenir des opérateurs avancés Bing. Par exemple, pour limiter les nouvelles à un domaine spécifique, utilisez l’opérateur site : . Si vous obtenez des Articles de News par catégorie, n’incluez pas ce paramètre. Les rubriques tendance ignorent ce paramètre. |
String | Oui |
safeSearch | Filtrez les Articles de News pour le contenu pour adultes. Les valeurs de filtre possibles sont les suivantes.
La valeur par défaut est Modéré. REMARQUE : Si la demande provient d’un marché où la stratégie de Bing en matière de contenu pour adultes exige que safeSearch ait la valeur Strict, Bing ignore la valeur safeSearch et utilise Strict. |
String | Non |
setLang | Langue à utiliser pour les chaînes de l’interface utilisateur. Vous pouvez spécifier la langue à l’aide d’un code à 2 ou 4 lettres. Il est préférable d’utiliser des codes à 4 lettres. Pour obtenir la liste des codes de langue pris en charge, consultez langues prises en charge par Bing. Bing charge les chaînes localisées si setlang contient un code de culture neutre à 2 lettres valide ( fr ) ou un code de culture spécifique à 4 lettres valide ( fr-ca ). Par exemple, pour fr-ca , Bing charge les chaînes de code de culture neutres fr .Si setlang n’est pas valide (par exemple, zh ) ou que Bing ne prend pas en charge la langue (par exemple, AF , AF-na ) en , Bing prend par défaut la valeur en (anglais).Pour spécifier le code à deux lettres, définissez ce paramètre sur un code de langue ISO 639-1. Pour spécifier le code à 4 lettres, utilisez le <pays/région> où est un code ISO 639-1 langue (culture neutre) et <pays/région> est un code ISO 3166 pays/région (culture spécifique). Par exemple, utilisez en-US pour États-Unis anglais. Nous vous conseillons de toujours indiquer la langue, bien qu’elle soit facultative. En général, on définit setLang sur la langue spécifiée par mkt , sauf si l’utilisateur souhaite que les chaînes de l’interface utilisateur soient affichées dans une autre langue.Ce paramètre et l’en-tête Accept-Language s’excluent mutuellement : ne spécifiez pas les deux. Une chaîne d’interface utilisateur est une chaîne utilisée comme étiquette dans une interface utilisateur. Les objets de réponse JSON en comportent quelques-unes. En outre, les liens vers les propriétés Bing.com dans les objets de la réponse s’appliquent à la langue spécifiée. |
String | Non |
since | L’heure d’époque UNIX (horodatage UNIX) que Bing utilise pour sélectionner les rubriques tendance. Bing retourne les sujets de tendance qu’il a découverts à la date et à l’heure spécifiées, et non la date à laquelle la rubrique a été publiée. Pour utiliser ce paramètre, spécifiez également le sortBy paramètre. |
Integer | Non |
sortBy | Ordre dans lequel les rubriques de tendance doivent être retournées. Voici les valeurs possibles. Elles ne sont pas sensibles à la casse.
Si vous ne spécifiez pas ce paramètre, il n’existe aucun classement spécifique. Toutefois, les fonctionnalités d’actualisation, de catégorie, d’engagement utilisateur global et de personnalisation des rubriques sont prises en compte. |
String | Non |
textDecorations | Valeur booléenne qui détermine si les chaînes d’affichage doivent contenir des marqueurs de décoration, tels que des caractères de mise en surbrillance d’atteinte. Si la valeur est true , les chaînes peuvent inclure des marqueurs. La valeur par défaut est false . Pour spécifier s’il faut utiliser des caractères Unicode ou des balises HTML comme marqueurs, consultez le paramètre de requête FormatTexte . Pour plus d’informations sur la mise en surbrillance des correspondances, consultez mise en surbrillance. |
Boolean | Non |
textFormat | Type des marqueurs à utiliser pour les décorations de texte (consultez le textDecorations paramètre de requête).Les valeurs possibles sont les suivantes.
La valeur par défaut est RAW. Pour obtenir la liste des marqueurs, consultez mise en surbrillance des correspondances. Pour les chaînes d’affichage qui contiennent des caractères HTML pouvant être échappés, tels que <, > et &, si textFormat a la valeur html, Bing échappe les caractères selon le cas (par exemple, < est placé dans une séquence d’échappement vers & lt ;).Pour plus d’informations sur le traitement des chaînes avec des caractères Unicode incorporés, consultez mise en surbrillance des correspondances. |
String | Non |
Objets réponse
Notes
Pour se conformer à la nouvelle directive européenne sur les droits d’auteur en France, les API Bing Web, News, Video, image et toutes les API de recherche personnalisées doivent omettre du contenu de certaines sources d’actualité de l’Union européenne pour les utilisateurs français. Le contenu supprimé peut inclure des images miniatures et des vidéos, des aperçus vidéo et des extraits de code qui accompagnent les résultats de recherche de ces sources. Par conséquent, les API Bing peuvent servir moins de résultats avec des images miniatures et des vidéos, des aperçus vidéo et des extraits de code pour les utilisateurs français.
Voici les objets JSON que la réponse peut inclure. Si la demande est réussie, l’objet de niveau supérieur dans la réponse est l’objet d' actualité si le point de terminaison est/News/Search ou/News, et TrendingTopicAnswer si le point de terminaison est/News/trendingtopics. Si la demande échoue, l’objet de niveau supérieur est l’objet ErrorResponse.
Object | Description |
---|---|
Error | Définit une erreur qui s’est produite. |
ErrorResponse | Définit l’objet de niveau supérieur que la réponse contient lorsque la requête échoue. |
Image | Définit une miniature d’une image relative aux actualités. |
MediaSize | Définit la taille du contenu multimédia. |
Actualités | Définit l’objet de niveau supérieur que la réponse contient lorsque la demande d’informations est réussie. |
NewsArticle | Définit un article d’actualité. |
Organisation | Définit le fournisseur qui a exécuté l’article. |
Requête | Définit la chaîne de requête de recherche. |
RelatedTopic | Définit une liste d’Articles de News associés à la requête de recherche. |
Vidéo miniature | Définit un lien vers l’image associée. |
Rubrique | Définit une rubrique de nouvelles tendances. |
TrendingTopics | Définit l’objet de niveau supérieur que la réponse contient lorsque la demande de rubriques de tendance est réussie. |
Vidéo Définit une vidéo qui est associée à l’article d’actualité. |
Error
Définit l’erreur qui s’est produite.
Élément | Description | Type |
---|---|---|
code | Code d’erreur identifiant la catégorie de l’erreur. Pour connaître la liste des codes possibles, voir Codes d’erreur. | String |
message | Description de l’erreur. | String |
moreDetails | Description de l’erreur comportant des informations supplémentaires. | String |
parameter | Paramètre de requête de la demande ayant provoqué l’erreur. | String |
subCode | Code identifiant l’erreur. Par exemple, si code est InvalidRequest, subCode peut être ParameterInvalid ou ParameterInvalidValue. |
String |
value | Valeur du paramètre de requête qui n’était pas valide. | String |
ErrorResponse
Objet de niveau supérieur figurant dans la réponse en cas d’échec de la demande.
Nom | Valeur | Type |
---|---|---|
_type | Indicateur de type. | String |
errors | Liste des erreurs qui décrivent les raisons pour lesquelles la demande a échoué. | Error[] |
Image
Définit une miniature d’une image relative aux actualités.
Nom | Valeur | Type |
---|---|---|
provider | Liste de propriétaires de l’image. | Organisation |
thumbnail | Lien vers une miniature de l’image. | Vidéo miniature |
url | URL de l’image. | String |
MediaSize
Définit la taille du contenu multimédia.
Nom | Valeur | Type |
---|---|---|
Taille | Hauteur du contenu multimédia, en pixels. | Integer |
width | Largeur du contenu multimédia, en pixels. | Integer |
Actualités
Définit l’objet de niveau supérieur que la réponse contient lorsque la demande d’informations est réussie.
Si le service suspecte une attaque par déni de service, la requête réussit (le code d’état HTTP est 200 OK), mais le corps de la réponse est vide.
Nom | Valeur | Type |
---|---|---|
_type | Indicateur de type. | String |
id | ID qui identifie de façon unique la réponse aux actualités. Pour plus d’informations sur l’utilisation de ce champ, consultez utilisation de classement pour afficher les résultats dans le Guide de l’API recherche Web. |
String |
readLink | URL qui retourne cette réponse. Pour utiliser l’URL, ajoutez les paramètres de requête appropriés et incluez l’en-tête OCP-APIM-subscription-Key . L’API Recherche Web comprend ce champ. En règle générale, vous utilisez l’URL si vous souhaitez interroger directement l’API Recherche d’actualités. |
String |
relatedTopics | Liste des Articles relatifs au terme recherché. | RelatedTopic[] |
Tris | Liste des options de tri des articles d’actualité. Par exemple, triez par pertinence (par défaut) ou par date. Pour déterminer l’ordre de tri utilisé par la requête, consultez le isSelected champ. |
SortValue[] |
totalEstimatedMatches | Nombre estimé d’articles d’actualité relatifs à la requête. Utilisez ce nombre avec les paramètres de requête Count et offset pour paginer les résultats. Seule l’API Recherche d’actualités comprend ce champ (l’API Recherche Web ne le fait pas). |
Long |
value | Liste des articles d’actualité relatifs au terme de requête. S’il n’y a aucun résultat à retourner pour la demande, le tableau est vide. |
NewsArticle[] |
NewsArticle
Définit un article d’actualité.
Nom | Valeur | Type |
---|---|---|
catégorie | Catégorie d’actualités à laquelle l’article appartient. Par exemple, sports. Si la catégorie Actualités ne peut pas être déterminée, l’article ne contient pas ce champ. Pour obtenir la liste des catégories possibles, consultez catégories d’actualités par marché. Si votre demande spécifie la catégorie Sports-Tennis, la category propriété peut contenir Sports-Tennis ou sports. |
String |
clusteredArticles | Liste d’articles connexes. | NewsArticle[] |
contractualRules | Liste des règles que vous devez respecter si vous affichez l’article. Par exemple, les règles peuvent déterminer si vous devez fournir une attribution. Les règles contractuelles suivantes peuvent s’appliquer. Si l’article fournit des règles contractuelles, vous devez les respecter. Remarque : Seuls les articles retournés par l' API recherche Web contiennent des règles contractuelles. Les articles retournés par les points de terminaison de News n’incluent pas les règles contractuelles. |
Object[] |
datePublished | Date et heure de détection de l’article par Bing. La date est au format AAAA-MM-JJThh : MM : SS. | String |
description | Brève description de l’article d’actualité. | String |
titre | Valeur booléenne qui indique si l’article d’actualité est un titre. Si la valeur est true , l’article est un titre. Remarque : L’article comprend ce champ uniquement pour les demandes de catégories d’actualités qui ne spécifient pas le paramètre de requête Category . |
Boolean |
id | ID qui identifie de façon unique cet article dans la liste des articles. Pour plus d’informations sur l’utilisation de ce champ, consultez utilisation de classement pour afficher les résultats dans le Guide de l’API recherche Web. |
String |
image | Image associée au nouvel article. L' Image objet dans ce contexte contient uniquement le thumbnail champ. |
Image |
Mentions | Liste des entités (lieux ou personnes) mentionnées dans l’article. | Élément[] |
name | Nom de l’article. Utilisez ce nom avec l’URL pour créer un lien hypertexte qui, lorsque vous cliquez dessus, amène l’utilisateur à l’article d’actualité. |
String |
moteur | Liste des fournisseurs qui ont exécuté l’article. | Organisation[] |
URL | URL de l’article d’actualité. Utilisez cette URL avec name pour créer un lien hypertexte qui, lorsque vous cliquez dessus, amène l’utilisateur à l’article d’actualité. |
String |
vidéosurveillance | Vidéo associée à l’article d’actualité. | Vidéo |
Organisation
Définit le fournisseur qui a exécuté l’article.
Nom | Valeur | Type |
---|---|---|
_type | Indicateur de type. | String |
name | Nom du fournisseur qui a exécuté l’article. | String |
Requête
Définit la chaîne de requête de recherche.
Nom | Valeur | Type |
---|---|---|
texte | Chaîne de requête qui retourne la rubrique tendance. | String |
RelatedTopic
Définit une liste d’Articles de News associés à la requête de recherche.
Nom | Valeur | Type |
---|---|---|
relatedNews | Liste d’articles connexes. | NewsArticle |
name | Terme de requête associé qui a retourné les Articles de News associés. | String |
webSearchUrl | URL qui dirige l’utilisateur vers les résultats de recherche Bing pour la requête associée. | String |
SortValue
Définit un ordre de tri à utiliser pour la requête.
Nom | Valeur | Type |
---|---|---|
id | Identificateur qui identifie l’ordre de tri des articles. Les valeurs possibles sont les suivantes.
|
String |
isSelected | Valeur booléenne qui détermine si la réponse utilise cet ordre de tri. Si la valeur est true , la réponse utilise cet ordre de tri. | Boolean |
name | Nom complet de l’ordre de tri. | String |
url | URL que vous pouvez utiliser pour effectuer la même demande à l’aide de cet ordre de tri. | String |
TextAttribution
Définit une règle contractuelle pour l’attribution du texte brut.
Thing
Définit une entité que l’article mentionne.
Nom | Valeur | Type |
---|---|---|
name | Nom de l’entité à laquelle l’article fait mention. | String |
Thumbnail
Définit un lien vers l’image associée.
Nom | Valeur | Type |
---|---|---|
contentUrl | URL de l’image. | String |
celle | Hauteur de l’image, en pixels. | Court non signé |
Largeur | Largeur de l’image, en pixels. | Court non signé |
Rubrique
Définit une rubrique de nouvelles tendances.
Nom | Valeur | Type |
---|---|---|
image | Lien vers une image associée. L' Image objet dans ce contexte contient uniquement le url provider champ et. Le provider champ est un tableau d’objets d' organisation qui identifient les fournisseurs d’images. |
Image |
isBreakingNews | Valeur booléenne qui indique si la rubrique est considérée comme des dernières nouvelles. Si la rubrique est considérée comme des dernières nouvelles, la valeur est true . | Boolean |
name | Titre de la rubrique tendance. | String |
newsSearchUrl | URL des résultats de recherche Bing News pour le terme de requête de recherche (voir le query champ). |
String |
query | Terme de requête de recherche qui retourne cette rubrique de tendance. | Requête |
webSearchUrl | URL des résultats de recherche Bing pour le terme de requête de recherche (voir le query champ). |
String |
TrendingTopics
Définit l’objet de niveau supérieur que la réponse contient lorsque la demande de rubriques de tendance est réussie.
Nom | Valeur | Type |
---|---|---|
value | Liste des rubriques d’actualité relatives aux tendances sur Bing. S’il n’y a aucun résultat à retourner pour la demande, le tableau est vide. |
Rubrique[] |
Vidéo
Définit une vidéo qui est associée à l’article d’actualité.
Notes
Étant donné que le format et les paramètres de l’URL sont susceptibles d’être modifiés sans préavis, utilisez toutes les URL telles quelles. Vous ne devez pas prendre de dépendances sur le format ou les paramètres de l’URL.
Nom | Valeur | Type |
---|---|---|
allowHttpsEmbed | Valeur booléenne qui détermine si vous pouvez incorporer la vidéo (voir le embedHtml champ) sur les pages qui utilisent le protocole HTTPS. |
Boolean |
embedHtml | Iframe qui vous permet d’incorporer et d’exécuter la vidéo dans votre page Web. | String |
motionThumbnailUrl | URL vers une miniature animée qui affiche un aperçu de la vidéo. En règle générale, vous utilisez cette URL pour lire un aperçu de la vidéo lorsque la souris de l’utilisateur se trouve sur la miniature de la vidéo sur la page des résultats. | String |
name | Nom de la vidéo. | String |
fer | Largeur et hauteur de l’image miniature ou de la miniature de mouvement. | MediaSize |
thumbnailUrl | URL d’une image miniature de la vidéo. Pour plus d’informations sur le redimensionnement de l’image, consultez redimensionner et rogner des images miniatures. | String |
Catégories d’actualités par marché
Vous trouverez ci-dessous les catégories de News possibles pour lesquelles vous pouvez définir le paramètre de requête Category . Vous pouvez définir category
une catégorie parente telle que Entertainment ou l’une de ses sous-catégories, par exemple Entertainment_MovieAndTV. Si vous définissez category
sur une catégorie parente, elle contient des articles d’une ou plusieurs de ses sous-catégories. Si vous définissez category
sur une sous-catégorie, il n’y a que des articles provenant de la sous-catégorie.
Marché | Catégories prises en charge |
---|---|
Australie (en-au) |
|
Canada (en-Californie) |
|
Chine (zh-CN) |
|
Inde (en-IN) |
|
Japon (ja-JP) |
|
Royaume-Uni (en-GB) |
|
États-Unis (en-US) |
|
Codes d’erreur
Voici les codes d’état HTTP qu’une demande peut retourner.
Code d’état | Description |
---|---|
200 | Réussite. |
400 | L’un des paramètres de requête est manquant ou non valide. |
401 | La clé d’abonnement est manquante ou non valide. |
403 | L’utilisateur est authentifié (par exemple, il a utilisé une clé d’abonnement valide), mais il n’est pas autorisé à accéder à la ressource demandée. Bing peut également retourner cet état si l’appelant a dépassé son quota mensuel de requêtes. |
410 | La demande a utilisé le protocole HTTP au lieu du protocole HTTPS. HTTPS est le seul protocole pris en charge. |
429 | L’appelant a dépassé son quota de requêtes par seconde. |
500 | Événement serveur inattendu. |
Si la demande échoue, la réponse comporte un objet ErrorResponse qui contient une liste d’objets Error décrivant l’origine de l’erreur. Si l’erreur est liée à un paramètre, le champ parameter
identifie celui qui pose problème. De même, si l’erreur est liée à une valeur de paramètre, le champ value
identifie la valeur non valide.
{
"_type": "ErrorResponse",
"errors": [
{
"code": "InvalidRequest",
"subCode": "ParameterMissing",
"message": "Required parameter is missing.",
"parameter": "q"
}
]
}
{
"_type": "ErrorResponse",
"errors": [
{
"code": "InvalidAuthorization",
"subCode": "AuthorizationMissing",
"message": "Authorization is required.",
"moreDetails": "Subscription key is not recognized."
}
]
}
Voici les valeurs possibles de code d’erreur et de sous-code d’erreur.
Code | SubCode | Description |
---|---|---|
ServerError | UnexpectedError ResourceError NotImplemented |
Le code d’état HTTP est 500. |
InvalidRequest | ParameterMissing ParameterInvalidValue HttpNotAllowed Bloqué |
Bing retourne InvalidRequest à chaque fois que la demande comporte une partie non valide. Par exemple, un paramètre obligatoire est manquant ou une valeur de paramètre n’est pas valide. Si l’erreur est ParameterMissing ou ParameterInvalidValue, le code d’état HTTP est 400. Si vous utilisez le protocole HTTP au lieu du protocole HTTPS, Bing retourne HttpNotAllowed, et le code d’état HTTP est 410. |
RateLimitExceeded | Aucun sous-code | Bing retourne RateLimitExceeded chaque fois que vous dépassez votre quota de requêtes par seconde (QPS) ou par mois (QPM). Si vous dépassez votre QPS, Bing retourne le code d’état HTTP 429 ; si vous dépassez votre QPM, Bing retourne le code d’état 403. |
InvalidAuthorization | AuthorizationMissing AuthorizationRedundancy |
Bing retourne InvalidAuthorization s’il ne parvient pas à identifier l’appelant. Par exemple, l’en-tête Ocp-Apim-Subscription-Key est manquant ou la clé d’abonnement n’est pas valide.Il y a redondance si plusieurs méthodes d’authentification sont spécifiées. Si l’erreur est InvalidAuthorization, le code d’état HTTP est 401. |
InsufficientAuthorization | AuthorizationDisabled AuthorizationExpired |
Bing retourne InsufficientAuthorization lorsque l’appelant n’est pas autorisé à accéder à la ressource. Cela peut se produire si la clé d’abonnement a été désactivée ou a expiré. Si l’erreur est InsufficientAuthorization, le code d’état HTTP est 403. |
Codes de marché
Le /news/search
tableau suivant endpointhe répertorie les valeurs de code de marché que vous pouvez utiliser pour spécifier le mkt
paramètre de requête. Bing retourne uniquement le contenu pour ces marchés. La liste est susceptible d’être modifiée.
Pour obtenir la liste des codes pays que vous pouvez spécifier dans le paramètre de requête cc
, consultez Codes pays.
Pays/Région | Langage | Code du marché |
---|---|---|
Danemark | Danois | da-DK |
Autriche | Allemand | de-AT |
Belgique | Néerlandais | nl-BE |
Suisse | Allemand | de-CH |
Allemagne | Allemand | de-DE |
Australie | Anglais | en-AU |
Canada | Anglais | en-CA |
Royaume-Uni | Anglais | en-GB |
Indonésie | Anglais | en-ID |
Irlande | Anglais | en-IE |
Inde | Anglais | en-IN |
Malaisie | Anglais | en-MY |
Nouvelle-Zélande | Anglais | en-NZ |
République des Philippines | Anglais | en-PH |
Singapour | Anglais | en-SG |
États-Unis | Anglais | fr-FR |
Anglais | général | en-WW |
Anglais | général | en-XA |
Afrique du Sud | Anglais | en-ZA |
Argentine | Espagnol | es-AR |
Chili | Espagnol | es-CL |
Espagne | Espagnol | es-ES |
Mexique | Espagnol | es-MX |
États-Unis | Espagnol | es-US |
Espagnol | général | es-XL |
Finlande | Finnois | fi-FI |
France | Français | fr-BE |
Canada | Français | fr-CA |
Suisse | Français | fr-CH |
France | Français | fr-FR |
Italie | Italien | it-IT |
Hong Kong (R.A.S.) | Chinois traditionnel | zh-HK |
Taïwan | Chinois traditionnel | zh-TW |
Japon | Japonais | ja-JP |
Corée du Sud | Coréen | ko-KR |
Pays-Bas | Néerlandais | nl-NL |
République populaire de Chine | Chinois | zh-CN |
Pologne | Polonais | pl-PL |
Brésil | Portugais | pt-br |
Russie | Russe | ru-RU |
Suède | Suédois | sv-SE |
Turquie | Turc | tr-TR |
Pour le point de terminaison /news
, le tableau suivant répertorie les valeurs de code de marché que vous pouvez utiliser pour spécifier le paramètre de requête mkt
. Bing retourne uniquement le contenu pour ces marchés. La liste est susceptible d’être modifiée.
Pour obtenir la liste des codes pays que vous pouvez spécifier dans le paramètre de requête cc
, consultez Codes pays.
Pays/Région | Langage | Code du marché |
---|---|---|
Danemark | Danois | da-DK |
Allemagne | Allemand | de-DE |
Australie | Anglais | en-AU |
Royaume-Uni | Anglais | en-GB |
États-Unis | Anglais | fr-FR |
Anglais | général | en-WW |
Chili | Espagnol | es-CL |
Mexique | Espagnol | es-MX |
États-Unis | Espagnol | es-US |
Finlande | Finnois | fi-FI |
Canada | Français | fr-CA |
France | Français | fr-FR |
Italie | Italien | it-IT |
Portugais | Brésil | pt-br |
République populaire de Chine | Chinois | zh-CN |
Le /news/trendingtopics
tableau suivant endpointhe répertorie les valeurs de code de marché que vous pouvez utiliser pour spécifier le mkt
paramètre de requête. Bing retourne uniquement le contenu pour ces marchés. La liste est susceptible d’être modifiée.
Pour obtenir la liste des codes pays que vous pouvez spécifier dans le paramètre de requête cc
, consultez Codes pays.
Pays/Région | Langage | Code du marché |
---|---|---|
Allemagne | Allemand | de-DE |
Australie | Anglais | en-AU |
Royaume-Uni | Anglais | en-GB |
États-Unis | Anglais | fr-FR |
Canada | Anglais | en-CA |
Inde | Anglais | en-IN |
France | Français | fr-FR |
Canada | Français | fr-CA |
Portugais | Brésil | pt-br |
République populaire de Chine | Chinois | zh-CN |
Codes de pays
Vous trouverez ci-dessous les codes pays que vous pouvez spécifier dans le paramètre de requête cc
. La liste est susceptible d’être modifiée.
Pays/Région | Indicatif de pays |
---|---|
Argentine | AR |
Australie | AU |
Autriche | AT |
Belgique | BE |
Brésil | BR |
Canada | CA |
Chili | CL |
Danemark | DK |
Finlande | FI |
France | FR |
Allemagne | DE |
Hong Kong (R.A.S.) | HK |
Inde | IN |
Indonésie | id |
Italie | IT |
Japon | JP |
Corée du Sud | KR |
Malaisie | MY |
Mexique | MX |
Pays-Bas | NL |
Nouvelle-Zélande | NZ |
Norvège | Non |
République populaire de Chine | CN |
Pologne | PL |
Portugal | PT |
République des Philippines | PH |
Russie | RU |
Arabie Saoudite | SA |
Afrique du Sud | ZA |
Espagne | ES |
Suède | SE |
Suisse | CH |
Taïwan | TW |
Turquie | TR |
Royaume-Uni | Go |
États-Unis | US |
Langues prises en charge par Bing
voici les Bing langues prises en charge que vous pouvez spécifier dans le setLang
paramètre de requête. La liste est susceptible d’être modifiée.
Langues prises en charge | Code de langue |
---|---|
Arabe | ar |
Basque | eu |
Bengali | bn |
Bulgare | bg |
Catalan | ca |
Chinois (simplifié) | zh-hans |
Chinois (traditionnel) | zh-hant |
Croate | hr |
Tchèque | cs |
Danois | da |
Néerlandais | nl |
Anglais | en |
English-United du Royaume-Uni | en-gb |
Estonien | et |
Finnois | fi |
Français | fr |
Galicien | gl |
Allemand | de |
Goudjrati | gu |
Hébreu | he |
Hindi | hi |
Hongrois | hu |
Islandais | is |
Italien | it |
Japonais | JP |
Kannada | kn |
Coréen | ko |
Letton | lv |
Lituanien | lt |
Malais | ms |
Malayalam | ml |
Marathi | mr |
Norvégien (bokmål) | nb |
Polonais | pl |
Portugais (Brésil) | pt-br |
Portugais (Portugal) | pt-pt |
Pendjabi | pa |
Roumain | ro |
Russe | ru |
Serbe (Cyrylic) | sr |
Slovaque | sk |
Slovène | sl |
Espagnol | es |
Suédois | sv |
Tamoul | ta |
Télougou | te |
Thaï | th |
Turc | tr |
Ukrainien | uk |
Vietnamien | vi |