Documents - Suggest Post

Hizmet:: Search Service

API Sürümü:: 2025-08-01-preview

Dizinde, verilen kısmi sorgu metniyle eşleşen belgeleri önerir.

POST {endpoint}/indexes('{indexName}')/docs/search.post.suggest?api-version=2025-08-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	Arama hizmetinin uç nokta URL'si.
indexName	path	True	string	Dizinin adı.
api-version	query	True	string	İstemci API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-request-id		string (uuid)	Hata ayıklamaya yardımcı olmak için istekle birlikte gönderilen izleme kimliği.

İstek Gövdesi

Name	Gerekli	Tür	Description
search	True	string	Belge önermek için kullanılacak arama metni. En az 1 karakter olmalı ve en fazla 100 karakter olmalıdır.
suggesterName	True	string	Dizin tanımının bir parçası olan önericiler koleksiyonunda belirtildiği gibi öneride bulunanın adı.
filter		string	Öneriler için dikkate alınan belgeleri filtreleyen bir OData ifadesi.
fuzzy		boolean	Öneri sorgusu için belirsiz eşleştirmenin kullanılıp kullanılmayacağını belirten bir değer. Varsayılan değer false'tur. Doğru olarak ayarlandığında, arama metninde değiştirilen veya eksik bir karakter olsa bile sorgu önerileri bulur. Bu, bazı senaryolarda daha iyi bir deneyim sağlasa da, bulanık öneri aramaları daha yavaş olduğundan ve daha fazla kaynak tükettiğinden bir performans maliyetiyle birlikte gelir.
highlightPostTag		string	Vurguları vurmak için eklenen bir dize etiketi. highlightPreTag ile ayarlanmalıdır. Atlanırsa, önerilerin isabet vurgulaması devre dışı bırakılır.
highlightPreTag		string	Öne çıkan noktalara basmak için başa eklenen bir dize etiketi. highlightPostTag ile ayarlanmalıdır. Atlanırsa, önerilerin isabet vurgulaması devre dışı bırakılır.
minimumCoverage		number (double)	0 ile 100 arasında, sorgunun başarılı olarak raporlanması için öneri sorgusu tarafından kapsanması gereken dizin yüzdesini gösteren bir sayı. Bu parametre, yalnızca bir çoğaltması olan hizmetler için bile arama kullanılabilirliğini sağlamak için yararlı olabilir. Varsayılan değer 80'dir.
orderby		string	Sonuçların sıralanacağı ifadeleri $orderby için virgülle ayrılmış OData listesi. Her ifade bir alan adı veya geo.distance() ya da search.score() işlevlerine yapılan bir çağrı olabilir. Her ifadenin ardından artanı belirtmek için asc veya azalan ifadeyi belirtmek için desc takip edebilir. Varsayılan değer artan düzendir. Beraberlikler maç skorları ile bozulacaktır. Herhangi bir $orderby belirtilmezse, varsayılan sıralama düzeni belge eşleşme puanına göre azalan düzendir. En fazla 32 $orderby cümle olabilir.
searchFields		string	Belirtilen arama metnini aramak için alan adlarının virgülle ayrılmış listesi. Hedef alanlar, belirtilen öneriye dahil edilmelidir.
select		string	Alınacak alanların virgülle ayrılmış listesi. Belirtilmezse, sonuçlara yalnızca anahtar alan dahil edilir.
top		integer (int32)	Alınacak önerilerin sayısı. Bu, 1 ile 100 arasında bir değer olmalıdır. Varsayılan değer 5'tir.

Yanıtlar

Name	Tür	Description
200 OK	SuggestDocumentsResult	Kısmi girişle eşleşen önerilen belgeleri içeren yanıt.
Other Status Codes	ErrorResponse	Hata yanıtı.

Örnekler

SearchIndexSuggestDocumentsPost

Örnek isteği

HTTP

POST https://previewexampleservice.search.windows.net/indexes('preview-test')/docs/search.post.suggest?api-version=2025-08-01-preview


{
  "filter": "ownerId eq 'sam' and id lt '15'",
  "fuzzy": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": 80,
  "orderby": "id desc",
  "search": "p",
  "searchFields": "category",
  "select": "id,name,category,ownerId",
  "suggesterName": "sg",
  "top": 10
}

Örnek yanıt

Durum kodu:: 200

