XML API referansı

Bu sayfa, Custom Search JSON API'nin yalnızca Google Site Search müşterileri.

  1. Genel Bakış
  2. Programlanabilir Arama Motoru İstek Biçimi
    1. İsteğe Genel Bakış
    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 Resim Sorguları
      7. Görsel Arama Sorgu Parametreleri
      8. İstek Sınırları
    4. Sorguları ve Sonuçları Uluslararasılaştırma Sunumu
      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 İçeriği Güvenli Arama ile Filtreleme
  3. XML Sonuçları
    1. Google XML Sonuçları DTD
    2. XML Yanıtı hakkında
    3. Normal, Resim ve XML için XML Sonuçları Gelişmiş Arama Sorguları
      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'ü etkinleştirir müşterilerin Google arama sonuçlarını kendi web sitelerinde görüntülemelerine olanak tanır. İlgili içeriği oluşturmak için kullanılan WebSearch hizmeti, arama sonuçları göstermek için HTTP tabanlı basit bir protokol kullanır sonuç. Arama yöneticilerinin, oluşturma ve satın alma işlemlerini arama sonuçlarını isteyebilir ve bu sonuçları kullanıcılara nasıl yardımcı olur. Bu belgede, Google Cloud Yardım Merkezi'nin arama isteği ve sonuç biçimlerinden bahsedeceğiz.

Uygulamanız, Google WebSearch sonuçlarını almak için Google'a basit bir HTTP isteği gönderebilirsiniz. Google daha sonra arama sonuçlarını XML olarak döndürür. biçimindedir. XML biçimli sonuçlar size, kendi görünümünü kullanarak arama sonuçlarının görüntülenme şekli.

WebSearch İstek Biçimi

İsteğe Genel Bakış

Google arama isteği standart bir HTTP GET komutudur. Google işletmenizle alakalı parametre koleksiyonunu içerir daha fazla bilgi edineceksiniz. Bu parametreler istek URL'sine name=value olarak eklenir çiftler (ve) (&) karakterleriyle ayrılır. Parametreler şunları içerir: benzersiz bir arama motoru kimliği (cx) gibi veriler HTTP isteğinde bulunan arama motorunu tanımlar. WebSearch veya Görsel Arama hizmeti XML, HTTP isteklerinize yanıt olarak ortaya çıkar.

Sorgu Terimleri

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

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

  • Eklenecek kelimeler veya kelime öbekleri hariç tut
    • Bir arama sorgusundaki tüm kelimeler (varsayılan)
    • Arama sorgusundaki tam bir kelime öbeği
    • Arama sorgusundaki herhangi bir kelime veya kelime öbeği
  • Dokümanın neresinde? arama terimleri
    • 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 URL'sinde
    • Yalnızca dokümandaki bağlantılarda
  • Belgelerle ilgili kısıtlamalar
    • Belirli dosya türlerindeki dokümanları dahil etme veya hariç tutma (ör. PDF dosyaları veya Word dokümanları)
  • Döndürülen özel URL sorguları aramak yerine belirli bir URL hakkında bilgi
    • Bir URL hakkında genel bilgiler döndüren sorgular, örneğin Open Directory kategorisi, snippet'i veya dili
    • Bir URL'ye bağlantı veren web sayfaları grubunu döndüren sorgular
    • Belirli bir URL'ye benzer web sayfaları grubunu döndüren sorgular

Varsayılan Arama

Arama sorgusu parametre değerleri URL çıkışlı olmalıdır. Lütfen karakteri, anlamına gelir. Bu konu, bu dokümanın URL Çıkışı bölümünde daha ayrıntılı bir şekilde ele alınmaktadır.

Arama sorgusu terimi WebSearch hizmetine q parametresiyle aynı olmalıdır. CEVAP örnek arama sorgusu terimi:

q=horses+cows+pigs

Varsayılan olarak, Google WebSearch hizmeti yalnızca arama sorgusuna dahil etmektir.

İstek Parametreleri

Bu bölümde, yeni bir URL oluştururken kullanabileceğiniz arama isteği. Parametreler iki listeye ayrılır. İlk liste, tüm arama istekleriyle alakalı parametreleri içerir. İkinci liste, şunlardır: yalnızca gelişmiş arama istekleriyle alakalı olmalıdır.

Üç istek parametresi gereklidir:

  • client parametresi google-csbe olarak ayarlanmalıdır
  • Çıkış parametresi döndürülen XML sonuçlarının biçimini; sonuç (xml) ile döndürülebilir veya Google'ın DTD'si (xml_no_dtd) referansı olmadan. Önerilerimiz: bu değer xml_no_dtd olarak ayarlanıyor. Not: Bu parametreyi belirtmezseniz sonuçlar XML yerine HTML kullanın.
  • Benzersiz Search Ads 360'ı temsil eden cx parametresi Motorun kimliği.

Bunlar dışında en sık kullanılan istek parametreleri Yukarıda bahsedilenler:

  • num: İstenen arama sonucu sayısı
  • q: arama terimleri
  • start: Sonuçlar için başlangıç dizini

Örnek WebSearch Sorguları

Aşağıdaki örneklerde, Search Ads 360'ta bulunan farklı sorgu parametrelerinin nasıl kullanıldığını gösterir. Tanımlar WebSearch Sorgusu"nda farklı sorgu parametreleri sunulur. Parametre Tanımları ve Gelişmiş Arama Sorgusu Parametreler bölümleri.

Bu istekte ilk 10 sonuç isteniyor (start=0&num=10) "red sox" sorgu terimi (q=red+sox). Sorgu ayrıca sonuçların Kanada web sitelerinden (cr=countryCA) gelmesi gerektiğini belirtir Fransızca (lr=lang_fr) dilinde yazılmalıdır. Son olarak, istemci, çıkış ve ve cx parametrelerinden üçü de gereklidir.

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, Google tarafından sağlanan gelişmiş arama sorgularından parametrelerini kullanın. Bu istekte as_q kullanılıyor parametresini (as_q=red+sox) kullanarak q parametresini kullanmanız gerekir. Ayrıca "Yankees" kelimesini içeren dokümanları hariç tutmak için as_eq parametresini kullanın şuradan arama sonuçları (as_eq=yankees).

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

İsteğe bağlı. c2coff parametresi, Basitleştirilmiş Basitleştirilmiş ve Geleneksel Çince Arama özelliğini destekler.

Bu parametre için varsayılan değer 0 (sıfır) şeklindedir. çok fazla zaman harcıyor. 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

İsteğe bağlı. cr parametresi, arama sonuçlarını görebilirsiniz. Boole değerini kullanabilirsiniz cr parametresindeki değer.

Google WebSearch, bir dokümanın ülkesini şu kriterlere göre belirler: analiz:

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

Bkz. Ülke (cr) Parametresi Değerler bölümüne gidin.

Örnekler q=Frodo&cr=countryNZ

tb
Açıklama

Zorunludur. cx parametresi, özel bir promosyon kodu arama motoru. Söz konusu motordan arama sonuçları almak için cx parametresini kullanarak bir Programlanabilir Arama Motoru belirtmeniz gerekir.
.
. cx parametresinin değerini bulmak için Kontrol Paneli > Kodlar sekmesinde bulabilirsiniz. 'Bu kodu sayfada arama kutunuzun görünmesini istediğiniz yere yapıştırın görünür. Arama sonuçları Google tarafından barındırılan bir sayfada gösterilir."

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

