XML API referansı

Bu sayfa, yalnızca Google Site Search müşterilerinin kullanabildiği Custom Search JSON API'nin XML sürümüyle ilgilidir.

  1. Genel Bakış
  2. Programlanabilir Arama Motoru İstek Biçimi
    1. Genel Bakış İsteği
    2. Sorgu Terimleri
    3. İstek Parametreleri
      1. Örnek WebSearch Sorguları
      2. WebSearch Sorgu Parametresi Tanımları
      3. Gelişmiş Arama
      4. Gelişmiş Arama Sorgusu Parametreleri
      5. Özel Sorgu Terimleri
      6. Örnek Görsel Sorguları
      7. Görsel Arama Sorgu Parametreleri
      8. İstek Sınırları
    4. Sorguları ve Sonuçları Sunumu Uluslararasılaştırma
      1. Karakter Kodlama
      2. Arayüz Dilleri
      3. Basitleştirilmiş ve Geleneksel Çince Arama
    5. Sonuçları Filtreleme
      1. Arama sonuçlarını otomatik olarak filtreleme
      2. Dil ve Ülke Filtreleme
      3. Yetişkinlere Uygun İçerikleri Güvenli Arama ile Filtreleme
  3. XML Sonuçları
    1. Google XML Sonuçları DTD
    2. XML Yanıtı hakkında
    3. Normal, Görsel ve Gelişmiş Arama Sorguları için XML Sonuçları
      1. Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu
      2. Normal/Gelişmiş Arama: XML Etiketleri
      3. Görsel Arama Sorguları için XML Sonuçları
      4. Görsel Arama: Örnek Sorgu ve XML Sonucu
      5. Görsel Arama: XML Etiketleri

Genel bakış

Google WebSearch hizmeti, Google Site Search müşterilerinin Google arama sonuçlarını kendi web sitelerinde görüntüleyebilmesini sağlar. WebSearch hizmeti, arama sonuçlarını sunmak için HTTP tabanlı basit bir protokol kullanır. Arama yöneticileri, arama sonuçlarını isteme ve bu sonuçları son kullanıcıya sunma şekilleri üzerinde tam kontrole sahiptir. Bu dokümanda, Google arama isteğinin ve sonuç biçimlerinin teknik ayrıntıları açıklanmaktadır.

Uygulamanız, Google WebSearch sonuçlarını almak için Google'a basit bir HTTP isteği gönderir. Google, daha sonra arama sonuçlarını XML biçiminde döndürür. XML biçimli sonuçlar, arama sonuçlarının görüntülenme şeklini özelleştirmenize olanak tanır.

WebSearch İstek Biçimi

İsteğe Genel Bakış

Google arama isteği standart bir HTTP GET komutudur. Sorgularınızla alakalı parametre koleksiyonunu içerir. Bu parametreler, istek URL'sine "ve" (&) karakterleri ile ayrılmış ad=değer çiftleri olarak eklenir. Parametreler, arama sorgusu ve HTTP isteğini yapan motoru tanımlayan benzersiz bir motor kimliği (cx) gibi verileri içerir. WebSearch veya Görsel Arama hizmeti, HTTP isteklerinize yanıt olarak XML sonuçları döndürür.

Sorgu Terimleri

Çoğu arama isteği bir veya daha fazla sorgu terimi içerir. Sorgu terimi, arama isteğindeki bir parametrenin değeri olarak görünür.

Sorgu terimleri, Google'ın döndürdüğü arama sonuçlarını filtrelemek ve düzenlemek için çeşitli bilgi türlerini belirtebilir. Sorgular şunları belirtebilir:

  • Dahil edilecek veya hariç tutulacak kelimeler ya da kelime öbekleri
    • Bir arama sorgusundaki kelimelerin tümü (varsayılan)
    • Arama sorgusundaki tam ifade
    • Arama sorgusundaki herhangi bir kelime veya kelime öbeği
  • Arama terimlerini aramak için dokümanın neresinde?
    • Dokümanın herhangi bir yerinde (varsayılan)
    • Yalnızca dokümanın gövdesinde
    • Yalnızca doküman başlığında
    • Yalnızca dokümanın URL'sinde
    • Yalnızca dokümandaki bağlantılarda
  • Belgelerle ilgili kısıtlamalar
    • Belirli dosya türlerindeki dokümanları (ör. PDF dosyaları veya Word dokümanları) dahil etme veya hariç tutma
  • Arama yapmak yerine belirli bir URL hakkında bilgi döndüren özel URL sorguları
    • Bir URL hakkında, URL'nin Açık Dizin kategorisi, snippet'i veya dili gibi genel bilgileri döndüren sorgular
    • Bir URL'ye bağlantı veren web sayfaları grubunu döndüren sorgular
    • Belirli bir URL'ye benzer bir web sayfası grubu döndüren sorgular

Varsayılan Arama

Arama sorgusu parametre değerleri URL çıkışlı olmalıdır. Arama sorgusundaki tüm boşluk dizilerinin yerine artı işaretini ("+") koyacağınızı unutmayın. Bu konu, bu dokümanın URL Çıkışı bölümünde daha ayrıntılı olarak ele alınmaktadır.

Arama sorgusu terimi, q parametresi kullanılarak WebSearch hizmetine gönderilir. Örnek bir arama sorgusu terimi:

q=horses+cows+pigs

Varsayılan olarak Google WebSearch hizmeti yalnızca arama sorgusundaki terimlerin tümünü içeren dokümanları döndürür.

İstek Parametreleri

Bu bölümde, arama isteğinde bulunurken kullanabileceğiniz parametreler listelenmiştir. Parametreler iki listeye ayrılır. İlk liste tüm arama istekleriyle alakalı parametreleri içerir. İkinci liste, yalnızca gelişmiş arama istekleriyle alakalı parametreleri içerir.

Üç istek parametresi gereklidir:

  • client parametresi google-csbe olarak ayarlanmalıdır.
  • output parametresi, döndürülen XML sonuçlarının biçimini belirtir. Sonuçlar, Google'ın DTD'sine referansla (xml) veya (xml_no_dtd) referans olmadan döndürülebilir. Bu değeri xml_no_dtd olarak ayarlamanızı öneririz. Not: Bu parametreyi belirtmezseniz sonuçlar XML yerine HTML olarak döndürülür.
  • Motorun benzersiz kimliğini temsil eden cx parametresi.

Yukarıda belirtilenler dışında en yaygın kullanılan istek parametreleri şunlardır:

  • num: İstenen arama sonucu sayısı
  • q: arama terimleri
  • başlangıç: sonuçların başlangıç dizini

Örnek WebSearch Sorguları

Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç WebSearch HTTP isteği gösterilmektedir. Farklı sorgu parametrelerinin tanımları bu belgenin WebSearch Sorgusu Parametresi Tanımları ve Gelişmiş Arama Sorgusu Parametreleri bölümlerinde sağlanmıştır.

Bu istekte "red sox" (q=red+sox) sorgu terimi için ilk 10 sonuç (start=0&num=10) istenir. Sorgu, sonuçların Kanada web sitelerinden (cr=countryCA) gelmesi ve Fransızca (lr=lang_fr) yazılması gerektiğini de belirtir. Son olarak sorgu, üçü de gerekli olan client, output ve cx parametrelerinin değerlerini belirtir.

http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i

Bu örnekte, arama sorgusunu daha da özelleştirmek için gelişmiş arama sorgusu parametrelerinden bazıları kullanılmaktadır. Bu istek, q parametresi yerine as_q parametresini (as_q=red+sox) kullanır. Ayrıca "Yankees" kelimesini içeren dokümanları arama sonuçlarından (as_eq=yankees) hariç tutmak için as_eq parametresi de kullanılır.

http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i

WebSearch Sorgu Parametresi Tanımları

c2coff
Açıklama

Optional. c2coff parametresi, Basitleştirilmiş ve Geleneksel Çince Arama özelliğini etkinleştirir veya devre dışı bırakır.

Bu parametrenin varsayılan değeri 0 (sıfır) şeklindedir. Bu değer, özelliğin etkinleştirildiği anlamına gelir. c2coff parametresinin değerleri:

Değer İşlem
1 Devre dışı
0 Etkin
Örnekler q=google&c2coff=1

müşteri
Açıklama

Zorunludur. client parametresi google-csbe olarak ayarlanmalıdır.

Örnekler q=google&client=google-csbe

cr
Açıklama

Optional. cr parametresi, arama sonuçlarını belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresinin değerinde Boole operatörlerini kullanabilirsiniz.

Google WebSearch, bir belgenin ülkesini belirlemek için aşağıdakileri analiz eder:

  • doküman URL'sinin üst düzey alanı (TLD)
  • Web sunucusunun IP adresinin coğrafi konumu

Bu parametrenin geçerli değerlerinin listesi için Ülke (cr) Parametre Değerleri bölümüne bakın.

Örnekler q=Frodo&cr=countryNZ

cx
Açıklama

Zorunludur. cx parametresi, özel bir arama motorunu tanımlayan benzersiz bir kod belirtir. Bir Programlanabilir Arama Motorunu belirttiğiniz motordan arama sonuçlarını almak için cx parametresini kullanarak belirtmeniz gerekir.

cx parametresinin değerini bulmak için motorunuzun Denetim Masası > Kodlar sekmesine gidin. "Bu kodu sayfada arama kutunuzun görünmesini istediğiniz yere yapıştırın" altındaki metin alanında bulabilirsiniz. Arama sonuçları Google tarafından barındırılan bir sayfada gösterilir.

