كيفية تصفح النتائج من واجهات برمجة تطبيقات البحث Bing

  • مقالة
  • قراءة خلال 2 دقائق

تحذير

في 30 أكتوبر 2020، انتقلت واجهات برمجة تطبيقات البحث Bing من الخدمات المعرفية إلى خدمات البحث Bing. يتم توفير هذه الوثائق للرجوع إليها فقط. للحصول على الوثائق المحدثة، راجع وثائق واجهة برمجة تطبيقات البحث Bing. للحصول على إرشادات حول إنشاء موارد Azure جديدة للبحث Bing، راجع إنشاء مورد بحث Bing خلال Azure Marketplace.

عند إرسال مكالمة إلى واجهات برمجة تطبيقات بحث الويب أو الويب Bing أو المخصصة أو الصور أو الأخبار أو بحث الفيديو، Bing إرجاع مجموعة فرعية من إجمالي عدد النتائج التي قد تكون ذات صلة بالاستعلام. للحصول على العدد الإجمالي المقدر للنتائج المتاحة، قم بالوصول إلى حقل كائن الإجابة totalEstimatedMatches .

على سبيل المثال:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    }
}

الترحيل عبر نتائج البحث

للاطلاع على النتائج المتاحة، استخدم معلمات الاستعلام count عند offset إرسال طلبك.

ملاحظة

  • ينطبق ترحيل الصفحات باستخدام واجهات برمجة التطبيقات Bing الفيديو والصورة والأخبار فقط على عمليات البحث العامة عن الفيديو () والأخبار () والصور (/video/search/news/search/image/search). الترحيل عبر الموضوعات والفئات الشائعة غير مدعوم.
  • الحقل TotalEstimatedMatches عبارة عن تقدير للعدد الإجمالي لنتائج البحث لطلب البحث الحالي. عند تعيين المعلمات والمعلماتoffset، قد يتغير هذا التقديرcount.
المعلمة الوصف
count يحدد عدد النتائج التي سيتم إرجاعها في الاستجابة. لاحظ أن القيمة الافتراضية ل count، والحد الأقصى لعدد النتائج التي قد تطلبها تختلف حسب واجهة برمجة التطبيقات. يمكنك العثور على هذه القيم في الوثائق المرجعية ضمن الخطوات التالية.
offset يحدد عدد النتائج المطلوب تخطيها. ويستند offset إلى الصفر ويجب أن يكون أقل من ( - totalEstimatedMatchescount).

على سبيل المثال، إذا كنت تريد عرض 15 نتيجة لكل صفحة، يمكنك تعيينها count إلى 15 وإلى offset 0 للحصول على الصفحة الأولى من النتائج. لكل مكالمة API لاحقة ، ستزيد offset بمقدار 15. يطلب المثال التالي 15 صفحة ويب تبدأ من الإزاحة 45.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&count=15&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

إذا كنت تستخدم القيمة الافتراضية count ، فما عليك سوى تحديد معلمة الاستعلام offset في استدعاءات واجهة برمجة التطبيقات.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

عند استخدام واجهات برمجة تطبيقات الصور والفيديو Bing، يمكنك استخدام nextOffset القيمة لتجنب تكرار نتائج البحث. احصل على القيمة من Images كائنات الاستجابة أو Videos الاستجابة، واستخدمها في طلباتك باستخدام المعلمة offset .

ملاحظة

تعرض واجهة برمجة تطبيقات بحث الويب Bing نتائج البحث التي يمكن أن تتضمن صفحات ويب وصورا ومقاطع فيديو وأخبارا. عندما تقوم بتصفح نتائج البحث من واجهة برمجة تطبيقات بحث الويب Bing، فأنت تقوم بترحيل صفحات الويب فقط، وليس أنواع الإجابات الأخرى مثل الصور أو الأخبار. قد تتضمن نتائج البحث في الكائنات نتائج تظهر في WebPage أنواع إجابات أخرى أيضا.

إذا كنت تستخدم معلمة الاستعلام دون تحديد أي قيم عامل تصفية، فلا تستخدم المعلمات responseFiltercount و offset .

الخطوات التالية