filtrele
Açıklama

İsteğe bağlı. filter parametresi etkinleştiğinde veya Google arama sonuçlarının otomatik olarak filtrelenmesini devre dışı bırakır. Bu filtrenin Otomatik Filtreleme bölümüne bakın. belgesine bakabilirsiniz.

filter parametresi için varsayılan değer 1 şeklindedir. Bu, özelliğin etkin olduğunu gösterir. Bunun için geçerli değerler parametreleri şunlardır:

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

Not: Varsayılan olarak, Google filtrelemeyi tüm arama sonuçlarını kullanarak bu sonuçların kalitesini artırır.

Örnekler q=google&filter=0

gl
Açıklama

İsteğe bağlı. gl parametre değeri iki harfli ülke kodundan oluşur. WebSearch sonuçları için gl parametresi, menşe ülkesi parametre değeri. Geçerli değerlerin bir listesi için Ülke Kodları bölümüne bakın.

WebSearch isteklerinde gl parametre değeri belirtme sonuçların alaka düzeyini artırmanız gerekir. Bu, özellikle müşterilerimiz için, daha da özel olarak ABD dışındaki İngilizce konuşulan ülkelerdeki müşteriler için geçerlidir.

Örnekler

Bu istek, Birleşik Krallık'ta şu dilde yazılmış dokümanları geliştirir: WebSearch sonuçları:
q=pizza&gl=uk


hl
Açıklama

İsteğe bağlı. hl parametresi Kullanıcı arayüzünüzün arayüz dili (ana makine dili). İyileştirmek için arama sonuçlarınızın performansını ve kalitesini bu parametrenin açık bir şekilde ayarlanması kesinlikle önerilir.

Sorguları Uluslararasılaştırma'nın Arayüz Dilleri bölümüne bakın daha fazla bilgi ve Desteklenen Arayüz Dilleri için .

Örnekler

Bu istek, Fransızca şarap reklamlarını hedeflemektedir. (Vin Fransızca şarap anlamına gelen bir terim.)

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

hq
Açıklama

İsteğe bağlı. hq parametresi, belirtilen sorgu terimlerini mantıksal bir AND operatörüyle birleştirilmiş gibi görürsünüz.

Örnekler

Bu istek "pizza" için arama yapar VE "peynir". İfade, q=pizza+cheese ile aynı.

q=pizza&hq=cheese


ie
Açıklama

İsteğe bağlı. ie parametresi, karakteri ayarlar sorgu dizesini yorumlamak için kullanılması gereken kodlama şemasını seçin. İlgili içeriği oluşturmak için kullanılan varsayılan ie değeri latin1.

Bu parametreyi ne zaman kullanmanız gerekebileceğiyle ilgili açıklama için Karakter Kodlama bölümüne bakın.

Bkz. Karakter Kodlama Olası ie değerlerin listesine ilişkin şemalar bölümü.

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

İsteğe bağlı. lr (dil kısıtlama) parametresi, arama sonuçlarını dokümanlarla kısıtlar otomatik olarak oluşturulur.

Google WebSearch, bir dokümanın dilini şu kriterlere göre belirler: analiz:

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

Dil (lr) sayfasını inceleyin. Koleksiyon Değerleri bölümündeki geçerli değerlerin listesini inceleyin. parametresinden sonra bir değer girin.

Örnekler q=Frodo&lr=lang_en

numara
Açıklama

İsteğe bağlı. num parametresi döndürülecek arama sonucu sayısı.

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

Not: Arama sonuçlarının toplam sayısı daha azsa istenen sayıda sonuçtan daha fazla sayıda sonuç verirse mevcut arama sonuçlarının tamamı iade edilir.

Örnekler q=google&num=10

Oe
Açıklama

İsteğe bağlı. oe parametresi, karakteri ayarlar XML sonucunun kodunu çözmek için kullanılması gereken kodlama şeması. İlgili içeriği oluşturmak için kullanılan varsayılan oe değeri latin1.

Bu parametreyi ne zaman kullanmanız gerekebileceğiyle ilgili açıklama için Karakter Kodlama bölümüne bakın.

Bkz. Karakter Kodlama Olası oe değerlerin listesine ilişkin şemalar bölümü.

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

çıkış
Açıklama

Zorunludur. output parametresi, XML sonuçlarının biçimini belirtir. Tek geçerli xml ve xml_no_dtd değerleridir. İlgili içeriği oluşturmak için kullanılan bu parametre değerlerinin farkını aşağıdaki grafikte görebilirsiniz.

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

q
Açıklama

İsteğe bağlı. q parametresi, tarafından girilen bir sorgudur. Bu parametre isteğe bağlı olsa da, sorgu parametrelerinden (as_epq, as_lq, as_oq, as_q) en az biri için bir değer belirtmelidir arama sonuçlarını görürsünüz.

Eklenebilecek bir dizi özel sorgu terimi q parametresinin bir parçası olarak kullanılır değer. Bu terimlerin listesi ve tanımları için lütfen Özel Sorgu Terimleri bölümüne bakın.

Google Arama Kontrol Paneli, q parametresi kullanılarak gönderilen sorguların sayısı.

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

İsteğe bağlı. safe parametresi, arama sonuçlarının yetişkinlere uygun ve pornografik içerik. safe parametresi için varsayılan değer off. 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ştir

Bkz. Yetişkinlere Uygun İçeriği Filtreleme bölümüne bakın.

Örnekler q=adult&safe=high

start
Açıklama

İsteğe bağlı. start parametresi, eklenmesi gereken ilk eşleşen sonucu gösterir gösterir. start parametresi sıfır tabanlı bir dizin kullanır. Yani ilk sonuç 0'dır. ikinci sonuç 1'dir ve bu şekilde devam eder.

start parametresi işlevini belirlemek için num parametresiyle hangi arama sonuçlarının döndürüleceğini belirler. Sorguyla 1.000'den fazla belge eşleşse bile herhangi bir sorgu için en fazla 1.000 sonuç döndürüleceğini unutmayın. Bu nedenle, 1000 veya daha yüksek bir değer ayarlamak sonuç vermez.

Örnekler start=10

sıralama
Açıklama

İsteğe bağlı. sort parametresi, sonuçların belirtilen ifadeye göre sıralanacağını belirtir. Örneğin, tarihe göre sırala.

Örnekler

sort=date


ud
Açıklama

İsteğe bağlı. ud parametresi, XML yanıtının, arama sonucu için IDN kodlamalı URL'yi içerip içermediğini kontrol edin. IDN (Uluslararası Alan Adı) kodlaması, alan adlarının yerel kod dil, örneğin:

http://www.花井鮨.com

Bu parametre için geçerli değerler 1 (varsayılan) değeridir. XML sonucu IDN kodlu URL'leri ve 0 (XML sonucunun IDN kodlu olmaması gerektiği anlamına gelir) URL'ler. ud parametresi 1 değerine ayarlanırsa IDN kodlamalı URL XML sonuçlarınızdaki UD etiketidir.

ud parametresi 0 olarak ayarlanırsa yukarıdaki örnekte bulunan URL şöyle olur: görüntülenme şekli:

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

Not: Bu bir beta özelliğidir.

Örnekler q=google&ud=1