Örnekler q=Frodo&cx=00255077836266642015:u-scht7a-8i

filter
Açıklama

Optional. filter parametresi, Google arama sonuçlarının otomatik olarak filtrelenmesini etkinleştirir veya devre dışı bırakır. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için bu dokümanın Otomatik Filtreleme bölümüne bakın.

filter parametresi için varsayılan değer olan 1, özelliğin etkinleştirildiğini gösterir. Bu parametre için geçerli değerler şunlardır:

Değer İşlem
1 Devre dışı
0 Etkin

Not: Google varsayılan olarak, kalitesini iyileştirmek için tüm arama sonuçlarına filtreleme uygular.

Örnekler q=google&filter=0

gl
Açıklama

Optional. gl parametre değeri iki harfli bir ülke kodudur. WebSearch sonuçları için gl parametresi, menşe ülkesi parametre değeriyle eşleşen arama sonuçlarını iyileştirir. Geçerli değerlerin listesi için Ülke Kodları bölümüne bakın.

WebSearch isteklerinde gl parametresi değeri belirtilmesi, sonuçların alaka düzeyini artırır. Bu durum özellikle uluslararası müşteriler, hatta ABD dışında İngilizce konuşulan ülkelerdeki müşteriler için geçerlidir.

Örnekler

Bu istek, Birleşik Krallık'ta yazılan dokümanları WebSearch sonuçlarında öne çıkarır:
q=pizza&gl=uk


hl
Açıklama

Optional. hl parametresi, kullanıcı arayüzünüzün arayüz dilini (ana makine dili) belirtir. Arama sonuçlarınızın performansını ve kalitesini iyileştirmek için bu parametreyi açıkça belirtmeniz önemle tavsiye edilir.

Daha fazla bilgi için Sorguları ve Sonuçlar Sunumunu Uluslararasılaştırma'nın Arayüz Dilleri bölümüne, desteklenen dillerin listesi için de Desteklenen Arayüz Dilleri bölümüne bakın.

Örnekler

Bu istek, Fransızca şarap reklamlarını hedefler. (Vin, Fransızca şarap terimidir.)

q=vin&ip=10.10.10.10&ad=w5&hl=fr

Hq
Açıklama

Optional. hq parametresi, belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmiş gibi sorguya ekler.

Örnekler

Bu istekte "pizza" VE "peynir" araması yapılır. İfade, q=pizza+cheese ile aynı.

q=pizza&hq=cheese


ie
Açıklama

Optional. ie parametresi, sorgu dizesini yorumlamak için kullanılması gereken karakter kodlama şemasını ayarlar. Varsayılan ie değeri latin1 değeridir.

Bu parametreyi ne zaman kullanmanız gerekebileceği hakkında bilgi edinmek için Karakter Kodlama bölümünü inceleyin.

Olası ie değerlerinin listesi için Karakter Kodlama Düzenleri bölümüne bakın.

Örnekler q=google&ie=utf8&oe=utf8
lr
Açıklama

Optional. lr (dil kısıtlama) parametresi, arama sonuçlarını belirli bir dilde yazılmış dokümanlarla kısıtlar.

Google WebSearch, dokümanda kullanılan dili belirlemek için aşağıdakileri analiz eder:

  • doküman URL'sinin üst düzey alanı (TLD)
  • dokümanın dil meta etiketleri
  • dokümanın gövde metninde kullanılan birincil dil
  • dokümanın gövde metninde kullanılan ikincil diller (varsa)

Bu parametrenin geçerli değerlerinin bir listesi için Dil (lr) Koleksiyon Değerleri bölümüne bakın.

Örnekler q=Frodo&lr=lang_en

num
Açıklama

Optional. num parametresi, döndürülecek arama sonuçlarının sayısını tanımlar.

Varsayılan num değeri 10, maksimum değer ise 20'dir. 20'den fazla sonuç talep ederseniz yalnızca 20 sonuç döndürülür.

Not: Arama sonuçlarının toplam sayısı istenen sonuç sayısından azsa mevcut tüm arama sonuçları döndürülür.

Örnekler q=google&num=10

oe
Açıklama

Optional. oe parametresi, XML sonucunun kodunu çözmek için kullanılması gereken karakter kodlama şemasını ayarlar. Varsayılan oe değeri latin1 değeridir.

Bu parametreyi ne zaman kullanmanız gerekebileceği hakkında bilgi edinmek için Karakter Kodlama bölümünü inceleyin.

Olası oe değerlerinin listesi için Karakter Kodlama Düzenleri bölümüne bakın.

Örnekler q=google&ie=utf8&oe=utf8

çıkış
Açıklama

Zorunludur. output parametresi, XML sonuçlarının biçimini belirtir. Bu parametre yalnızca xml ve xml_no_dtd değerleri için geçerlidir. Aşağıdaki tabloda, bu parametre değerlerinin farkı açıklanmaktadır.

Değer Çıktı Biçimi
xml_no_dtd XML sonuçları bir !DOCTYPE ifadesi içermez. (Önerilen)
xml XML sonuçları bir Google DTD referansı içerir. Sonucun ikinci satırı, sonuçların kullandığı belge tanımı türünü (DTD) tanımlar:
    <!DOCTYPE GSP SYSTEM "google.dtd">
Örnekler output=xml_no_dtd
output=xml

q
Açıklama

Optional. q parametresi, kullanıcı tarafından girilen arama sorgusunu belirtir. Bu parametre isteğe bağlı olsa da, arama sonuçlarını almak için sorgu parametrelerinden (as_epq, as_lq, as_oq, as_q) en az biri için bir değer belirtmeniz gerekir.

Ayrıca, q parametresinin değerinin parçası olarak kullanılabilecek bazı özel sorgu terimleri de vardır. Bu terimlerin listesi ve tanımları için lütfen Özel Sorgu Terimleri'ne bakın.

Google Arama Kontrol Paneli, q parametresi kullanılarak gönderilen en çok yapılan sorguların bir raporunu içerir.

Not: q parametresi için belirtilen değer URL çıkışlı olmalıdır.

Örnekler q=vacation&as_oq=london+paris

güvenli
Açıklama

Optional. safe parametresi, arama sonuçlarının yetişkinlere uygun ve pornografik içeriğe göre nasıl filtrelenmesi gerektiğini belirtir. safe parametresi için varsayılan değer off değeridir. Geçerli parametre değerleri şunlardır:

Değer İşlem
off Güvenli Arama'yı devre dışı bırak
medium Güvenli Arama'yı etkinleştirme
high Güvenli Arama'nın daha katı bir sürümünü etkinleştirme

Bu özellikle ilgili daha ayrıntılı bilgi için Yetişkinlere Uygun İçeriği Güvenli Arama ile Filtreleme bölümüne bakın.

Örnekler q=adult&safe=high

start
Açıklama

Optional. start parametresi, arama sonuçlarına eklenmesi gereken ilk eşleşen sonucu gösterir. start parametresi sıfır tabanlı bir dizin kullanır. Yani ilk sonuç 0, ikinci sonuç 1 olur ve bu böyle devam eder.

start parametresi, hangi arama sonuçlarının döndürüleceğini belirlemek için num parametresiyle birlikte çalışır. Sorguyla 1.000'den fazla doküman eşleşse bile, bir sorgu için en fazla 1.000 sonuç döndürüleceğini unutmayın. Dolayısıyla, 1.000 veya daha fazla olarak ayarlandığında sonuç döndürülmez.

Örnekler start=10

sıralama
Açıklama

Optional. sort parametresi, sonuçların belirtilen ifadeye göre sıralanacağını belirtir. Örneğin, tarihe göre sıralayın.

Örnekler

sort=date


g
Açıklama

Optional. ud parametresi, XML yanıtının arama sonucu için IDN kodlamalı URL'yi içerip içermeyeceğini belirtir. IDN (Uluslararası Alan Adı) kodlaması, alan adlarının yerel diller kullanılarak gösterilmesine olanak tanır. Örneğin:

http://www.花井鮨.com

Bu parametre için geçerli değerler 1 (varsayılan) şeklindedir. Diğer bir deyişle, XML sonucu IDN kodlamalı URL'leri içermelidir. 0 ise XML sonucunun IDN kodlamalı URL'leri içermemesi gerektiği anlamına gelir. ud parametresi 1 olarak ayarlanırsa IDN kodlamalı URL, XML sonuçlarınızdaki UD etiketinde görünür.

ud parametresi 0 olarak ayarlanırsa yukarıdaki örnekte bulunan URL şu şekilde görüntülenir:

http://www.xn--elq438j.com.

Not: Bu bir beta özelliktir.

Örnekler q=google&ud=1

Görselin altında listelenen ek sorgu parametreleri gelişmiş arama sorgularıyla alakalıdır. Gelişmiş arama gönderdiğinizde, çeşitli parametrelerin değerleri (ör. as_eq, as_epq, as_oq vb.) ilgili aramayla ilgili sorgu terimlerinde dikkate alınır. Resimde, Google'ın Gelişmiş Arama sayfası gösterilmektedir. Resimde, her bir gelişmiş arama parametresinin adı, sayfada bu parametrenin karşılık geldiği alanın içinde veya yanında red metinle yazılır.



Gelişmiş Arama Sorgusu Parametreleri

as_dt
Açıklama

