Udostępnij za pośrednictwem

Jak stronicować wyniki z interfejsów API Wyszukiwanie Bing

  • Artykuł

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest dostarczana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pomocą Azure Marketplace.

Podczas wysyłania wywołania do interfejsów API wyszukiwania wiadomości, obrazów, wiadomości lub wyszukiwania wideo Bing zwraca podzbiór całkowitej liczby wyników, które mogą być istotne dla zapytania. Aby uzyskać szacowaną łączną liczbę dostępnych wyników, uzyskaj dostęp do pola obiektu totalEstimatedMatches odpowiedzi.

Na przykład:

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

Stronicowanie wyników wyszukiwania

Aby stronicować dostępne wyniki, użyj count parametrów zapytania i offset podczas wysyłania żądania.

Uwaga

  • Stronicowanie przy użyciu interfejsów API wideo, obrazów i wiadomości Bing dotyczy tylko ogólnych wyszukiwań wideo (), wiadomości (/video/search/news/search) i obrazów (/image/search). Stronicowanie za pośrednictwem popularnych tematów i kategorii nie jest obsługiwane.
  • Pole TotalEstimatedMatches to oszacowanie całkowitej liczby wyników wyszukiwania dla bieżącego zapytania. Po ustawieniu parametrów count i offset to oszacowanie może ulec zmianie.
Parametr Opis
count Określa liczbę wyników do zwrócenia w odpowiedzi. Należy pamiętać, że wartość domyślna elementu counti maksymalna liczba wyników, które mogą być żądane, różnią się w zależności od interfejsu API. Te wartości można znaleźć w dokumentacji referencyjnej w sekcji Następne kroki.
offset Określa liczbę wyników do pominięcia. Wartość offset jest oparta na zerach i powinna być mniejsza niż ( - totalEstimatedMatchescount).

Jeśli na przykład chcesz wyświetlić 15 wyników na stronę, ustaw count wartość 15 i offset 0, aby uzyskać pierwszą stronę wyników. Dla każdego kolejnego wywołania offset interfejsu API zwiększa się o 15. Poniższy przykład żąda 15 stron internetowych rozpoczynających się od przesunięcia 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

Jeśli używasz wartości domyślnej count , wystarczy określić parametr zapytania w wywołaniach interfejsu offset API.

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

W przypadku korzystania z interfejsów API obrazów Bing i wideo można użyć nextOffset wartości , aby uniknąć duplikowania wyników wyszukiwania. Pobierz wartość z Images obiektów odpowiedzi lub Videos i użyj jej w żądaniach za pomocą parametru offset .

Uwaga

Interfejs API wyszukiwania w internecie Bing zwraca wyniki wyszukiwania, które mogą zawierać strony internetowe, obrazy, wideo i wiadomości. Podczas stronicowania wyników wyszukiwania z interfejsu API wyszukiwania w sieci Web Bing strony są stronicowane tylko dla stron internetowych, a nie innych typów odpowiedzi, takich jak obrazy lub wiadomości. Wyniki wyszukiwania w WebPage obiektach mogą zawierać wyniki wyświetlane również w innych typach odpowiedzi.

Jeśli używasz parametru responseFilter zapytania bez określania żadnych wartości filtru, nie używaj count parametrów i offset .

Następne kroki