Resmin altında listelenen ek sorgu parametreleri, gelişmiş arama sorgularıyla ilgilidir. Gelişmiş arama gönderdiğinizde, çeşitli parametrelerin değerleri (ör. as_eq, as_epq, as_oq vb.) sorguda dikkate alınır anlamına gelir. Resimde, Google'ın Gelişmiş Arama sayfası gösterilmektedir. Resimde, her birinin adı gelişmiş arama parametresi içine veya yanına kırmızı metin yazılır sayfada bu parametreye karşılık gelen alana girin.



Gelişmiş Arama Sorgusu Parametreleri

as_dt
Açıklama

İsteğe bağlı. as_dt parametresi, as_sitesearch parametresinde adı geçen siteden sonuçları dahil etme veya hariç tutma. İlgili içeriği oluşturmak için kullanılan 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

İsteğe bağlı. as_epq parametresi bir arama sonuçlarındaki tüm dokümanların içermesi gereken kelime öbeğidir. Şunları yapabilirsiniz: kelime öbeği arama sorgu terimini bir ifade arayın.

Örnekler as_epq=abraham+lincoln

as_eq
Açıklama

İsteğe bağlı. as_eq parametresi bir kelimeyi tanımlar aramada hiçbir dokümanda görünmemesi gereken sonuç. Ayrıca, hariç tutma sorgusunu da kullanabilirsiniz. görünmesini sağlamak için, belirli bir kelime veya kelime öbeğinin arama sonuçlarında yer alır.

Örnekler

q=bass&as_eq=music.


as_lq
Açıklama

İsteğe bağlı. as_lq parametresi, Tüm arama sonuçları belirli bir URL'ye giden bir bağlantı içermelidir. Ayrıca transkriptinizi bu sorgu türü için link: sorgu terimini kullanın.

Örnekler

as_lq=www.google.com


as_nlo
Açıklama

İsteğe bağlı. as_nlo parametresi, kullanabilirsiniz. Kapsayıcı bir arama eklemek için as_nlo ve as_nhi öğelerini kullanın as_nlo...as_nhi aralığıdır.

Örnekler

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

as_nlo=5&as_nhi=10

as_nhi
Açıklama

İsteğe bağlı. as_nhi parametresi bir arama aralığının bitiş değeri. as_nlo ve as_nhi kullanarak as_nlo...as_nhi dahil olmak üzere toplam arama aralığını seçin.

Örnekler

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

as_nlo=5&as_nhi=10

as_oq
Açıklama

İsteğe bağlı. as_oq parametresi, bir dokümanda kontrol edilecek ek arama terimi ek anlamına gelir. Şu veriler için de Boole VEYA sorgu terimini kullanabilirsiniz: izin verilmez.

Örnekler

q=vacation&as_oq=London+Paris


as_q
Açıklama

İsteğe bağlı. as_q parametresi, terimleri var. Bu parametre ayrıca yaygın olarak kullanılır kullanıcıların belirli bir küme içinde aramak için ek terimler belirtmesine olanak sağlamak yardımcı olabilir.

Örnekler

q=president&as_q=John+Adams


as_qdr
Açıklama

İsteğe bağlı. as_qdr parametresi, belirli bir döneme ait (hızlı tarih aralığı) sonuçları Aşağıdaki değerler desteklenir:

d[number], belirtilen sayıda son gün için sonuç istiyor.
. Belirtilen sayıda geçmiş haftadan w[number] istek sonucu.
. m[number] son ay için belirtilen sayıda sonuç isteği.
. y[number], belirtilen sayıda geçmiş yıl için sonuç istiyor.

Örnekler

Bu örnekte, geçen yıla ait sonuçlar istenmiştir:

as_qdr=y

Bu örnekte son 10 güne ait sonuçlar istenmiştir:

as_qdr=d10

as_sitesearch
Açıklama

İsteğe bağlı. as_sitesearch parametresi, tüm arama sonuçlarının belirli bir siteden sayfalar olması gerektiğini belirtmenize olanak tanır. as_dt parametresini ayarlayarak, belirli bir sitedeki sayfaları arama sorgularınızdan hariç tutmak için de kullanabilirsiniz.

Örnekler

q=vacation&as_sitesearch=www.google.com


Özel Sorgu Terimleri

Google WebSearch, bir arama sorgusunun kendisi tarafından Google arama motorunun ek özelliklerine erişme. Bu özel sorgu terimleri, q istek parametresinin değerine dahil edilmelidir. Diğer sorgu terimlerinde olduğu gibi, özel sorgu terimleri URL çıkışlı olmalıdır. CEVAP sayısı iki nokta üst üste (:) içeren özel sorgu terimleridir. Bu karakter URL çıkışlı da olmalıdır; URL çıkışlı değeri %3A şeklindedir.

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

link: sorgu terimi, Web sayfaları grubunu alır belirli bir URL'ye yönlendiren bağlantılar içerir. 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.

as_lq isteğini de kullanabilirsiniz. parametresini kullanabilirsiniz.link:

Not: Aşağıdaki durumlarda başka sorgu terimi belirtemezsiniz. link: kullanılıyor.

Örnekler

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


Boole VEYA Arama [ VEYA ]
Açıklama

OR sorgu terimi, şunları içeren dokümanları getirir: (iki veya daha fazla) sorgu terimi dizisinden oluşur. OR sorgusunu kullanmak için terimi, OR arama terimini büyük harfle eklerdiniz dizideki her terimin arasına eklemeniz gerekir.

as_oq isteğini de kullanabilirsiniz. parametresini kullanabilirsiniz.

Not: Bir arama isteği "Londra+OR+Paris" sorgusunu belirtirse arama sonuçları veya belgelenmiş metinlerden en az birini içeren belgelerdir. Bazı durumlarda, , arama sonuçlarındaki dokümanlar her iki kelimeyi de içerebilir.

Örnekler

Londra veya Paris için arama yapın:

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

Tatil için arama yapın ve Londra ya da Paris'ten birini arayın:

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

Tatil için arama yapın ve Londra, Paris veya çikolatalardan birini arayın:

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

Tatil ve çikolata, londra veya paris için arama yapın, en düşük ağırlığa sahip çikolata:

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

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

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

Tatil ve Londra ya da Paris'i arayın ve bir çiçek aranjmanı alın:

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

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

Hariç tut (-) sorgu terimi, bir arama sorgusu içermeyen dokümanlar için kelime veya kelime öbeğini ayarlamanızı sağlar. Hariç tutma sorgu terimini kullanmak için eşleşen dokümanlardan hariç tutulacak kelime veya kelime öbeğinin önüne ekle "-" içeren (eksi işareti).

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

Hariç tut sorgu terimi, bir arama terimi daha fazla birden fazla anlam ifade eder. Örneğin, "bas" kelimesi sonuç döndürebilir aklınıza gelebilecek her şey bütçeleniyor. Proje yönetimiyle ilgili belgeleri aradıysanız hariç, müzikle ilgili dokümanları arama sonuçlarınızdan hariç tutabilirsiniz kullanabilirsiniz.

as_eq isteğini de kullanabilirsiniz parametresi belirli bir kelime veya kelime öbeğiyle eşleşen dokümanları hariç tutar bazı işaretler bulabilirsiniz.

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

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

-filetype: sorgu terimi, ".pdf" gibi belirli bir dosya uzantısı veya ".doc" aramadan sonuç. Arama sorgusu -filetype:EXTENSION biçiminde olmalı ve -filetype: sorgu terimi ile belirtilen uzantı.

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