Optional. as_dt parametresi, as_sitesearch parametresinde adlandırılmış siteden sonuçların dahil edilip edilmeyeceğini kontrol eder. i ve e değerleri, sırasıyla dahil etme ve hariç tutmayı ifade eder.

Örnekler as_dt=i,as_dt=e

as_epq
Açıklama

Optional. as_epq parametresi, arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar. Bir ifadeyi aramak için sıralı arama sorgu terimini de kullanabilirsiniz.

Örnekler as_epq=abraham+lincoln

as_eq
Açıklama

Optional. as_eq parametresi, arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar. Belirli bir kelime veya kelime öbeğinin bir dizi arama sonucundaki dokümanlarda görünmemesi için hariç tut sorgu terimini de kullanabilirsiniz.

Örnekler

q=bass&as_eq=music.


as_lq
Açıklama

Optional. as_lq parametresi, tüm arama sonuçlarının belirli bir URL'ye giden bir bağlantıyı içermesi gerektiğini belirtir. Bu sorgu türü için link: sorgu terimini de kullanabilirsiniz.

Örnekler

as_lq=www.google.com


as_nlo
Açıklama

Optional. as_nlo parametresi, bir arama aralığının başlangıç değerini belirtir. Sorguya as_nlo...as_nhi tutarında kapsayıcı arama aralığı eklemek için as_nlo ve as_nhi kullanın.

Örnekler

Aşağıdakiler de dahil olmak üzere 5 ile 10 arasında bir arama aralığı ayarlar:

as_nlo=5&as_nhi=10

as_nhi
Açıklama

Optional. as_nhi parametresi, arama aralığının bitiş değerini belirtir. Sorguya as_nlo...as_nhi kapsayıcı arama aralığı eklemek için as_nlo ve as_nhi kullanın.

Örnekler

Aşağıdakiler de dahil olmak üzere 5 ile 10 arasında bir arama aralığı ayarlar:

as_nlo=5&as_nhi=10

as_oq
Açıklama

Optional. as_oq parametresi, dokümanlarda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her belgenin ek arama terimlerinden en az birini içermesi gerekir. Bu sorgu türü için Boole VEYA sorgu terimini de kullanabilirsiniz.

Örnekler

q=vacation&as_oq=London+Paris


as_q
Açıklama

Optional. as_q parametresi, bir dokümanda kontrol edilecek arama terimleri sağlar. Bu parametre, kullanıcıların bir dizi arama sonucu içinde aranacak ek terimler belirtmesine olanak tanımak için de yaygın olarak kullanılır.

Örnekler

q=president&as_q=John+Adams


as_qdr
Açıklama

Optional. as_qdr parametresi, belirli bir döneme (hızlı tarih aralığı) ait arama sonuçları ister. Aşağıdaki değerler desteklenir:

d[number], belirtilen sayıda geçmiş günden sonuç ister.
w[number], belirtilen sayıda geçmiş haftadan sonuçları istiyor.
m[number], belirtilen sayıda geçmiş aydan sonuçları ister.
y[number], belirtilen sayıda geçmiş yıla ait sonuçları istiyor.

Örnekler

Bu örnekte geçen yıla ait sonuçlar istenmektedir:

as_qdr=y

Bu örnekte son 10 güne ait sonuçlar istenir:

as_qdr=d10

as_sitesearch
Açıklama

Optional. as_sitesearch parametresi, tüm arama sonuçlarının belirli bir sitedeki sayfalar olması gerektiğini belirtmenize olanak tanır. as_dt parametresini ayarlayarak, belirli bir sitedeki sayfaları arama sonuçlarınızın dışında bırakmak için de bu parametreyi kullanabilirsiniz.

Örnekler

q=vacation&as_sitesearch=www.google.com


Özel Sorgu Terimleri

Google WebSearch, Google arama motorunun ek özelliklerine erişen birkaç özel sorgu teriminin kullanılmasına izin verir. Bu özel sorgu terimleri, q istek parametresinin değerine eklenmelidir. Diğer sorgu terimlerinde olduğu gibi özel sorgu terimlerinin de URL çıkışlı olması gerekir. Özel sorgu terimlerinden bazıları iki nokta üst üste (:) içerir. Bu karakterin de URL çıkışlı olması gerekir; URL çıkışlı değeri %3A'dir.

Geri Bağlantılar [link:]
Açıklama

link: sorgu terimi, belirli bir URL'ye bağlantı veren web sayfaları kümesini alır. Arama sorgusu, link: sorgu terimi ile URL arasında boşluk bırakılmadan link:URL olarak biçimlendirilmelidir.

link: öğesinin URL çıkışlı sürümü link%3A.

Bir link: isteği göndermek için as_lq istek parametresini de kullanabilirsiniz.

Not: link: kullanırken başka bir sorgu terimi belirtemezsiniz.

Örnekler

http://www.google.com/search?q=link%3Awww.example.com


Boole VEYA Arama [ VEYA ]
Açıklama

OR sorgu terimi, bir dizi (iki veya daha fazla) sorgu teriminden birini içeren belgeleri getirir. OR sorgu terimini kullanmak için OR arama terimini büyük harflerle, serideki her terimin arasına girersiniz.

Bir terim grubundaki herhangi bir terim için arama göndermek üzere as_oq istek parametresini de kullanabilirsiniz.

Not: Bir arama isteği "London+OR+Paris" sorgusunu belirtirse arama sonuçları, bu iki kelimeden en az birini içeren belgeleri içerir. Bazı durumlarda, arama sonuçlarındaki dokümanlar her iki kelimeyi de içerebilir.

Örnekler

Londra veya Paris'i arayın:

Kullanıcı girişi:london OR paris Sorgu terimi:q=london+OR+paris

Tatil ve Londra ya da Paris için arama yapın:

Sorgu terimi:q=vacation+london+OR+paris

Tatil ve Londra, Paris veya çikolata seçenekleri için arama yapın:

Sorgu terimi:  q=vacation+london+OR+paris+OR+chocolates

Tatil ve çikolatalar ile londra veya paris kelimelerini, en az ağırlığı çikolatalara vererek arayın:

Sorgu terimi:  q=vacation+london+OR+paris+chocolates

Londra veya Paris'i de içeren dokümanlarda tatil, çikolata ve çiçek araması yapın:

Sorgu terimi:  q=vacation+london+OR+paris+chocolates+flowers

Tatil ve Londra ya da Paris için arama yapın ve ayrıca çikolata veya çiçeklerden birini arayın:

Sorgu terimi:  q=vacation+london+OR+paris+chocolates+OR+flowers

Sorgu Terimini Hariç Tut [-]
Açıklama

Hariç tut (-) sorgu terimi, belirli bir arama isteğine ait sonuçları belirli bir kelimeyi veya kelime öbeğini içermeyen dokümanlarla kısıtlar. Hariç tutulacak sorgu terimini kullanmak için eşleşen dokümanlardan hariç tutulacak kelime veya kelime öbeğinin önüne "-" (eksi işareti) ile eklemeniz gerekir.

- öğesinin URL çıkışlı sürümü %2D.

"Hariç tut" sorgu terimi, bir arama terimi birden fazla anlama sahip olduğunda yararlıdır. Örneğin, "bas" kelimesi balık veya müzik ile ilgili sonuçlar döndürebilir. Balıklarla ilgili dokümanları arıyor olsaydınız, hariç tut sorgu terimini kullanarak müzikle ilgili dokümanları arama sonuçlarınızdan hariç tutabilirsiniz.

Belirli bir kelime veya kelime öbeğiyle eşleşen dokümanları arama sonuçlarından hariç tutmak için as_eq istek parametresini de kullanabilirsiniz.

Örnekler Kullanıcı girişi: bass -music
Sorgu terimi: q=bass+%2Dmusic

Dosya Türü Hariç Tutma [ -filetype: ]
Açıklama

-filetype: sorgu terimi, ".pdf" veya ".doc" gibi belirli bir dosya uzantısına sahip dokümanları arama sonuçlarından hariç tutar. Arama sorgusu, -filetype: sorgu terimi ile belirtilen uzantı arasında boşluk bırakılmadan -filetype:EXTENSION olarak biçimlendirilmelidir.

-filetype: öğesinin URL çıkışlı sürümü %2Dfiletype%3A.

Not: Sorgunuza daha fazla -filetype: sorgu terimi ekleyerek birden fazla dosya türünü arama sonuçlarından hariç tutabilirsiniz. Arama sonuçlarından hariç tutulması gereken her dosya uzantısı için arama sorgunuzda bir -filetype: sorgu teriminiz olmalıdır.