{
  "@search.coverage": 100,
  "value": [
    {
      "@search.text": "<em>pu</em>rple",
      "id": "14",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.text": "<em>pu</em>rple",
      "id": "13",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.text": "<em>pu</em>rple",
      "id": "11",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.text": "<em>pu</em>rple",
      "id": "1",
      "name": "test",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
SuggestDocumentsResult	Bir dizinden öneri sorgusu sonuçlarını içeren yanıt.
SuggestRequest	Filtreleme, sıralama, belirsiz eşleştirme ve diğer öneri sorgu davranışları için parametreler.
SuggestResult	Öneri sorgusu tarafından bulunan bir belgeyi ve ilişkili meta verileri içeren bir sonuç.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

SuggestDocumentsResult

Nesne

Bir dizinden öneri sorgusu sonuçlarını içeren yanıt.

Name	Tür	Description
@search.coverage	number (double)	Sorguya dahil edilen dizinin yüzdesini gösteren bir değer veya istekte minimumCoverage ayarlanmamışsa null değer.
value	SuggestResult[]	Sorgu tarafından döndürülen sonuçların sırası.

SuggestRequest

Nesne

Filtreleme, sıralama, belirsiz eşleştirme ve diğer öneri sorgu davranışları için parametreler.

Name	Tür	Description
filter	string	Öneriler için dikkate alınan belgeleri filtreleyen bir OData ifadesi.
fuzzy	boolean	Öneri sorgusu için belirsiz eşleştirmenin kullanılıp kullanılmayacağını belirten bir değer. Varsayılan değer false'tur. Doğru olarak ayarlandığında, arama metninde değiştirilen veya eksik bir karakter olsa bile sorgu önerileri bulur. Bu, bazı senaryolarda daha iyi bir deneyim sağlasa da, bulanık öneri aramaları daha yavaş olduğundan ve daha fazla kaynak tükettiğinden bir performans maliyetiyle birlikte gelir.
highlightPostTag	string	Vurguları vurmak için eklenen bir dize etiketi. highlightPreTag ile ayarlanmalıdır. Atlanırsa, önerilerin isabet vurgulaması devre dışı bırakılır.
highlightPreTag	string	Öne çıkan noktalara basmak için başa eklenen bir dize etiketi. highlightPostTag ile ayarlanmalıdır. Atlanırsa, önerilerin isabet vurgulaması devre dışı bırakılır.
minimumCoverage	number (double)	0 ile 100 arasında, sorgunun başarılı olarak raporlanması için öneri sorgusu tarafından kapsanması gereken dizin yüzdesini gösteren bir sayı. Bu parametre, yalnızca bir çoğaltması olan hizmetler için bile arama kullanılabilirliğini sağlamak için yararlı olabilir. Varsayılan değer 80'dir.
orderby	string	Sonuçların sıralanacağı ifadeleri $orderby için virgülle ayrılmış OData listesi. Her ifade bir alan adı veya geo.distance() ya da search.score() işlevlerine yapılan bir çağrı olabilir. Her ifadenin ardından artanı belirtmek için asc veya azalan ifadeyi belirtmek için desc takip edebilir. Varsayılan değer artan düzendir. Beraberlikler maç skorları ile bozulacaktır. Herhangi bir $orderby belirtilmezse, varsayılan sıralama düzeni belge eşleşme puanına göre azalan düzendir. En fazla 32 $orderby cümle olabilir.
search	string	Belge önermek için kullanılacak arama metni. En az 1 karakter olmalı ve en fazla 100 karakter olmalıdır.
searchFields	string	Belirtilen arama metnini aramak için alan adlarının virgülle ayrılmış listesi. Hedef alanlar, belirtilen öneriye dahil edilmelidir.
select	string	Alınacak alanların virgülle ayrılmış listesi. Belirtilmezse, sonuçlara yalnızca anahtar alan dahil edilir.
suggesterName	string	Dizin tanımının bir parçası olan önericiler koleksiyonunda belirtildiği gibi öneride bulunanın adı.
top	integer (int32)	Alınacak önerilerin sayısı. Bu, 1 ile 100 arasında bir değer olmalıdır. Varsayılan değer 5'tir.

SuggestResult

Nesne

Öneri sorgusu tarafından bulunan bir belgeyi ve ilişkili meta verileri içeren bir sonuç.

Name	Tür	Description
@search.text	string	Öneri sonucunun metni.