Not: Birden fazla hariç tutabilirsiniz daha fazla -filetype: sorgusu ekleyerek arama sonuçlarından dosya türlerini terimleri ekleyin. Bir -filetype: sorgu teriminiz olmalıdır arama sorgunuza eklemeniz gereken her bir dosya uzantısı için daha fazla bilgi edinebilirsiniz.

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

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

Gelecekte başka dosya türleri eklenebilir. Güncel listesi, Google'ın dosya türüyle ilgili SSS bölümünde dilediğiniz zaman bulunabilir.

Örnekler

Bu örnek, "Google"dan bahseden dokümanları döndürür. ama bu PDF dokümanı değil:
q=Google+%2Dfiletype%3Apdf

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


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

filetype: sorgu terimi, arama sonuçlarını ".pdf" gibi belirli bir dosya uzantısına sahip dokümanlar veya ".doc" yazın. Arama sorgusu, filetype:EXTENSION şeklinde biçimlendirilmelidir ve filetype: sorgu terimi ile belirtilen uzantısına sahip olur.

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

Aramayı kısıtlayabilirsiniz birkaç dosya uzantısından biriyle eşleşen dokümanlara sonuç filetype: sorgu terimi daha ekleyin. Arama sonuçlarına eklenmesi gereken her bir dosya uzantısı için arama sorgunuzda bir filetype: sorgu terimi olmalıdır. Birden fazla 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 ekleyin.

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

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

Gelecekte başka dosya türleri eklenebilir. Güncel listesi, Google'ın dosya türüyle ilgili SSS bölümünde dilediğiniz zaman bulunabilir.

Örnekler

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

Bu örnek, "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc


Sorgu Terimini Dahil Et [+]
Açıklama

Dahil etme (+) sorgu terimi, bir kelimenin veya kelime öbeğinin arama sonuçlarında yer alan tüm dokümanlarda bulunmalıdır. To eklemeniz gereken kelime veya kelime öbeğinin önüne "+" ile başlayan tüm arama sonuçlarına dahil edilir (artı işareti).

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

Google'ın kullandığı yaygın bir kelimeden önce + kullanmanız gerekir normal olarak arama sonuçlarını tanımlamadan önce siler.

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

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

allinlinks: sorgu terimi için şuradaki dokümanlar gereklidir: arama sonuçları sayfasının URL'sinde arama sorgusundaki tüm kelimeleri içermelidir bağlantılarını kullanın. Arama sorgusu allinlinks: şeklinde biçimlendirilmelidir ve arama sorgunuzdaki kelimeler devam etmelidir.

Arama sorgunuz allinlinks: sorgusunu içeriyorsa terim, Google, dokümanlardaki URL bağlantılarında yalnızca yoksa dokümanlardaki diğer metinleri yoksayarak ve her dokümanın URL’sini ekleyin. Bu belgenin URL, dokümanda yer alan URL bağlantılarından farklı.

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

