Cloud Search sorgu API'si, arama yöntemini sağlar ve hata ayıklama bilgilerini döndürür.
Not: Bu API'nin çalıştırılması için standart bir son kullanıcı hesabı gerekir. Hizmet hesapları doğrudan sorgu API'si istekleri gönderemez. Sorgu yapmak için bir hizmet hesabı kullanmak istiyorsanız Google Workspace alanı genelinde yetki verme özelliğini ayarlayın.
HTTP isteği
POST https://cloudsearch.googleapis.com/v1/query:debugSearch
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "requestOptions": { object ( |
Alanlar | |
---|---|
requestOptions |
Arama uygulaması ve kullanıcı saat dilimi gibi istek seçenekleri. |
query |
Ham sorgu dizesi. Operatörlerden yararlanarak aramanızı daraltma başlıklı makalede desteklenen arama operatörlerini görebilirsiniz. |
pageSize |
Bir sayfada döndürülecek maksimum arama sonucu sayısı. Geçerli değerler 1 ile 100 arasındadır (1 ve 100 dahil). Varsayılan değer 10'dur. 2000'den fazla sonuç istendiğinde minimum değer 50'dir. |
start |
Sonuçların başlangıç dizini. |
dataSourceRestrictions[] |
Sorgu için kullanılacak kaynaklar. Belirtilmezse geçerli arama uygulamasındaki tüm veri kaynakları kullanılır. |
facetOptions[] |
|
sortOptions |
Arama sonuçlarını sıralama seçenekleri |
queryInterpretationOptions |
seçenekleri vardır. |
contextAttributes[] |
Arama sonuçlarının sıralamasını ayarlamak için kullanılacak istek bağlamı özellikleri. Maksimum öğe sayısı 10'dur. |
Yanıt gövdesi
query.search yanıtında hata ayıklama
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"searchResponse": {
object ( |
Alanlar | |
---|---|
searchResponse |
Query.search yanıtı. |
gsrRequest |
GenericSearchRequest'in serileştirilmiş dizesi. Base64 kodlu bir dize. |
gsrResponse |
GenericSearchResponse sınıfının serileştirilmiş dizesi. Base64 kodlu bir dize. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/cloud_search.query
https://www.googleapis.com/auth/cloud_search
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.