Yapılan arama, arama için kullanılan motorla ilgili meta veriler ve arama sonuçlarıyla ilgili meta verileri döndürür. Küçük bir URL kalıpları grubu kullanır.
HTTP isteği
GET https://customsearch.googleapis.com/customsearch/v1/siterestrict
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler | |
|---|---|
c2coff | 
                
                   
 Basitleştirilmiş ve Geleneksel Çince Arama'yı etkinleştirir veya devre dışı bırakır. Bu parametrenin varsayılan değeri 0'dır (sıfır). Bu, özelliğin etkinleştirildiği anlamına gelir. Desteklenen değerler: 
  | 
              
cr | 
                
                   
 Arama sonuçlarını, belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresi değerinde Boole operatörlerini kullanabilirsiniz. Google Arama, bir dokümanın ülkesini belirlemek için aşağıdakileri analiz eder: 
 Bu parametrenin geçerli değerlerinin listesi için Ülke Parametresi Değerleri sayfasına bakın.  | 
              
cx | 
                
                   
 Bu istek için kullanılacak Programlanabilir Arama Motoru Kimliği.  | 
              
dateRestrict | 
                
                   
 Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır: 
  | 
              
exactTerms | 
                
                   
 Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar.  | 
              
excludeTerms | 
                
                   
 Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar.  | 
              
fileType | 
                
                   
 Sonuçları, belirli bir uzantıya ait dosyalarla kısıtlar. Google tarafından dizine eklenebilen dosya türlerinin listesini Search Console Yardım Merkezi'nde bulabilirsiniz.  | 
              
filter | 
                
                   
 Yinelenen içerik filtresini etkinleştirmeyi veya devre dışı bırakmayı kontrol eder. 
 Kabul edilebilir değerler şunlardır: 
  | 
              
gl | 
                
                   
 Son kullanıcının coğrafi konumu. 
  | 
              
googlehost | 
                
                   
 Kullanımdan kaldırıldı. Benzer bir efekt için  Aramayı gerçekleştirmek için kullanılacak yerel Google alan adı (ör. google.com, google.de veya google.fr).  | 
              
highRange | 
                
                   
 Bir arama aralığının bitiş değerini belirtir. 
  | 
              
hl | 
                
                   
 Kullanıcı arayüzü dilini ayarlar. 
  | 
              
hq | 
                
                   
 Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler.  | 
              
imgColorType | 
                
                   
 Siyah beyaz, gri tonlamalı, şeffaf veya renkli görseller döndürür. Kabul edilebilir değerler şunlardır: 
  | 
              
imgDominantColor | 
                
                   
 Belirli bir baskın rengin görsellerini döndürür. Kabul edilebilir değerler şunlardır: 
  | 
              
imgSize | 
                
                   
 Belirtilen boyuttaki görselleri döndürür. Kabul edilebilir değerler şunlardır: 
  | 
              
imgType | 
                
                   
 Belirli bir türdeki görselleri döndürür. Kabul edilebilir değerler şunlardır: 
  | 
              
linkSite | 
                
                   
 Tüm arama sonuçlarının belirli bir URL'ye bir bağlantı içermesi gerektiğini belirtir.  | 
              
lowRange | 
                
                   
 Bir arama aralığının başlangıç değerini belirtir. Sorguya   | 
              
lr | 
                
                   
 Aramayı belirli bir dilde yazılmış dokümanlarla kısıtlar (ör.  Kabul edilebilir değerler şunlardır: 
  | 
              
num | 
                
                   
 Döndürülecek arama sonuçlarının sayısı. 
  | 
              
orTerms | 
                
                   
 Bir dokümanda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her doküman ek arama terimlerinden en az birini içermelidir.  | 
              
q | 
                
                   
 Sorgu  | 
              
relatedSite | 
                
                   
 Kullanımdan kaldırıldı.  | 
              
rights | 
                
                   
 Lisanslamaya dayalı filtreler. Desteklenen değerler şunları içerir:   | 
              
safe | 
                
                   
 Arama güvenlik seviyesi. Kabul edilebilir değerler şunlardır: 
  | 
              
searchType | 
                
                   
 Arama türünü belirtir:  Kabul edilebilir değerler şunlardır: 
  | 
              
siteSearch | 
                
                   
 Her zaman sonuçlara dahil edilmesi veya sonuçlardan hariç tutulması gereken belirli bir siteyi belirtir (aşağıdaki   | 
              
siteSearchFilter | 
                
                   
 
 Kabul edilebilir değerler şunlardır: 
  | 
              
sort | 
                
                   
 Sonuçlara uygulanacak sıralama ifadesi. Sıralama parametresi, sonuçların belirtilen ifadeye göre sıralanacağını (ör. tarihe göre sıralama) belirtir. Örnek: Sort=date.  | 
              
start | 
                
                   
 Döndürülecek ilk sonucun dizini. Her sayfa için varsayılan sonuç sayısı 10'dur, dolayısıyla   | 
              
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, Search öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cse
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.