Sıralı arama (") sorgu terimi, kelime öbeklerini tırnak işareti içine alarak veya kısa çizgi kullanarak görebilirsiniz.

" öğesinin (tırnak işareti) URL çıkışlı versiyonu %22 şeklindedir.

Kelime öbeği aramaları özellikle, tercih edebilirsiniz.

as_epq isteğini de kullanabilirsiniz parametresini 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, içinde arama sorgusundaki tüm kelimeleri içerecek şekilde başlık ekleyin. Sorgu allintext: şeklinde biçimlendirilmelidir ve arama sorgunuzdaki kelimeler devam etmelidir.

Arama sorgunuz allintext: sorgusunu içeriyorsa terim kullanıyorsanız Google, dokümanların gövde metninde yalnızca bağlantıları yok sayarak, söz konusu dokümanlardaki bağlantıları yoksayarak başlık ve doküman URL'leri.

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

Örnekler Bu örnekte, "Google" ve "search" eklenen tüm dokümanların gövdesinde görünmelidir arama sonuçlarında:
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 kelime içeren dokümanlar. İlgili içeriği oluşturmak için kullanılan arama sorgusu, boşluk bırakmadan intitle:WORD şeklinde biçimlendirilmelidir intitle: sorgu terimi ile sonraki kelime arasına girin.

Not: Daha fazla birden fazla kelimeyi tek bir kelime yerine yazarak belge başlığına intitle: sorgu terimi. Şunları yapabilirsiniz: Bunun için allintitle: sorgu terimini de kullanın. tüm sorgu kelimelerinin resim ve metin.

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

Örnekler

Bu örnekte, "Google" kelimesi şurada görünmelidir: arama sonuçlarındaki dokümanlarının başlığını ve "arama" başlıklar, URL'ler, bağlantılar veya gövde metninde herhangi bir yerde bulunmalıdır bu belgelerden bazıları:
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ı sorgu kelimelerinin tümünü içeren dokümanlar için geçerlidir. Alıcı: allintitle: sorgu terimini kullanın, "allintitle:" ifadesini ekleyin. CANNOT TRANSLATE işaretini eklemeyi unutmayın.

Not: Arama sorgusunun önüne allintitle: konulması, aramada her kelimenin önüne intitle: konulmasına denktir. emin olun.

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

Örnekler

Bu örnekte, "Google" kelimeleri ve "search" arama sonuçlarındaki tüm dokümanların başlıklarında görünmelidir:
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ümanlar. İlgili içeriği oluşturmak için kullanılan arama sorgusu, boşluk içermeyen inurl:WORD şeklinde biçimlendirilmelidir inurl: sorgu terimi ile sonraki kelime arasına girin.

inurl: sorgusu terim, noktalama işaretlerini yok sayar ve inurl: operatöründen sonra gelen yalnızca ilk kelimeyi kullanır. Dahil edilmesi gereken birden fazla kelime belirtebilirsiniz: inurl: sorgu terimini anlamına gelir. Tüm sorgu kelimelerinin URL'lere eklenmesi gerektiğini belirtmek için allinurl: sorgu terimini de kullanabilirsiniz. doküman türü.

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

Örnekler

Bu örnekte, "Google" kelimesi şurada görünmelidir: arama sonuçlarındaki tüm dokümanların URL'leri ve "arama" kelimesi söz konusu içeriklerin başlıklarında, URL'lerinde, bağlantılarında veya gövde metninde dokümanlar:
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ümanlar. Alıcı: allinurl: sorgu terimini kullanın, başına allinurl: ekleyin tam olarak kullanılabilir.

allinurl: sorgu terimi noktalama işaretlerini göz ardı ettiği için URL'de değil, yalnızca kelimelerde çalışır bileşenlerine ayıralım. Örneğin, allinurl: uk/scotland sonuçları kısıtlar "uk" kelimelerini içeren dokümanlara ve "iskoçya" kullanıyor. ancak bu iki kelimenin belirli bir yerde görünmesini eğik çizgiyle ayrılmış olması gerekir.

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

Örnekler

Bu örnekte, "Google" kelimeleri ve "search" arama sonuçlarındaki tüm dokümanların URL'lerinde bulunmalıdır:
Kullanıcı girişi: allinurl: Google search
Sorgu terimi: q=allinurl%3A+Google+search



Web Belgesi Bilgileri [bilgi:]
Açıklama

info: sorgu terimi genel bilgileri getirir bir URL hakkında; ancak o URL Google'ın arama dizinine eklenmişse bunu yapabilirsiniz. Arama sorgusu boşluk bırakmadan info:URL şeklinde biçimlendirilmelidir. info: sorgu terimi ve URL arasına yerleştirin.

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

Not: Aşağıdaki durumlarda başka sorgu terimi belirtemezsiniz. info: kullanılıyor.

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

Örnek Resim Sorguları

Aşağıdaki örnekler, farklı sorgu parametrelerinin nasıl kullanıldığını göstermek için birkaç Resim HTTP isteğini göstermektedir. Farklı sorgu parametrelerinin tanımları bu dokümanın Resim Sorgusu Parametre Tanımları bölümünde sağlanmıştır.

Bu istekte "maymun" sorgu terimi için ilk 5 sonuç (start=0&num=5) isteniyor (q=monkey), .png dosya türü. Son olarak sorgu, üçü de gerekli olan client, output ve cx parametreleri için değerler 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

İsteğe bağlı. 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

İsteğe bağlı. Belirli bir boyuttaki görselleri döndürür. Burada boyut aşağıdakilerden 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

resim türü
Açıklama

İsteğe bağlı. Şunlardan biri olabilecek bir türdeki resimleri döndürür:

  • clipart (klipart)
  • face (yüz)
  • lineart (doğrusal)
  • news (haberler)
  • photo (fotoğraf)

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

imgc
Açıklama

İsteğe bağlı. Siyah beyaz, gri tonlamalı veya renkli resimler döndürür:

  • mono (siyah beyaz)
  • gray (gri tonlama)
  • color (renk)

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

imgcolor
Açıklama

İsteğe bağlı. Belirli bir baskın rengin resimlerini 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

İsteğe bağlı. 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, belirttiğiniz arama isteklerine ilişkin sınırlamalar Google'a gönder:

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. Alıcı: daha fazla sonuç alabiliyorsanız, birden fazla istek göndermeniz ve start parametresinin değerini şu şekilde arttır: dikkat edin.

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

Google WebSearch hizmeti, Google Web Arama'daki dokümanları birden çok dile çevirebilirsiniz. Dahil edilmesi gereken karakter kodlamasını HTTP isteğinizi yorumlamak ve XML yanıtınızı kodlamak için kullanılır. (ie ve oe aramasını kullanarak parametrelerinde de bulunur.) Sonuçları yalnızca dokümanları içerecek şekilde filtreleyebilirsiniz belirli dillerde yazılmış olur.

Aşağıdaki bölümlerde arama yapmayla ilgili sorunlar ele alınmaktadır: birden çok dil:

Karakter Kodlama

Sunucular, web sayfaları gibi verileri kullanıcı aracılarına gönderir. kodlanmış bayt dizisi olarak ayarlamanızı sağlar. Ardından kullanıcı aracısı, karakter dizisine dönüştürmenizi sağlar. kullanıyorsanız, hem web hem de trafik için kodlama şemalarını ve aldığınız XML yanıtıyla ilgili güncel bilgileri toplar.

ie istek parametresini kullanarak kodlama mekanizmasını destekler. Şunları yapabilirsiniz: kodlamayı belirtmek için oe parametresini de kullanın Google'ın XML yanıtınızı kodlamak için kullanması gereken şema. Şu durumda: ISO-8859-1 (veya latin1) dışında bir kodlama şeması kullanıyorsanız lütfen doğru değerleri belirttiğinizden emin olun. ie ve oe parametreleri içindir.

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

Lütfen Karakter Kodlama Şemaları ekinde yer alan ie ve oe parametreleri için kullanabilirsiniz.

Karakter kodlama 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

hl istek parametresini kullanarak grafik arayüzünüzün dilini belirleyin. hl parametre değeri, XML arama sonuçlarını etkileyebilir. dil kısıtlaması (lr parametresi kullanılarak) açıkça belirtilmediğinde uluslararası sorgulara izin verilir. Böyle bir durumda durumlarda, hl parametresi arama sonuçlarını tanıtabilir kullanıcının giriş diliyle aynı dilde olmalıdır.

hl parametresini açık bir şekilde ayarlamanızı öneririz. Google'ın en yüksek kaliteyi seçmesini sağlamak için arama sonuçlarında arama sonuçları görürsünüz.

Lütfen Desteklenen Arayüz hl parametresine ilişkin geçerli değerlerin tam listesi için Diller bölümüne bakın.

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

lr istek parametresini kullanarak arama sonuçlarını, belirli bir veya dil grubuna bağlı kalır.

lr parametresi, aşağıdakileri belirtmenize olanak tanımak için Boole Operatörlerini destekler: aramaya dahil edilmesi (veya hariç tutulması) gereken birden fazla dil sonuç.

Aşağıdaki örneklerde Google Analytics 4'te doküman istemek için Boole Operatörlerini farklı dillerde içerik sunar.

Japonca yazılan 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ış belgeler için:

lr=(-lang_hu).(-lang_cs)

Lütfen Dil Koleksiyonu'na bakın lr parametresi ve Boole Değerlerinin tam listesi için Değerler bölümü Operatörler bölümü ile ilgili kapsamlı bir açıklama işleci.

Basitleştirilmiş Çince ve Geleneksel Çince iki yazma varyantıdır. bir diğeri. Aynı kavram projede farklı şekilde yazılabilir ekleyin. Varyantlardan birinde bir sorgu verildiğinde Google, WebSearch hizmeti, hem için de geçerlidir.

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, bir sonuç isteğine dahil edeceğiniz sorgu parametreleri gösterilmektedir Basitleştirilmiş ve geleneksel Çince dillerinde desteklenmektedir. ( istemci olarak tanımlanmamıştır.)

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

Sonuçları Filtreleme

Google WebSearch, aramanızı filtrelemek için çeşitli yollar sunar sonuç:

Arama Sonuçlarını Otomatik Olarak Filtreleme

Google, mümkün olan en iyi arama sonuçlarını sağlama çabasıyla, kullanılan arama sonuçlarını otomatik olarak filtrelemek için istenmeyen olarak değerlendirilir:

  • Yinelenen İçerik: Birden fazla doküman aynı bilgilere sahip olacaksanız, söz konusu kümenin yalnızca en alakalı dokümanı dahil edilir.

  • Barındırıcı Dışlatma: Web sitenizden çok sayıda arama sonucu veya siteyle ilgili tüm sonuçları göstermeyebilir ya da
    grubunda daha düşük sonuçları göster daha yüksek bir sıralamaya sahip olmalarına neden olabilir.

Tipik arama istekleri için bu filtreleri açık bırakmanızı öneririz çünkü filtreler çoğu aramanın kalitesini önemli ölçüde sonuç. Ancak, filter sorgu parametresini arama isteği.

Dil ve Ülke Filtreleme

Google WebSearch hizmeti, tüm Web belgelerinde geçerlidir. Ana dizin, dil dahil belirli özelliklere göre gruplandırılmış dokümanlar ve menşe ülke bilgilerini sağlamalısınız.

Arama sonuçlarını şu alt koleksiyonlarla sınırlamak için lr ve cr istek parametrelerini kullanabilirsiniz: belirli dillerde yazılmış veya kaynağı tıklayın.

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ümandaki dil meta etiketleri
  • dokümanın gövde metninde kullanılan birincil dil


. Ayrıca lütfen lr parametresinin tanımını, Belirli Dillerde Yazılmış Dokümanlar ve yerelleştirilebilecek Dil Koleksiyonu Değerleri daha fazlası için lr parametresi değeri olarak kullanılır sonuçları dile göre kısıtlamayla ilgili bilgiler.

Google WebSearch, dokümanda bulunduğu ülkeyi aşağıdakileri analiz ederek belirler:

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

Ayrıca lütfen cr parametresinin tanımına ve Ülke Koleksiyonu'na da bakın Sonuçların ülkesine göre kısıtlanması hakkında daha fazla bilgi için cr parametresi için değer olarak kullanılabilecek değerler kaynak.

Not: Dili birleştirebilirsiniz. değerleri ve ülke değerlerini kullanabilirsiniz. Örneğin, Fransızca ve İngilizce yazılmış belgeler isteyebilirsiniz. Fransa veya Kanada'dan gelen bir e-posta adresi de gönderebilirsiniz. ülkedir. Türkçe yazılmış değildir. lr ve cr parametreleri Boole Operatörlerini destekler.

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

Birçok Google müşterisi, arama sorgularıyla ilgili siteler yetişkinlere uygun içerik barındıran içerikler. Güvenli Arama filtremizi kullanarak, her bir yetişkinlere uygun içerik barındıran arama sonuçları için arama yapar ve bunları çıkarır. Google'ın filtreleri, anahtar kelimeleri, kelime öbeklerini kontrol etmek için özel bir teknoloji kullanır. ve URL'ler. Hiçbir filtre yüzde 100 doğru olmasa da, Güvenli Arama yetişkinlere uygun içeriğin büyük bir çoğunluğunu aramanızdan kaldırın sonuç.

Google, Güvenli Arama'yı mümkün olduğunca güncel ve kapsamlı tutmak için web'i sürekli tarayarak ve web'deki güncellemeleri uygulayarak yardımcı olabilir.

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

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

Google'ın sonuçlarınızı filtrelerken ne kadar safe sorgu parametresi kullanarak yetişkinlere uygun içerik. Aşağıdaki tabloda, Google'ın Güvenli Arama ayarları ve bu ayarların Ayarlarınız arama sonuçlarınızı etkileyecek:

Güvenli Arama Düzeyi Açıklama
yüksek Daha katı bir sürümü etkinleştirir yardımcı olur.
medium Şunu içeren web sayfalarını engeller: pornografi ve diğer uygunsuz cinsel içerikler
kapalı Yetişkinlere uygun filtre uygulanmaz daha fazla bilgi edinin.

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

Güvenli Arama'yı etkinleştirdiyseniz ve rahatsız edici içeriği bulursanız lütfen sitenin URL'sini safesearch@google.com adresine e-posta ile gönderdiğinizde, araştıracaktır.

XML Sonuçları

Google XML Sonuçları DTD

Google, her tür için XML biçimini tanımlamak üzere aynı DTD'yi kullanır. arama sonuçları. Etiketlerin ve özelliklerin çoğu, arama türleri. Bununla birlikte, bazı etiketler yalnızca belirli arama türleri. Sonuç olarak, DTD'deki tanımlar daha az bu belgede verilen tanımlardan daha kısıtlayıcı.

Bu dokümanda, DTD'nin alakalı olan yönleri açıklanmaktadır WebSearch için. Veriye Dayalı İlişkilendirme'ye baktığınızda, üzerinde çalıştığınız webSearch'e dahil olmayan etiketleri ve özellikleri burada belgeleyeceğiz. Tanımı DTD ile bu belgede belirtilmektedir.

Google, XML sonuçlarını en son DTD. DTD, arama yöneticilerine yardımcı olmaya yönelik bir rehberdir XML ayrıştırıcıları, Google'ın XML sonuçlarını anlar. Çünkü Google'ın XML biçimi dilbilgisi zaman zaman değişebileceğinden, ayrıştırıcı ile birlikte DTD'yi kullanır.

Ayrıca, XML ayrıştırıcınızı Her arama isteği gönderdiğinizde DTD. Google, DTD'yi günceller ve bu istekler gereksiz gecikme ve bant genişliğine neden olur. gereksinimlerini karşılayın.

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 XML sonuçlarına aşağıdaki satırın eklenmesidir:

<!DOCTYPE GSP SYSTEM "google.dtd">

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

DTD'deki tüm özelliklerin şu anda kullanılamadığını veya desteklenmediğini lütfen unutmayın.

XML Yanıtı Hakkında

  • Tüm öğe değerleri, görüntülemeye uygun geçerli HTML kodu olmalıdır. aksi takdirde XML etiketi tanımlarında belirtilir.
  • Bazı öğe değerleri, öğeden önce HTML olarak kodlanması gereken URL'lerdir gösterilir.
  • XML ayrıştırıcınız belgelenmemiş özellikleri ve etiketleri yoksaymalıdır. Bu, uygulamanızın değişiklik yapmadan çalışmaya devam etmesini sağlar XML çıkışına daha fazla özellik ekler.
  • Belirli karakterler, XML etiketleridir. XML işlemciniz bu varlıkları tekrar girin. Varlıkları düzgün bir şekilde dönüştürmezseniz tarayıcı örneğin, & karakterini "&amp" olarak değiştirin. XML Standart ifadesi bu karakterleri belgeler; bu karakterler aşağıdaki tabloda yeniden oluşturulmuş:

    Karakter Tespit Edilemeyen 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ı için XML Sonuçları

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

Bu örnek WebSearch isteğinde 10 sonuç isteniyor (num=10) hakkında (q=socer), bu kelime "futbol" kasıtlı olarak 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. Lütfen unutmayın: XML sonucunda, belirli etiketlerin burada bir kontrol listesi görüntülenir.

<?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 için XML yanıtları her iki istek de aynı XML etiket grubunu kullanır. Bu XML etiketleri aşağıdaki tablolarda açıklanmıştır.

Aşağıdaki XML etiketleri, etiket adına göre alfabetik olarak listelenmiştir ve etiket tanımı, etiketin bir açıklamasını içerir; etiketin XML sonucunda nasıl görüneceğini ve içerik. Etiket başka bir XML etiketinin alt etiketiyse veya etiket kendine ait alt etiketlere veya özelliklere sahip olduğundan, bu bilgiler etiketinin tanım tablosudur.

Google Ads API'sindeki bazı alt etiketlerin yanında belirli simgeler aşağıdaki tanımlar. Bu semboller ve anlamları aşağıdaki gibidir:

ne yapmalıyım? = 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 S S D A K Ü S K G T U X

anchor_text
Tanım

&lt;anchor_text&gt; etiketi, hassaslaştırma belirlemek için kullanıcılara göstermeniz gereken etiketi arasındaki ilişkiyi belirtir. Ayrıntılandırma etiketlerinden bu yana alfanümerik olmayan karakterleri alt çizgiyle değiştirmeye çalışın Kullanıcı arayüzünüzde <label> etiketinin değerini görüntüleyin. Bunun yerine &lt;anchor_text&gt; etiketi.

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

ENGELLE
Tanım

Bu etiket, tanıtım sonucunun gövde satırındaki bir bloğun içeriğini içerir. Her blokta T, U ve L alt etiketleri bulunur. Boş olmayan bir T etiketi, bloğun metin içerdiğini belirtir; Boş olmayan U ve L etiketleri, blokun bir bağlantı içerdiğini gösterir (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övdesindeki bir satırın içeriğini içerir. Her gövde satırı birkaç ENGELLE etiketinden oluşur. Bu etiketler ya bir miktar metin ya da URL ve bağlantı metni içeren bir bağlantı içerir.

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

C
Tanım

&lt;C&gt; etiketi, WebSearch hizmetinin bu arama sonucu URL'sinin önbelleğe alınmış bir sürümünü alabilir. Yapamayacağınız işlemler: önbelleğe alınan sayfaları XML API aracılığıyla alır ancak kullanıcıları, www.google.com adresine gönderebilirsiniz. içerik.

Özellikler
Adı Biçimi Açıklama
SZ Metin (Tam sayı + "k") Önbelleğe alınan sürümün boyutunu belirtir kilobayt ("k") cinsinden ifade eder.
Müşteri Kimliği Metin Google'ın önbelleğindeki bir dokümanı tanımlar. Dokümanı önbellekten getirmek için şuna benzer bir arama terimi gönderin: takip edin:
cache:CIDtext:escapedURL

Çıkış karakterli URL UE etiketinde kullanılabilir.

Örnek <C SZ="6k" CID=&quot;kvOXK_cYSSgJ&quot; /
Alt etiketi SAHİP
İçerik Biçimi Boş

C2C
Tanım <C2C> etiketi, sonuç, Geleneksel Çince dilindeki bir sayfayı belirtir. Bu etiket yalnızca Basitleştirilmiş ve Geleneksel Çince Arama etkin. Etkinleştirme ve hakkında daha fazla bilgi için c2coff sorgu parametresinin tanımına bakın bu özelliği devre dışı bırakır.
İçerik Biçimi Metin

Bağlam
Tanım

&lt;Context&gt; etiketi, bir dizi arama sonucuyla ilişkili etiketleri hassaslaştırma.

Örnek &lt;Context&gt;
Alt etiketler title, Facet+
İçerik Biçimi Kapsayıcı

TARİH
Tanım

&lt;CRAWLDATE&gt; etiketi, sayfa en son tarandı. CRAWLDATE, her arama sonucu sayfası için döndürülmez.

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

DI
Tanım

&lt;DI&gt; etiketi, Açık Dizin Projesini içerir (ODP) kategori bilgilerini girin.

Örnek &lt;DI&gt;
Alt etiketler DT?,
Alt etiketi SAHİP
İçerik Biçimi Boş

DS
Tanım

&lt;DS&gt; etiketi, tek kategori olabilir.

Örnek <DS> &lt;s&gt;futbol&lt;/s&gt; doğrudan internet.</DS>
Alt etiketi DI
İçerik Biçimi Metin (HTML içerebilir)

DT
Tanım

&lt;DT&gt; etiketi, tek bir kategorisidir.

Örnek &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
Alt etiketi DI
İçerik Biçimi Metin (HTML içerebilir)

Özellik
Tanım

<Facet> etiketi, &lt;FacetItem&gt; etiketlerinin mantıksal bir gruplandırmasını içerir. Şunları yapabilirsiniz: ve Programlanabilir Arama Motoru kullanılarak Motor XML Spesifikasyonu biçimi. Bunları oluşturmazsanız gruplamalar, the results_xml_tag_Context><Bağlam> etiket yukarı içerir <Facet> etiketine ekleyin. Her bir <Facet> etiketi içindeki öğeler, görüntüleme amacıyla gruplandırılır ancak mantıksal bir mantığı olmayabilir. ilişkilidir.

Örnek <Façeta>
Alt etiketler FacetItem+, title+
Alt etiketi Bağlam
İçerik Biçimi Kapsayıcı

FacetItem
Tanım

&lt;FacetItem&gt; etiketi, bir ayrıntılandırma etiketi hakkında.

Örnek &lt;FacetItem&gt;
Alt etiketler label, anchor_text+
Alt etiketi Façeta
İçerik Biçimi FacetItem

FI
Tanım &lt;FI&gt; etiketi bir işaret işlevi görür Bu değer, arama için doküman filtrelemesinin uygulanıp uygulanmadığını gösterir. Otomatik Filtreleme bölümüne bakın daha fazla bilgi edinmek için bu dokümanın filtrelerine dokunun.
Örnek <FI />
Alt etiketi RES
İçerik Biçimi Boş

GST
Tanım

&lt;GSP&gt; etiketi Google XML arama sonuçlarında döndürülen tüm verileri içerir. "GSP" : Google Arama Protokolü"nün kısaltmasıdır.

Özellikler
Adı Biçimi Açıklama
SÜRÜM Metin (Tam sayı) VER özelliği, arama sonuçları çıkışının sürümünü belirtir. İlgili içeriği oluşturmak için kullanılan şu anki çıkış sürümü "3.2".
Örnek <GSP VER="3.2">
Alt etiketler PARAM+, Q, RES?, TM
İçerik Biçimi Boş

VAR
Tanım &lt;HAS&gt; etiketi herhangi bir özel arama veya özel arama istek parametrelerini ifade eder.

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

Alt etiketler DI?, L?, C?, RT mi?
Alt etiketi K

ISURL
Tanım Google, &lt;ISURL&gt; etiketini döndürür ilişkili arama sorgusu bir URL ise.
Alt etiketi GSP
İçerik Biçimi Boş

L
Tanım &lt;L&gt; etiketinin varlığı WebSearch hizmetinin kullanabilirsiniz. Bu tür siteleri bulmak için link: özel sorgu terimini kullanırsınız.
Alt etiketi SAHİP
İçerik Biçimi Boş

etiket
Tanım

<label> etiketi bir ayrıntılandırma etiketini belirtir filtre uygulayabilirsiniz. Kullanılacak ayrıntılandırma etiketi için more:[[label tag value]] dizesini ekleyin ve Google'a gönderdiğiniz HTTP isteğinizdeki q parametresinin değeri aşağıdaki örnekte gösterilmiştir. Bu değerin URL ile kod dışına alınmalıdır.

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 ayrıntılandırma etiketini tanımlayan &lt;Label&gt; etiketi belirli bir URL ile ilişkilendirildiğinden emin olun.

Örnek &lt;label&gt;golf_courses&lt;/label&gt;
Alt etiketi FacetItem
İçerik Biçimi Metin

LANG
Tanım

&lt;LANG&gt; etiketi, Google'ın şu dille ilgili en iyi tahminini dil ayarını seçin.

Örnek <com.tr/tr</com.tr
Alt etiketi K
İçerik Biçimi Metin

M
Tanım

&lt;M&gt; etiketi tahmini toplamı tanımlar aramayla ilgili sonuç sayısını gösterir.

Not: Bu tahmin doğru olmayabilir.

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

YD
Tanım

&lt;NB&gt; etiketi gezinme bilgilerini içerir. Örneğin, arama sonuçlarının bir sonraki sayfasına veya arama sonuçları (sonuç kümesi için)

Not: Bu etiket yalnızca mevcut (daha fazla sonuç varsa) girin.

Örnek &lt;NB&gt;
Alt etiketler NU?, PU mu?
Alt etiketi RES
İçerik Biçimi Boş

NU
Tanım

&lt;NU&gt; etiketi, arama sonuçlarının sonraki sayfasına gidin.

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

PARAM
Tanım

&lt;PARAM&gt; etiketi ilişkilendirilen HTTP isteğinde gönderilen bir giriş parametresini tanımlar XML sonucuyla aynı. Parametreyle ilgili bilgiler şurada yer alır: (ad, değer, orijinal_değer) etiket özelliklerini HTTP isteğinde gönderilen her parametre için bir PARAM etiketi.

Özellikler
Adı Biçimi Açıklama
name Metin Giriş parametresi adı.
value HTML Girişin HTML biçimli sürümü parametre değeri.
original_value Metin Giriş parametresi değerinin orijinal URL çıkışlı sürümü.
Örnek <PARAM name="cr" value=&quot;countryNZ&quot; orijinal_değer="ülkeYeni Zelanda" /
Alt etiketi GSP
İçerik Biçimi Karmaşık

PU
Tanım

&lt;PU&gt; etiketi, arama sonuçlarının önceki sayfası.

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

SORU
Tanım

&lt;Q&gt; etiketi arama sorgusunu tanımlar XML sonucuyla ilişkili HTTP isteğinde gönderilir.

Örnek

<Q>pizza</Q>

Alt etiketi GSP
İçerik Biçimi Metin

K
Tanım

&lt;R&gt; etiketi, bir öğenin ayrıntılarını kullanabilirsiniz.

Not: Şu öğe için <R> etiketinin tanımı: WebSearch, DTD'den daha kısıtlayıcıdır.

Özellikler
Adı Biçimi Açıklama
N Metin (Tam sayı) Bunun dizinini (1 tabanlı) gösterir emin olun.
MIME Metin Aramanın MIME türünü belirtir yardımcı olur.
Alt etiketler Ü, UE, T?, CRAWLDATE, S?, LANG, SAHİP
Alt etiketi RES

YENİ
Tanım

&lt;RES&gt; etiketi, arama sonuçları ve bu sonuçlarla ilgili ayrıntılar.

Özellikler
Adı Biçimi Açıklama
SN Metin (Tam sayı) Verinin indeksini (1 tabanlı) bu sonuç kümesinde döndürülen ilk arama sonucu sayısı.
TR Metin (Tam sayı) Son bu sonuç kümesinde döndürülen arama sonucu sayısı.
Örnek <RES SN="1" TR="10">
Alt etiketler E, FI?, XT?, NB?, G*
Alt etiketi GSP
İçerik Biçimi Boş

S
Tanım

&lt;S&gt; etiketi bir aramadan alıntı içerir. sorgu terimlerini kalın olarak vurgulanmış olarak gösteren sonuç. Satır sonları: dahil edilir.

Örnek <S>Washington (CNN) -- Senatoda Başkanlık sunumu &lt;S&gt;Çalı&#39;s&lt;/b&gt; mahkeme kararı beş adayın son oya ulaşmasına izin verirken &lt;t&gt;...&lt;b&gt;...&lt;/b&gt;<S>
Alt etiketi K
İçerik Biçimi Metin (HTML)

SL_MAIN
Tanım

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

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ı etiketi. Arama sonuçlarınızda her 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 K
İçerik Biçimi Boş

Yazım
Tanım

<Spelling> etiketi, gönderilen sorgu için yazım önerisi. Bu etiket yalnızca şurada görünür: Arama sonuçlarının ilk sayfasında. Yazım önerilerinin kullanılabildiği diller İngilizce, Çince, Japonca ve Korece.

Not: Google yalnızca yazım önerilerini önerir. gl parametre değerinin küçük harfle yazılmalıdır.

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

Öneri
Tanım &lt;Suggestion&gt; etiketi, gönderilen sorgu için alternatif yazım önerisi. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için etiketinin içeriğini kullanarak, arama kullanıcınıza alternatif yazımı önerir. q özelliğinin değeri Sorgu terimi olarak kullanabileceğiniz URL kaçışlı yazım önerisi.
Özellikler
Ad Biçim Açıklama
q Metin q özelliği, Yazım önerisinin URL çıkışlı sürümü.
Örnek <Öneri q=&quot;soccer&quot;&gt;&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;soccer&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;&lt;/Suggestion&gt;
Alt etiketi Yazım
İçerik Biçimi Metin (HTML)

S
Tanım &lt;T&gt; etiketi başlığı içerir yardımcı olur.
Örnek <T>Amici'nin Doğu Yakası Pizzacı</T>
Alt etiketi K
İçerik Biçimi Metin (HTML)

title
Tanım

&lt;Context&gt; alt etiketi olan &lt;Context&gt; etiketi, Programlanabilir Arama Motorunuzun adını içerir.

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

Örnek

<Context> alt öğesi olarak: <title>Aramam Engine&lt;/title&gt;

<Facet> adlı çocuğun çocuğu: <title>facet başlık</title>

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

TM
Tanım

&lt;TM&gt; etiketi toplam sunucu süresini tanımlar arama sonuçlarını döndürmek için gereklidir (saniye cinsinden ölçülür).

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

TT
Tanım &lt;TT&gt; etiketi, kullanıcılara ipucu.
Örnek <TT>&lt;i&gt;İpucu: Çoğu tarayıcılarda, Return tuşuna bastığınızda Ara düğmesi.&lt;/i&gt;</TT>
Alt etiketi GSP

U
Tanım &lt;U&gt; etiketi, URL'yi bir liste oluşturabilirsiniz.
Örnek &lt;U&gt;http://www.dominos.com/&lt;/U&gt;
Alt etiketi K
İçerik Biçimi Metin (Mutlak URL)

UD
Tanım

&lt;UD&gt; etiketi, (Uluslararası Alan Adı) URL'si. Bu değer, yerel diller kullanılarak görüntülenecek alan adı. Örneğin, IDN kodlamalı URL http://www.%E8%8A%B1%E4%BA%95.com, kodu çözülüp http://www.花く鮨.com şeklinde görüntülenebilir. Bu &lt;UD&gt; etiketi yalnızca şunun arama sonuçlarına dahil edilir: ud parametresini içeren istekler.

Not: Bu bir beta özelliğidir.

Örnek &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
Alt etiketi K
İçerik Biçimi Metin (IDN kodlu URL)

UE
Tanım &lt;UE&gt; etiketi, URL'yi bir liste oluşturabilirsiniz. Değer, uygun olması için URL çıkışlı sorgu parametresi olarak iletmek için kullanılır.
Örnek &lt;UE&gt;http://www.dominos.com/&lt;/UE&gt;
Alt etiketi K
İçerik Biçimi Metin (URL çıkışlı URL)

XT
Tanım &lt;XT&gt; etiketi, M etiketi tarafından belirtilen tahmini toplam sonuç sayısı, gerçekte tam olarak toplam sayısını görebilirsiniz. Bkz. Otomatik Filtreleme bölümüne göz atın.
Örnek <XT />
Alt etiketi RES
İçerik Biçimi Boş


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

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

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, resim arama sorguları için XML yanıtlarında kullanılan ek XML etiketleri gösterilmektedir.

Google Ads API'sindeki bazı alt etiketlerin yanında belirli simgeler aşağıdaki tanımlar. Bu semboller ve anlamları aşağıdaki gibidir:

ne yapmalıyım? = 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

&lt;RG&gt; etiketi, tek bir görsel arama sonucunun ayrıntılarını kapsar.

Özellikler
Adı Biçimi Açıklama
N Metin (Tam sayı) Bunun dizinini (1 tabanlı) gösterir emin olun.
MIME Metin Aramanın MIME türünü belirtir yardımcı olur.
Alt etiketi RES
RU
Tanım

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

Alt etiketi K