本文旨在解析Bing新闻搜索API中originalImg参数的使用限制，指出其仅适用于/news/search端点，而非/news端点。通过对比错误用法和正确用法，帮助开发者理解如何有效获取新闻条目的原始图片URL，避免仅获取缩略图的问题，从而优化API调用策略。
在使用bing新闻搜索api时，开发者常希望获取新闻条目的原始图片，而非仅限于缩略图。为此，api提供了originalimg参数。然而，许多开发者在使用此参数时发现其并未按预期工作，导致返回结果中图片信息仅包含缩略图url，而缺少原始图片url。本文将深入探讨这一问题，并提供正确的解决方案。
问题描述：originalImg参数未生效
当开发者尝试通过Bing新闻搜索API获取新闻图片，并在请求中设置originalImg=true时，如果使用了/news端点，API的响应中通常只包含图片的缩略图信息，例如thumbnail.contentUrl，而缺少直接指向原始图片尺寸的contentUrl字段。
以下是一个典型的错误使用示例及其对应的响应结构：
错误用法示例代码：
const url = 'https://bing-news-search1.p.rapidapi.com/news?&originalImg=true&category=india&cc=in&safeSearch=Off&textFormat=Raw';const options = { method: 'GET', headers: { 'X-BingApis-SDK': 'true', 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', // 请替换为您的RapidAPI密钥 'X-RapidAPI-Host': 'bing-news-search1.p.rapidapi.com' }};fetch(url, options) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));
上述请求的典型响应片段（仅包含缩略图）：
{ "url": "https://www.msn.com/en-in/news/world/...", "image": { "_type": "ImageObject", "thumbnail": { "_type": "ImageObject", "contentUrl": "https://www.bing.com/th?id=OVFT._MJPdPJ958_nyj_Ker8qOy&pid=News", "width": 1280, "height": 720, "isLicensed": true } }}
从上述响应可以看出，image对象中只有thumbnail字段提供了图片URL，且该URL指向的是Bing处理过的缩略图，而非原始尺寸图片。开发者期望的是在image对象下直接获得一个contentUrl字段，指向原始图片，类似如下结构：
{ "image": { "_type": "ImageObject", "contentUrl": "https://s.yimg.com/ny/api/res/1.2/...", // 期望的原始图片URL "thumbnail": { "_type": "ImageObject", "contentUrl": "https://www.bing.com/th?id=OVFT.1Wypj4IiKxycYuiB2Q81GC&pid=News", "width": 700, "height": 350 } }}
根本原因：originalImg参数的端点限制
根据Bing新闻搜索API v7的官方文档说明，originalImg参数并非对所有新闻相关的API端点都有效。它明确指出：
“Use this parameter only with the News Search API. Do not specify this parameter when calling the Web Search API. Trending Topics ignores this parameter.”
这意味着originalImg参数仅适用于/news/search端点，而当使用/news（获取热门新闻或特定类别新闻）或Trending Topics等其他端点时，该参数会被忽略。上述问题中，开发者使用了/news端点，因此originalImg=true的设置未能生效。
解决方案：使用正确的API端点
要成功获取新闻的原始图片URL，开发者必须将请求的目标端点从/news更改为/news/search。通过/news/search端点，并设置originalImg=true，API将会在响应的image对象中包含contentUrl字段，指向原始尺寸的图片。
正确用法示例代码：
const url = 'https://bing-news-search1.p.rapidapi.com/news/search?q=india news&originalImg=true&category=india&cc=in&safeSearch=Off&textFormat=Raw'; // 注意端点已更改为 /news/searchconst options = { method: 'GET', headers: { 'X-BingApis-SDK': 'true', 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', // 请替换为您的RapidAPI密钥 'X-RapidAPI-Host': 'bing-news-search1.p.rapidapi.com' }};fetch(url, options) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));
上述请求的预期响应片段（包含原始图片URL）：
{ "value": [ { "url": "https://www.msn.com/en-in/news/world/...", "image": { "_type": "ImageObject", "contentUrl": "https://media.zenfs.com/en/hearst_womens_health_52/9743c154e3be883ec18c41f03fc44d58", // 原始图片URL "thumbnail": { "_type": "ImageObject", "contentUrl": "https://www.bing.com/th?id=OVFT.1Wypj4IiKxycYuiB2Q81GC&pid=News", "width": 700, "height": 350 } }, // ... 其他新闻条目信息 } ]}
在上述正确用法中，url中的端点已从/news修改为/news/search，并且通常需要提供一个q（查询词）参数来指定搜索内容。此时，API响应的image对象中便会包含contentUrl字段，指向原始尺寸的图片。
注意事项与总结
端点选择至关重要： 务必根据您的需求选择正确的API端点。如果目标是获取带有原始图片的新闻搜索结果，请使用/news/search。如果仅需要热门新闻或特定类别新闻且不关心原始图片，/news端点可能更合适。查询参数： 使用/news/search端点时，通常需要提供q（查询词）参数。官方文档查阅： 在开发过程中，始终建议查阅Bing新闻搜索API的官方文档（如Microsoft Learn），以获取最准确和最新的参数使用说明和限制。这有助于避免因参数误用而导致的问题。响应结构： 即使使用了正确的端点和参数，并非所有新闻条目都会提供原始图片。如果某个新闻源没有提供高分辨率图片，或者Bing无法抓取到，contentUrl字段可能仍然缺失或指向缩略图。
通过理解originalImg参数的端点限制，开发者可以更精确地控制Bing新闻搜索API的行为，从而有效地获取所需的原始图片信息，提升应用程序的功能性和用户体验。
以上就是解决Bing新闻搜索API中originalImg参数不生效的问题的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1523765.html
微信扫一扫 
支付宝扫一扫 