Google tarafından desteklenen dosya türleri şunlardır:

  • Adobe Taşınabilir Belge Biçimi (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (hf1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • Mac yazma (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doküman)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Yazma (wri)
  • Zengin Metin Biçimi (rtf)
  • Şok Dalgası Flash (swf)
  • Metin (ans, txt).

Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeye her zaman Google'ın dosya türüyle ilgili SSS sayfasından ulaşabilirsiniz.

Örnekler

Bu örnek, "Google"dan bahseden ancak PDF dokümanı olmayan dokümanları döndürür:
q=Google+%2Dfiletype%3Apdf

Bu örnek, "Google"dan bahseden ancak hem PDF hem de Word dokümanlarını hariç tutan dokümanları döndürür:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


Dosya Türü Filtreleme [ filetype: ]
Açıklama

filetype: sorgu terimi, arama sonuçlarını ".pdf" veya ".doc" gibi belirli bir dosya uzantısına sahip dokümanlarla kısıtlar. Arama sorgusu, filetype: sorgu terimi ile belirtilen uzantı arasında boşluk bırakılmadan filetype:EXTENSION olarak biçimlendirilmelidir.

filetype: öğesinin URL çıkışlı sürümü filetype%3A.

Sorgunuza daha fazla filetype: sorgu terimi ekleyerek arama sonuçlarını çeşitli dosya uzantılarından biriyle eşleşen dokümanlarla kısıtlayabilirsiniz. Arama sonuçlarına dahil edilmesi gereken her dosya uzantısı için arama sorgunuzda bir filetype: sorgu teriminiz olmalıdır. Birden çok filetype: sorgu terimi, OR sorgu terimi kullanılarak ayrılmalıdır.

Varsayılan olarak, arama sonuçları herhangi bir dosya uzantısına sahip dokümanları içerir.

Google tarafından desteklenen dosya türleri şunlardır:

  • Adobe Taşınabilir Belge Biçimi (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (hf1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • Mac yazma (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doküman)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Yazma (wri)
  • Zengin Metin Biçimi (rtf)
  • Şok Dalgası Flash (swf)
  • Metin (ans, txt).

Gelecekte başka dosya türleri de eklenebilir. Güncel bir listeye her zaman Google'ın dosya türüyle ilgili SSS sayfasından ulaşabilirsiniz.

Örnekler

Bu örnek, "Google"dan bahseden PDF dokümanlarını döndürür:
q=Google+filetype%3Apdf

Bu örnekte, "Google" geçen PDF ve Word dokümanları döndürülür:
q=Google+filetype%3Apdf+OR+filetype%3Adoc


Sorgu Terimini Dahil Et [+]
Açıklama

İçerme (+) sorgu terimi, bir kelime veya kelime öbeğinin arama sonuçlarında yer alan tüm dokümanlarda bulunması gerektiğini belirtir. Dahil et sorgu terimini kullanmak için tüm arama sonuçlarının önüne "+" (artı işareti) eklenmesi gereken kelime veya kelime öbeğinin önüne eklersiniz.

+ öğesinin URL çıkışlı sürümü (artı işareti) %2B'dir.

Google'ın normalde arama sonuçlarını tanımlamadan önce sildiği yaygın bir kelimeden önce + kullanmalısınız.

Örnekler Kullanıcı girişi: Star Wars Episode +I
Sorgu terimi: q=Star+Wars+Episode+%2BI

Yalnızca Bağlantılar Arama, tüm terimler [ allinlinks: ]
Açıklama

allinlinks: sorgu terimi, arama sonuçlarındaki dokümanların URL bağlantılarındaki arama sorgusundaki tüm kelimeleri içermesini gerektirir. Arama sorgusu, allinlinks: biçiminde olmalı ve ardından arama sorgunuzdaki kelimeleri içermelidir.

Arama sorgunuzda allinlinks: sorgu terimi bulunuyorsa Google; dokümanlardaki diğer metinleri, doküman başlıklarını ve her dokümanın URL'sini göz ardı ederek dokümanlardaki URL bağlantılarında yalnızca arama sorgunuzdaki kelimeleri kontrol eder. Doküman URL'sinin, dokümanda bulunan URL bağlantılarından farklı olduğunu unutmayın.

allinlinks: öğesinin URL çıkışlı sürümü allinlinks%3A.

Örnekler Kullanıcı girişi:allinlinks: Google search
Sorgu terimi:q=allinlinks%3A+Google+search

Kelime Öbeği Arama
Açıklama

İfade araması (") sorgu terimi, kelime öbeklerini tırnak içine alarak veya aralarına kısa çizgi koyarak tam ifadeleri aramanıza olanak tanır.

" öğesinin URL çıkışlı sürümü (tırnak işareti) %22.

Ünlü alıntılar veya özel isimler için arama yapıyorsanız kelime öbeği aramaları özellikle yararlıdır.

Sıralı arama göndermek için as_epq istek parametresini de kullanabilirsiniz.

Örnekler Kullanıcı girişi:"Abraham Lincoln"
Sorgu terimi: q=%22Abraham+Lincoln%22

Yalnızca Metin Arama, tüm terimler [allintext:]
Açıklama

allintext: sorgu terimi, arama sonuçlarındaki her bir dokümanın, arama sorgusundaki tüm kelimeleri dokümanın gövdesinde içermesini gerektirir. Sorgu, allintext: şeklinde biçimlendirilmiş olmalı ve ardından arama sorgunuzdaki kelimeleri içermelidir.

Arama sorgunuzda allintext: sorgu terimi bulunuyorsa Google bu dokümanlardaki, doküman başlıklarındaki ve doküman URL'lerindeki bağlantıları yoksayarak arama sorgunuzdaki kelimeler için yalnızca dokümanların gövde metninde arama yapar.

allintext: öğesinin URL çıkışlı sürümü allintext%3A.

Örnekler Bu örnekte, arama sonuçlarında yer alan tüm dokümanların gövdesinde "Google" ve "arama" kelimelerinin görünmesi gerektiğini belirtilmektedir:
Kullanıcı girişi:allintext:Google search
Sorgu terimi:q=allintext%3AGoogle+search

Başlık Arama, tek terim [intitle:]
Açıklama

intitle: sorgu terimi, arama sonuçlarını doküman başlığında belirli bir kelimeyi içeren dokümanlarla kısıtlar. Arama sorgusu, intitle: sorgu terimi ile sonraki kelime arasında boşluk bırakılmadan intitle:WORD şeklinde biçimlendirilmelidir.

Not: Bu tür her kelimenin önüne intitle: sorgu terimini ekleyerek belge başlığına eklenmesi gereken birden fazla kelime belirtebilirsiniz. Tüm sorgu kelimelerinin, arama sonuçlarında yer alan dokümanların başlıklarına eklenmesi gerektiğini belirtmek için allintitle: sorgu terimini de kullanabilirsiniz.

intitle: öğesinin URL çıkışlı sürümü intitle%3A.

Örnekler

Bu örnek, arama sonuçlarındaki tüm dokümanların başlıklarında "Google" kelimesinin görünmesi ve söz konusu dokümanların başlıklarında, URL'lerinde, bağlantılarında veya gövde metninde herhangi bir yerde "arama" kelimesinin görünmesi gerektiğini belirtir:
Kullanıcı girişi:intitle:Google search
Sorgu terimi:q=intitle%3AGoogle+search


Başlık Arama, tüm terimler [allintitle:]
Açıklama

allintitle: sorgu terimi, arama sonuçlarını doküman başlığında tüm sorgu kelimelerini içeren dokümanlarla kısıtlar. allintitle: sorgu terimini kullanmak için arama sorgunuzun başına "allintitle:" ifadesini ekleyin.

Not: Arama sorgusunun başına allintitle: konulması, arama sorgusundaki her kelimenin önüne intitle: konulmasına denktir.

allintitle: öğesinin URL çıkışlı sürümü allintitle%3A şeklindedir.

Örnekler

Bu örnek, arama sonuçlarındaki tüm dokümanların başlıklarında "Google" ve "arama" kelimelerinin görünmesi gerektiğini belirtir:
Kullanıcı girişi: allintitle: Google search
Sorgu terimi: q=allintitle%3A+Google+search


URL Arama, tek terim [inurl:]
Açıklama

inurl: sorgu terimi, arama sonuçlarını doküman URL'sinde belirli bir kelimeyi içeren dokümanlarla kısıtlar. Arama sorgusu, inurl: sorgu terimi ile sonraki kelime arasında boşluk bırakılmadan inurl:WORD şeklinde biçimlendirilmelidir.

inurl: sorgu terimi noktalama işaretlerini yok sayar ve yalnızca inurl: operatöründen sonraki ilk kelimeyi kullanır. Doküman URL'sine eklenmesi gereken birden fazla kelime belirtmek için bu tür her kelimenin önüne inurl: sorgu terimini ekleyebilirsiniz. Tüm sorgu kelimelerinin, arama sonuçlarında yer alan dokümanların URL'lerine eklenmesi gerektiğini belirtmek için allinurl: sorgu terimini de kullanabilirsiniz.

inurl: öğesinin URL çıkışlı sürümü inurl%3A.

Örnekler

Bu örnek, arama sonuçlarındaki tüm dokümanların URL'lerinde "Google" kelimesinin görünmesi ve söz konusu dokümanların başlıklarında, URL'lerinde, bağlantılarında veya gövde metninde herhangi bir yerde "arama" kelimesinin görünmesi gerektiğini belirtir:
Kullanıcı girişi: inurl:Google search
Sorgu terimi: q=inurl%3AGoogle+search


URL Arama, tüm terimler [allinurl:]
Açıklama

allinurl: sorgu terimi, arama sonuçlarını doküman URL'sindeki tüm sorgu kelimelerini içeren dokümanlarla kısıtlar. allinurl: sorgu terimini kullanmak için arama sorgunuzun başına allinurl: ifadesini ekleyin.

allinurl: sorgu terimi noktalama işaretlerini yok sayar. Bu nedenle, yalnızca kelimelerde çalışır, URL bileşenlerinde çalışmaz. Örneğin, allinurl: uk/scotland, sonuçları URL'lerinde "uk" ve "iskoçya" kelimelerini içeren dokümanlarla kısıtlar ancak bu iki kelimenin belirli bir sırada görünmelerini veya eğik çizgiyle ayrılmalarını gerektirmez.

allinurl: öğesinin URL çıkışlı sürümü allinurl%3A.

Örnekler

Bu örnekte, arama sonuçlarındaki tüm dokümanların URL'lerinde "Google" ve "arama" kelimelerinin görünmesi gerektiğini belirtilmektedir:
Kullanıcı girişi: allinurl: Google search
Sorgu terimi: q=allinurl%3A+Google+search



Web Belgesi Bilgileri [info:]
Açıklama

info: sorgu terimi, bir URL Google'ın arama dizininde yer aldığı sürece, söz konusu URL hakkında genel bilgileri getirir. Arama sorgusu, info: sorgu terimi ile URL arasında boşluk bırakılmadan info:URL olarak biçimlendirilmelidir.

info: öğesinin URL çıkışlı sürümü info%3A'dır.

Not: info: kullanırken başka bir sorgu terimi belirtemezsiniz.

Örnekler Kullanıcı girişi: info:www.google.com
Sorgu terimi: q=info%3Awww.google.com

Örnek Görsel Sorguları

Aşağıdaki örneklerde, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç Resim HTTP isteği gösterilmektedir. Farklı sorgu parametrelerinin tanımları bu belgenin Resim Sorgusu Parametresi Tanımları bölümlerinde sağlanmıştır.

Bu istekte .png dosya türündeki "maymun" (q=monkey) sorgu terimi için ilk 5 sonuç (start=0&num=5) istenir. Son olarak sorgu, üçü de gerekli olan client, output ve cx parametrelerinin değerlerini belirtir.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Görsel Arama Sorgu Parametreleri

as_filetype
Açıklama

Optional. Belirtilen türdeki görselleri döndürür. İzin verilen değerler: bmp, gif, png, jpg ve svg.

Örnekler q=google&as_filetype=png

imgsz
Açıklama

Optional. Belirtilen boyuttaki görselleri döndürür. Buradaki boyut şunlardan biri olabilir:

  • icon (küçük)
  • small|medium|large|xlarge (orta)
  • xxlarge (büyük)
  • huge (çok büyük)

Örnekler q=google&as_filetype=png&imgsz=icon

imgtype
Açıklama

Optional. Aşağıdakilerden biri olabilecek türdeki görselleri döndürür:

  • clipart (kli bölüm)
  • face (yüz)
  • lineart (doğrusal)
  • news (haberler)
  • photo (fotoğraf)

Örnekler q=google&as_filetype=png&imgtype=photo

Imp
Açıklama

Optional. Siyah beyaz, gri tonlamalı veya renkli resimleri döndürür:

  • mono (siyah beyaz)
  • gray (gri tonlamalı)
  • color (renk)

Örnekler q=google&as_filetype=png&imgc=gray

imgcolor
Açıklama

Optional. Belirli bir baskın rengin görsellerini döndürür:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Örnekler q=google&as_filetype=png&imgcolor=yellow

as_rights
Açıklama

Optional. Lisanslamaya dayalı filtreler. Desteklenen değerler şunlardır:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

Örnekler q=cats&as_filetype=png&as_rights=cc_attribute

İstek Sınırları

Aşağıdaki grafikte, Google'a gönderdiğiniz arama istekleriyle ilgili sınırlamalar listelenmiştir:

Bileşen Sınır Yorum
Arama isteği uzunluğu 2.048 bayt  
Sorgu terimlerinin sayısı 10 şu parametrelerdeki terimleri içerir: q, as_epq, as_eq, as_lq, as_oq, as_q
Sonuç sayısı 20 num parametresini 20'den büyük bir sayıya ayarlarsanız yalnızca 20 sonuç döndürülür. Daha fazla sonuç elde etmek için birden fazla istek göndermeniz ve her istekle birlikte start parametresinin değerini artırmanız gerekir.

Sorguları ve Sonuçları Uluslararasılaştırma Sunumu

Google WebSearch hizmeti, birden fazla dilde doküman aramanıza olanak tanır. HTTP isteğinizi yorumlamak ve XML yanıtınızı kodlamak için kullanılması gereken karakter kodlamasını belirtebilirsiniz (ie ve oe arama parametrelerini kullanarak). Ayrıca, sonuçları yalnızca belirli dillerde yazılmış dokümanları içerecek şekilde filtreleyebilirsiniz.

Aşağıdaki bölümlerde, birden fazla dilde arama yapmayla ilgili sorunlar ele alınmaktadır:

Karakter Kodlama

Sunucular, web sayfaları gibi verileri, tarayıcılar gibi kullanıcı aracılarına kodlanmış bayt dizisi olarak gönderir. Kullanıcı aracısı daha sonra baytların kodunu bir karakter dizisine dönüştürür. WebSearch hizmetine istek gönderirken hem arama sorgunuz hem de aldığınız XML yanıtı için kodlama şemalarını belirtebilirsiniz.

HTTP isteğinizdeki karakterlerin kodlama mekanizmasını belirtmek için ie istek parametresini kullanabilirsiniz. Google'ın XML yanıtınızı kodlamak için kullanması gereken kodlama şemasını belirtmek amacıyla oe parametresini de kullanabilirsiniz. ISO-8859-1 (veya latin1) dışında bir kodlama şeması kullanıyorsanız lütfen ie ve oe parametreleri için doğru değerleri belirttiğinizden emin olun.

Not: Birden fazla dilde arama işlevi sağlıyorsanız hem ie hem de oe parametreleri için utf8 (UTF-8) kodlama değerini kullanmanızı öneririz.

ie ve oe parametreleri için kullanabileceğiniz değerlerin tam listesi için lütfen Karakter Kodlama Şemaları ekine bakın.

Karakter kodlaması hakkında daha fazla genel bilgi için lütfen http://www.w3.org/TR/REC-html40/charset.html adresine bakın.

Arayüz Dilleri

Grafik arayüzünüzün dilini tanımlamak için hl istek parametresini kullanabilirsiniz. hl parametresi değeri, dil kısıtlaması (lr parametresi kullanılarak) açıkça belirtilmediğinde özellikle uluslararası sorgularda XML arama sonuçlarını etkileyebilir. Bu gibi durumlarda hl parametresi, kullanıcının giriş diliyle aynı dildeki arama sonuçlarını tanıtabilir.

Google'ın her sorgu için en yüksek kaliteli arama sonuçlarını seçmesini sağlamak amacıyla arama sonuçlarında hl parametresini açıkça ayarlamanızı öneririz.

hl parametresinin geçerli değerlerinin tam listesi için lütfen Desteklenen Arayüz Dilleri bölümüne bakın.

Belirli Dillerde Yazılmış Dokümanları Arama

Arama sonuçlarını belirli bir dilde veya dil kümesinde yazılmış dokümanlarla kısıtlamak için lr istek parametresini kullanabilirsiniz.

lr parametresi, arama sonuçlarına dahil edilmesi (veya hariç tutulması) gereken birden fazla dili belirtmenize olanak tanımak için Boole Operatörleri'ni destekler.

Aşağıdaki örneklerde, farklı dillerde doküman istemek için Boole Operatörlerini nasıl kullanabileceğiniz gösterilmektedir.

Japonca yazılmış dokümanlar için:

lr=lang_jp

İtalyanca veya Almanca yazılmış dokümanlar için:

lr=lang_it|lang_de

Macarca veya Çekçe yazılmamış dokümanlar için:

lr=(-lang_hu).(-lang_cs)

lr parametresinin olası değerlerinin tam listesi için lütfen Dil Toplama Değerleri bölümüne ve bu operatörlerin kullanımıyla ilgili kapsamlı bir açıklama için Boole Operatörleri bölümüne bakın.

Basitleştirilmiş Çince ve Geleneksel Çince, Çince'nin iki yazı varyantıdır. Aynı kavram her varyantta farklı şekilde yazılabilir. Varyantlardan birinde sorgu verildiğinde Google WebSearch hizmeti, her iki varyanttaki sayfaları da içeren sonuçlar döndürebilir.

Bu özelliği kullanmak için:

  1. c2coff istek parametresini 0 olarak ayarlayın
    ve
  2. Aşağıdakilerden birini yapın:
    • lr istek parametresini
      ayarlamayın veya
    • lr istek parametresini lr=lang_zh-TW|lang_zh-CN olarak ayarlayın

Aşağıdaki örnekte, hem basitleştirilmiş hem de geleneksel Çincedeki bir sonuç isteğine dahil edeceğiniz sorgu parametreleri gösterilmektedir. (İstemci gibi gerekli ek bilgilerin örnekte yer almadığını unutmayın.)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Sonuçları Filtreleme

Google WebSearch, arama sonuçlarınızı filtrelemek için çeşitli yöntemler sunar:

Arama Sonuçlarını Otomatik Filtreleme

Google, mümkün olan en iyi arama sonuçlarını sağlamak amacıyla, genellikle istenmediği kabul edilen arama sonuçlarını otomatik olarak filtrelemek için iki teknik kullanır:

  • Yinelenen İçerik: Birden fazla belgede aynı bilgiler varsa yalnızca en alakalı doküman arama sonuçlarınıza dahil edilir.

  • Ana Bilgisayar İzleyicisi—Aynı siteden çok sayıda arama sonucu varsa Google, o sitedeki tüm sonuçları göstermeyebilir veya
    sıralamada sonuçları normalde olduğundan daha düşük bir sıralamada gösterebilir.

Filtreler çoğu arama sonucunun kalitesini önemli ölçüde artırdığından, bu filtreleri tipik arama istekleri için açık bırakmanızı öneririz. Ancak arama isteğinizde filtre sorgu parametresini 0 olarak ayarlayarak bu otomatik filtreleri atlayabilirsiniz.

Dil ve Ülke Filtreleme

Google WebSearch hizmeti, tüm web dokümanlarının ana dizininden sonuçlar döndürür. Ana dizin, dil ve menşe ülke gibi belirli özelliklere göre gruplandırılmış dokümanlardan oluşan alt koleksiyonlar içerir.

Arama sonuçlarını sırasıyla belirli dillerde yazılmış veya belirli ülkelerden gelen doküman alt koleksiyonlarıyla kısıtlamak için lr ve cr istek parametrelerini kullanabilirsiniz.

Google WebSearch, dokümanda kullanılan dili belirlemek için aşağıdakileri analiz eder:

  • doküman URL'sinin üst düzey alanı (TLD)
  • dokümanın dil meta etiketleri
  • dokümanın gövde metninde kullanılan birincil dil


Sonuçları dile göre kısıtlama hakkında daha fazla bilgi edinmek için lütfen lr parametresinin tanımına, Belirli Dillerde Yazılmış Dokümanları Arama başlıklı bölüme ve lr parametresinin değerleri olarak kullanılabilen Dil Koleksiyonu Değerleri bölümüne de bakın.

Google WebSearch, bir dokümanın ülkesini belirlemek için aşağıdakileri analiz eder:

  • doküman URL'sinin üst düzey alanı (TLD)
  • Web sunucusunun IP adresinin coğrafi konumu

Sonuçları menşe ülkeye göre kısıtlama hakkında daha fazla bilgi için lütfen cr parametresinin tanımına ve cr parametresinin değeri olarak kullanılabilen Ülke Koleksiyon Değerleri bölümüne de bakın.

Not: Arama sonuçlarınızı özelleştirmek için dil ve ülke değerlerini birleştirebilirsiniz. Örneğin, Fransızca olarak yazılmış ve Fransa ya da Kanada'dan gelen belgeler ya da Hollanda'dan gelen ve İngilizce dilinde yazılmamış belgeler talep edebilirsiniz. lr ve cr parametrelerinin ikisi de Boole Operatörlerini destekler.

Yetişkinlere Uygun İçeriği Güvenli Arama ile Filtreleme

Birçok Google müşterisi, yetişkinlere uygun içerik barındıran siteler için arama sonuçları görüntülemek istememektedir. Güvenli Arama filtremizi kullanarak, yetişkinlere uygun içerik barındıran arama sonuçlarını filtreleyebilir ve hariç tutabilirsiniz. Google'ın filtreleri; anahtar kelimeleri, kelime öbeklerini ve URL'leri kontrol etmek için Google'a ait bir teknoloji kullanır. Hiçbir filtre %100 doğru olmasa da Güvenli Arama, yetişkinlere uygun içeriğin büyük çoğunluğunu arama sonuçlarınızdan kaldırır.

Google, Güvenli Arama'nın mümkün olduğunca güncel ve kapsamlı olmasını sağlamak için web'i sürekli olarak tarar ve kullanıcı önerilerinden güncellemeler ekler.

Güvenli Arama aşağıdaki dillerde kullanılabilir:

Felemenkçe
İngilizce
Fransızca
Almanca
İtalyanca
Portekizce (Brezilya)
İspanyolca
Geleneksel Çince

safe sorgu parametresini kullanarak Google'ın sonuçlarınızı yetişkinlere uygun içeriğe göre filtreleme düzeyini ayarlayabilirsiniz. Aşağıdaki tabloda, Google'ın Güvenli Arama ayarları ve bu ayarların arama sonuçlarınızı nasıl etkileyeceği açıklanmaktadır:

Güvenli Arama Düzeyi Açıklama
yüksek Güvenli aramanın daha katı bir sürümünü etkinleştirir.
medium Pornografi ve diğer uygunsuz cinsel içeriklerin bulunduğu web sayfalarını engeller.
kapalı Yetişkinlere uygun içerikleri arama sonuçlarından filtrelemez.

* Varsayılan Güvenli Arama ayarı kapalı konumdadır.

Güvenli Arama'yı etkinleştirdiyseniz ve sonuçlarınızda rahatsız edici içeriğe sahip siteler bulursanız, lütfen siteyi incelememiz için sitenin URL'sini safesearch@google.com adresine e-posta ile gönderin.

XML Sonuçları

Google XML Sonuçları DTD

Google, tüm arama sonucu türlerinde XML biçimini tanımlamak için aynı DTD'yi kullanır. Etiketlerin ve özelliklerin çoğu tüm arama türleri için geçerlidir. Ancak bazı etiketler yalnızca belirli arama türleri için geçerlidir. Sonuç olarak, DTD'deki tanımlar bu belgede belirtilen tanımlardan daha az kısıtlayıcı olabilir.

Bu dokümanda, DTD'nin WebSearch ile ilgili olan yönleri açıklanmaktadır. DTD'ye baktığınızda WebSearch üzerinde çalışıyorsanız burada belgelenmeyen etiketleri ve özellikleri güvenli bir şekilde yoksayabilirsiniz. DTD ve dokümanlarda farklı tanımlar varsa bu belgede bu durum belirtilmiştir.

Google, en son DTD'ye referans vererek veya belirtmeden XML sonuçlarını döndürebilir. DTD, arama yöneticilerinin ve XML ayrıştırıcıların Google'ın XML sonuçlarını anlamasına yardımcı olan bir rehberdir. Google'ın XML dil bilgisi zaman zaman değişebileceğinden, ayrıştırıcınızı her XML sonucunu doğrulamak için DTD'yi kullanacak şekilde yapılandırmamalısınız.

Ayrıca, XML ayrıştırıcınızı her arama isteği gönderdiğinizde DTD'yi getirecek şekilde yapılandırmamanız gerekir. Google, DTD'yi nadiren günceller ve bu istekler gereksiz gecikme ve bant genişliği gereksinimleri oluşturur.

Google, XML sonuçlarını almak için xml_no_dtd çıkış biçimini kullanmanızı önerir. Arama isteğinizde xml çıkış biçimini belirtirseniz tek fark aşağıdaki satırın XML sonuçlarına eklenmesi olur:

<!DOCTYPE GSP SYSTEM "google.dtd">

En son DTD'ye http://www.google.com/google.dtd adresinden erişebilirsiniz.

DTD'deki bazı özelliklerin şu an için kullanılamadığını veya desteklenmediğini lütfen unutmayın.

XML Yanıtı Hakkında

  • Tüm öğe değerleri, XML etiket tanımlarında aksi belirtilmedikçe görüntülenmeye uygun geçerli HTML'dir.
  • Bazı öğe değerleri, gösterilmeden önce HTML olarak kodlanması gereken URL'lerdir.
  • XML ayrıştırıcınız, belgelenmemiş öznitelik ve etiketleri yoksaymalıdır. Google, XML çıktısına daha fazla özellik eklerse bu, uygulamanızın değişiklik yapmadan çalışmaya devam etmesine olanak tanır.
  • Belirli karakterlere, XML etiketlerine değer olarak eklendiğinde çıkış karakteri eklenmelidir. XML işlemciniz, bu varlıkları tekrar uygun karakterlere dönüştürmelidir. Varlıkları düzgün bir şekilde dönüştürmezseniz tarayıcı örneğin & karakterini "&amp;" olarak oluşturabilir. XML Standardı bu karakterleri belgeler. Bu karakterler aşağıdaki tabloda yeniden oluşturulmuştur:

    Karakter Çıkış karakterli Formlar Varlık Karakter Kodu
    Ve işareti - &amp; &#38;
    Tek Tırnak İşareti ' &apos; &#39;
    Çift Tırnak İşareti " &quot; &#34;
    Büyüktür İşareti > &gt; &#62;
    Küçüktür İşareti < &lt; &#60;

Normal ve Gelişmiş Arama Sorguları İçin XML Sonuçları

Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu

Bu örnek WebSearch isteği, "socer" (q=socer) arama terimi hakkında 10 sonuç (num=10) ister. Bu, bu örnekte "soccer" kelimesi kasten yanlış yazılmıştır.)

http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i

Bu istek, aşağıdaki XML sonucunu verir. XML sonucunda, sonuca dahil edilmeyen belirli etiketlerin nerede görüneceğini belirten birkaç yorum bulunduğunu unutmayın.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>

Normal/Gelişmiş Arama: XML Etiketleri

Normal arama istekleri ve gelişmiş arama istekleri için XML yanıtları, aynı XML etiket grubunu kullanır. Bu XML etiketleri, yukarıdaki XML örneğinde gösterilmiş ve aşağıdaki tablolarda açıklanmıştır.

Aşağıdaki XML etiketleri, etiket adına göre alfabetik olarak listelenir ve her etiket tanımı, etiketin bir açıklamasını, etiketin bir XML sonucunda nasıl görüneceğini ve etiket içeriğinin biçimini gösteren bir örnek içerir. Etiket başka bir XML etiketinin alt etiketiyse veya etiketin kendi alt etiketleri ya da özellikleri varsa bu bilgiler, etiketin tanım tablosunda da sağlanır.

Aşağıdaki tanımlarda bazı alt etiketlerin yanında belirli semboller gösterilebilir. Bu semboller ve anlamları aşağıdaki gibidir:

? = isteğe bağlı alt etiket
* = alt etiketin sıfır veya daha fazla örneği
+ = alt etiketin bir veya daha fazla örneği
A B C G O T E S S A H Ü S R K T U X

anchor_text
Tanım

<anchor_text> etiketi, arama sonucu grubuyla ilişkili bir hassasiyet etiketini tanımlamak için kullanıcılara göstermeniz gereken metni belirtir. Ayrıntılandırma etiketleri alfanümerik olmayan karakterleri alt çizgilerle değiştirdiğinden, kullanıcı arayüzünüzde <label> etiketinin değerini görüntülememeniz gerekir. Bunun yerine, <anchor_text> etiketinin değerini görüntülemeniz gerekir.

Örnek <anchor_text>golf kursları</anchor_text>
Alt etiketi FacetItem
İçerik Biçimi Metin

ENGELLE
Tanım

Bu etiket, bir tanıtım sonucunun gövde satırındaki bir blokun içeriğini içerir. Her blokun T, U ve L alt etiketleri vardır. Boş olmayan T etiketi, bloğun metin içerdiğini, boş olmayan U ve L etiketleri ise bloğun bir bağlantı içerdiğini belirtir (URL U alt etiketinde ve bağlantı metni L alt etiketinde verilir).

Alt etiketler T, U, L
Alt etiketi BODY_LINE
İçerik Biçimi Boş

BODY_LINE
Tanım

Bu etiket, tanıtılan sonucun gövdesinde bir satırın içeriğini içerir. Her gövde satırı, bir metin veya URL ve bağlantı metni içeren bir bağlantı içeren birkaç ENGELLE etiketinden oluşur.

Alt etiketler ENGELLE*
Alt etiketi SL_MAIN
İçerik Biçimi Boş

C
Tanım

<C> etiketi, WebSearch hizmetinin bu arama sonucu URL'sinin önbelleğe alınmış bir sürümünü alabileceğini belirtir. Önbelleğe alınan sayfaları XML API aracılığıyla alamazsınız, ancak bu içerik için kullanıcıları www.google.com adresine yönlendirebilirsiniz.

Özellikler
Ad Biçim Açıklama
SZ Metin (Tamsayı + "k") Arama sonucunun önbelleğe alınan sürümünün boyutunu kilobayt ("k") olarak sağlar.
Müşteri Kimliği Metin Google'ın önbelleğindeki bir dokümanı tanımlar. Belgeyi önbellekten getirmek için aşağıdaki gibi bir arama terimi gönderin:
cache:CIDtext:escapeURL

Çıkış karakterli URL UE etiketinde bulunur.

Örnek <C SZ="6k" CID="kvOXK_cYSSgJ" />
Alt etiketi HAS
İçerik Biçimi Boş

C2C
Tanım <C2C> etiketi, sonucun Geleneksel Çince bir sayfaya ait olduğunu belirtir. Bu etiket yalnızca Basitleştirilmiş ve Geleneksel Çince Arama etkinleştirildiğinde görünür. Bu özelliği etkinleştirme ve devre dışı bırakma hakkında daha fazla bilgi için c2coff sorgu parametresinin tanımına bakın.
İçerik Biçimi Metin

İçerik
Tanım

<Context> etiketi, bir arama sonucu grubuyla ilişkilendirilmiş ayrıntılandırma etiketlerinin listesini içerir.

Örnek <Context>
Alt etiketler title, Façeta+
İçerik Biçimi Kapsayıcı

TARAMA TARİHİ
Tanım

<CRAWLDATE> etiketi, sayfanın en son tarandığı tarihi tanımlar. CRAWLDATE, her arama sonucu sayfası için döndürülmez.

Örnek <CRAWLDATE>21 Mayıs 2005</CRAWLDATE>
Alt etiketi R
İçerik Biçimi Metin

Kendi
Tanım

<DI> etiketi, tek bir arama sonucuyla ilgili Açık Dizin Projesi (ODP) kategori bilgilerini içerir.

Örnek <DI>
Alt etiketler DT?, DS'yi nasıl seçebilirsiniz?
Alt etiketi HAS
İçerik Biçimi Boş

DS
Tanım

<DS> etiketi, ODP dizininde tek bir kategori için listelenen özeti sağlar.

Örnek <DS>&lt;b&gt;futbol&lt;/b&gt; özgeçmişinizi doğrudan İnternet'te yayınlayın.</DS>
Alt etiketi Kendin Yap
İçerik Biçimi Metin (HTML içerebilir)

DT
Tanım

<DT> etiketi, ODP dizininde listelenen tek bir kategorinin başlığını sağlar.

Örnek <DT>SoccerConnection.net</DT>
Alt etiketi Kendin Yap
İçerik Biçimi Metin (HTML içerebilir)

Özellik
Tanım

<Facet> etiketi, <FacetItem> etiketlerinin mantıksal bir gruplandırmasını içerir. Bu gruplamaları Programlanabilir Arama Motoru XML Spesifikasyonu biçimini kullanarak oluşturabilirsiniz. Bu gruplamaları oluşturmazsanız results_xml_tag_Context><Bağlam> etiketi en fazla dört <Facet> etiketi içerir. Her bir <Facet> etiketi içindeki öğeler görüntüleme amacıyla gruplandırılır ancak mantıksal bir ilişkisi olmayabilir.

Örnek <Facet>
Alt etiketler FacetItem+, başlık+
Alt etiketi Bağlam
İçerik Biçimi Kapsayıcı

FacetItem
Tanım

<FacetItem> etiketi, bir arama sonucu grubuyla ilişkilendirilmiş bir ayrıntılandırma etiketiyle ilgili bilgileri içerir.

Örnek <FacetItem>
Alt etiketler label, anchor_text+
Alt etiketi Façeta
İçerik Biçimi FacetItem

FI
Tanım <FI> etiketi, arama için doküman filtrelemenin yapılıp yapılmadığını gösteren bir işaret işlevi görür. Google'ın arama sonucu filtreleri hakkında daha fazla bilgi için bu dokümanın Otomatik Filtreleme bölümüne bakın.
Örnek <FI />
Alt etiketi RES
İçerik Biçimi Boş

GST
Tanım

<GSP> etiketi, Google XML arama sonuçlarında döndürülen tüm verileri içerir. "GSP", "Google Search Protocol"ün kısaltmasıdır.

Özellikler
Ad Biçim Açıklama
VER Metin (Tamsayı) VER özelliği, arama sonuçları çıktısının sürümünü belirtir. Mevcut çıkış sürümü "3.2"dir.
Örnek <GSP VER="3,2">
Alt etiketler PARAM+, Q, RES?, ÇB
İçerik Biçimi Boş

HAS
Tanım <HAS> etiketi, belirli bir URL için desteklenen tüm özel arama isteği parametreleri ile ilgili bilgileri içerir.

Not: WebSearch için <HAS> tanımı, DTD'dekinden daha kısıtlayıcıdır.

Alt etiketler DI?, L?, C?, RT?
Alt etiketi R

ISURL
Tanım İlişkili arama sorgusu bir URL ise Google, <ISURL> etiketini döndürür.
Alt etiketi GSP
İçerik Biçimi Boş

L
Tanım <L> etiketinin varlığı, WebSearch hizmetinin bu arama sonucu URL'sine bağlantı veren diğer siteleri bulabileceğini belirtir. Bu tür siteleri bulmak için link: özel sorgu terimini kullanabilirsiniz.
Alt etiketi HAS
İçerik Biçimi Boş

etiket
Tanım

<label> etiketi, aldığınız arama sonuçlarını filtrelemek için kullanabileceğiniz bir ayrıntılandırma etiketi belirtir. Ayrıntılandırma etiketi kullanmak için Google'a gönderdiğiniz HTTP isteğindeki q parametresinin değerine more:[[label tag value]] dizesini aşağıdaki örnekte gösterildiği gibi ekleyin. Sorguyu Google'a göndermeden önce bu değerin URL çıkışlı olması gerektiğini lütfen unutmayın.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
q=Palm+Springs+more%3Agolf_courses

Not: <label> etiketi, arama sonuçlarınızdaki belirli bir URL ile ilişkilendirilmiş bir ayrıntılandırma etiketini tanımlayan <Label> etiketi ile aynı değildir.

Örnek <label>golf_kursları</label>
Alt etiketi FacetItem
İçerik Biçimi Metin

DİLÇ
Tanım

<LANG> etiketi, Google'ın arama sonucunun diline ilişkin en iyi tahminini içerir.

Örnek <LANG>en</LANG>
Alt etiketi R
İçerik Biçimi Metin

M
Tanım

<M> etiketi, arama için sonuçların tahmini toplam sayısını tanımlar.

Not: Bu tahmin doğru olmayabilir.

Örnek <M>16200000</M>
Alt etiketi RES
İçerik Biçimi Metin

YD
Tanım

<NB> etiketi, sonuç kümesine ait gezinme bilgilerini (arama sonuçlarının bir sonraki sayfasına veya arama sonuçlarının bir önceki sayfasına yönlendiren bağlantılar) içerir.

Not: Bu etiket yalnızca daha fazla sonuç varsa gösterilir.

Örnek <NB>
Alt etiketler NU?, PU kullanımı
Alt etiketi RES
İçerik Biçimi Boş

NU
Tanım

<NU> etiketi, arama sonuçlarının sonraki sayfasına giden göreli bir bağlantı içerir.

Örnek <NU>/search?q=flowers&num=10&hl=tr&ie=UTF-8
&output=xml&client=test&start=10</NU>
Alt etiketi YOK
İçerik Biçimi Metin (Göreli URL)

PARAM
Tanım

<PARAM> etiketi, XML sonucuyla ilişkili HTTP isteğinde gönderilen bir giriş parametresini tanımlar. Parametreyle ilgili bilgiler, ad, değer, orijinal_değer gibi etiket özelliklerinde yer alır ve HTTP isteğinde gönderilen her parametre için bir PARAM etiketi olur.

Özellikler
Ad Biçim Açıklama
name Metin Parametre adı girin.
value HTML Giriş parametresi değerinin HTML biçimli sürümü.
original_value Metin Giriş parametresi değerinin orijinal URL çıkışlı sürümü.
Örnek <PARAM name="cr" value="countryNZ" Original_value="countryNZ" />
Alt etiketi GSP
İçerik Biçimi Karışık

PU
Tanım

<PU> etiketi, arama sonuçlarının önceki sayfasına giden göreli bir bağlantı sağlar.

Örnek <PU>/search?q=flowers&num=10&hl=tr&output=xml
&client=test&start=10</PU>
Alt etiketi YOK
İçerik Biçimi Metin (Göreli URL)

SORU
Tanım

<Q> etiketi, XML sonucuyla ilişkili HTTP isteğinde gönderilen arama sorgusunu tanımlar.

Örnek

<Q>pizza</Q>

Alt etiketi GSP
İçerik Biçimi Metin

R
Tanım

<R> etiketi, tek bir arama sonucunun ayrıntılarını içerir.

Not: WebSearch için <R> etiketinin tanımı DTD'dekinden daha kısıtlayıcıdır.

Özellikler
Ad Biçim Açıklama
N Metin (Tam sayı) Bu arama sonucunun dizinini (1 tabanlı) gösterir.
MIME Metin Arama sonucunun MIME türünü belirtir.
Alt etiketler U, UE, T?, CRAWLDATE, S?, Türkçe?, HAS
Alt etiketi RES

RES
Tanım

<RES> etiketi, bağımsız arama sonuçları grubunu ve bu sonuçlarla ilgili ayrıntıları içerir.

Özellikler
Ad Biçim Açıklama
SN Metin (Tamsayı) Bu sonuç kümesinde döndürülen ilk arama sonucunun dizinini (1 tabanlı) belirtir.
TR Metin (Tamsayı) Bu sonuç kümesinde döndürülen son arama sonucunun dizinini (1 tabanlı) belirtir.
Örnek <RES SN="1" EN="10">
Alt etiketler M, FI?, XT?, NB?, R*
Alt etiketi GSP
İçerik Biçimi Boş

S
Tanım

<S> etiketi, sorgu terimlerini kalın karakterlerle vurgulanmış olarak gösteren bir arama sonucu alıntısını içerir. Metnin doğru şekilde kaydırılması için alıntıya satır sonları dahil edilir.

Örnek <S>Washington (CNN) -- Senato'nun Başkan'a karşı &lt;b&gt;Bush&#39;s&lt;/b&gt; adli seçimlerini sonlandırma teklifi
Alt etiketi R
İçerik Biçimi Metin (HTML)

SL_MAIN
Tanım

Bu etiket, bir tanıtım sonucunun içeriğini kapsar. Promosyonları ayrıştırmak için kullanın. Başlık bağlantısının bağlantı metni ve URL'si sırasıyla T ve U alt etiketlerinde bulunur. Gövde metninin satırları ve bağlantılar BODY_LINE alt etiketlerinde bulunur.

Alt etiketler BODY_LINE*, T, U
Alt etiketi SL_RESULTS
İçerik Biçimi Boş

SL_RESULTS
Tanım

Tanıtılan sonuçlar için kapsayıcı etiket. Arama sonuçlarınızda bir tanıtım olduğunda bunlardan biri görünür. SL_MAIN alt etiketi, ana sonuç verilerini içerir.

Alt etiketler SL_MAIN*
Alt etiketi R
İçerik Biçimi Boş

Yazım
Tanım

<Spelling> etiketi, gönderilen sorgu için alternatif bir yazım önerisi içerir. Bu etiket yalnızca arama sonuçlarının ilk sayfasında görünür. Yazım önerileri İngilizce, Çince, Japonca ve Korece dillerinde kullanılabilir.

Not: Google, yalnızca gl parametre değerinin küçük harfle olduğu sorgular için yazım önerileri döndürür.

Örnek <Spelling>
Alt etiketler Öneri
Alt etiketi GSP
İçerik Biçimi Boş

Öneri
Tanım <Suggestion> etiketi, gönderilen sorgu için alternatif bir yazım önerisi içerir. Arama yapan kullanıcıya alternatif yazımı önermek için etiketin içeriğini kullanabilirsiniz. q özelliğinin değeri, sorgu terimi olarak kullanabileceğiniz URL çıkış karakterli yazım önerisidir.
Özellikler
Ad Biçim Açıklama
q Metin q özelliği, yazım önerisinin URL çıkışlı sürümünü belirtir.
Örnek <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;futbol&lt;/i&gt;&lt;/b&gt;</Suggestion>
Alt etiketi Yazım
İçerik Biçimi Metin (HTML)

T
Tanım <T> etiketi, sonucun başlığını içerir.
Örnek <T>Amici'nin Doğu Kıyısı Pizzacısı</T>
Alt etiketi R
İçerik Biçimi Metin (HTML)

başlık
Tanım

<Context> alt öğesi olan <title> etiketi, Programlanabilir Arama Motorunuzun adını içerir.

<Facet> alt öğesi olan <title> etiketi, bir özellik grubu için başlık sağlar.

Örnek

<Context> alt öğesi olarak: <title>Arama Motorum</title>

<Facet> alt öğesi olarak: <title>facet title</title>

Alt etiketi Bağlam, Facet
İçerik Biçimi Metin

TM
Tanım

<TM> etiketi, arama sonuçlarını döndürmek için gereken toplam sunucu süresini saniye cinsinden tanımlar.

Örnek <TM>0,100445</TM>
Alt etiketi GSP
İçerik Biçimi Metin (Kayan noktalı sayı)

TT
Tanım <TT> etiketi bir arama ipucu sağlar.
Örnek <TT>&lt;i&gt;İpucu: Çoğu tarayıcıda Return tuşuna basmak Ara düğmesini tıklamakla aynı sonuçları üretir.&lt;/i&gt;</TT>
Alt etiketi GSP

U
Tanım <U> etiketi, arama sonucunun URL'sini sağlar.
Örnek <U>http://www.dominos.com/</U>
Alt etiketi R
İçerik Biçimi Metin (Mutlak URL)

UD
Tanım

<UD> etiketi, arama sonucu için IDN kodlu (Uluslararası Alan Adı) URL'sini sağlar. Bu değer, alan adlarının yerel diller kullanılarak görüntülenmesine olanak tanır. Örneğin, IDN kodlamalı URL'nin http://www.%E8%8A%B1%E4%BA%95.com kodu çözülebilir ve http://www.花高鮨.com olarak görüntülenebilir. Bu <UD> etiketi, yalnızca ud parametresini içeren istekler için arama sonuçlarına dahil edilir.

Not: Bu bir beta özelliktir.

Örnek <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
Alt etiketi R
İçerik Biçimi Metin (IDN kodlamalı URL)

UE
Tanım <UE> etiketi, arama sonucunun URL'sini sağlar. Değer, URL çıkışlı olduğundan bir URL'de sorgu parametresi olarak geçirilmeye uygundur.
Örnek <UE>http://www.dominos.com/</UE>
Alt etiketi R
İçerik Biçimi Metin (URL çıkışlı URL)

XT
Tanım <XT> etiketi, M etiketiyle belirtildiği gibi tahmini toplam sonuç sayısının aslında tam toplam sonuç sayısını temsil ettiğini belirtir. Daha fazla bilgi için bu dokümanın Otomatik Filtreleme bölümüne bakın.
Örnek <XT />
Alt etiketi RES
İçerik Biçimi Boş


Görsel Arama Sorguları İçin XML Sonuçları

Bu örnek Resim isteğinde, "maymun" (q=maymun) arama terimi hakkında 5 sonuç (num=5) istenir.

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Bu istek, aşağıdaki XML sonucunu verir.


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

Görsel Arama: XML Etiketleri

Aşağıdaki tabloda, görsel arama sorguları için XML yanıtlarında kullanılan diğer XML etiketleri gösterilmektedir.

Aşağıdaki tanımlarda bazı alt etiketlerin yanında belirli semboller gösterilebilir. Bu semboller ve anlamları aşağıdaki gibidir:

? = isteğe bağlı alt etiket
* = alt etiketin sıfır veya daha fazla örneği
+ = alt etiketin bir veya daha fazla örneği

RG
Tanım

<RG> etiketi, tek bir görsel arama sonucunun ayrıntılarını içerir.

Özellikler
Ad Biçim Açıklama
N Metin (Tamsayı) Bu arama sonucunun dizinini (1 tabanlı) gösterir.
MIME Metin Arama sonucunun MIME türünü belirtir.
Alt etiketi RES
RU
Tanım

<RU tag> etiketi, her görsel arama sonucunun ayrıntılarını içerir.

Alt etiketi R