Bu sayfa, Custom Search JSON API'nin yalnızca Google Site Search müşterileri.
- Genel Bakış
- Programlanabilir Arama Motoru İstek Biçimi
- XML Sonuçları
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
- İstek gönder Genel Bakış
- Sorgu Terimleri
- İstek Parametreleri
- Örnek WebSearch Sorguları
- WebSearch Sorgusu Parametre Tanımları
- Örnek Resim Sorguları
- Görsel Arama Sorgusu Parametre Tanımları
- Gelişmiş Arama
- Gelişmiş Arama Sorgu parametreleri
- Özel Sorgu Terimleri
- İstek Sınırları
İ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ğerxml_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:
Ö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
|
||||||
Örnekler | q=google&c2coff=1 |
müşteri | |
---|---|
Açıklama | Zorunludur. |
Örnekler | q=google&client=google-csbe |
cr | |
---|---|
Açıklama | İsteğe bağlı. Google WebSearch, bir dokümanın ülkesini şu kriterlere göre belirler: analiz:
Bkz. Ülke (cr) Parametresi Değerler bölümüne gidin. |
Örnekler | q=Frodo&cr=countryNZ |
tb | |
---|---|
Açıklama | Zorunludur. |
Ö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.
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ı. WebSearch isteklerinde |
Örnekler | Bu istek, Birleşik Krallık'ta şu dilde yazılmış dokümanları geliştirir:
WebSearch sonuçları: |
hl | |
---|---|
Açıklama | İsteğe bağlı. 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ı. |
Örnekler | Bu istek "pizza" için arama yapar VE "peynir". İfade,
|
ie | |
---|---|
Açıklama | İsteğe bağlı. 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ı |
Örnekler | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Açıklama | İsteğe bağlı. Google WebSearch, bir dokümanın dilini şu kriterlere göre belirler: analiz:
Dil ( |
Örnekler | q=Frodo&lr=lang_en |
numara | |
---|---|
Açıklama | İsteğe bağlı. Varsayılan 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ı. 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ı |
Örnekler | q=google&ie=utf8&oe=utf8 |
çıkış | |||||||
---|---|---|---|---|---|---|---|
Açıklama | Zorunludur.
|
||||||
Örnekler | output=xml_no_dtd |
q | |
---|---|
Açıklama | İsteğe bağlı. Eklenebilecek bir dizi özel sorgu terimi
Google Arama Kontrol Paneli,
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ı.
|
||||||||
Örnekler | q=adult&safe=high |
start | |
---|---|
Açıklama | İsteğe bağlı.
|
Örnekler | start=10 |
sıralama | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler |
|
ud | |
---|---|
Açıklama | İsteğe bağlı. http://www.花井鮨.com Bu parametre için geçerli değerler
http://www.xn--elq438j.com. Not: Bu bir beta özelliğidir. |
Örnekler | q=google&ud=1 |
Gelişmiş Arama
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.
![](https://services.google.com/images/as_examples/advanced_search.jpg?authuser=1&hl=tr)
Gelişmiş Arama Sorgusu Parametreleri
as_dt | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler | as_dt=i,as_dt=e |
as_epq | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler | as_epq=abraham+lincoln |
as_eq | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler |
|
as_lq | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler |
|
as_nlo | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler | Aşağıdakiler de dahil olmak üzere 5-10 arasında bir arama aralığı belirler:
|
as_nhi | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler | Aşağıdakiler de dahil olmak üzere 5-10 arasında bir arama aralığı belirler:
|
as_oq | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler |
|
as_q | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler |
|
as_qdr | |
---|---|
Açıklama | İsteğe bağlı.
|
Örnekler |
Bu örnekte, geçen yıla ait sonuçlar istenmiştir:
Bu örnekte son 10 güne ait sonuçlar istenmiştir:
|
as_sitesearch | |
---|---|
Açıklama | İsteğe bağlı. |
Örnekler |
|
Ö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 |
as_lq isteğini de kullanabilirsiniz.
parametresini kullanabilirsiniz. Not: Aşağıdaki durumlarda başka sorgu terimi belirtemezsiniz.
|
Örnekler |
|
Boole VEYA Arama [ VEYA ] | |
---|---|
Açıklama |
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 (
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 |
Not: Birden fazla hariç tutabilirsiniz
daha fazla Google tarafından desteklenen dosya türleri şunlardır:
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: Bu örnek, "Google"dan bahseden dokümanları döndürür. ama
hem PDF hem de Word dokümanları hariçtir: |
Dosya Türü Filtreleme [ filetype: ] | |
---|---|
Açıklama |
Aramayı kısıtlayabilirsiniz
birkaç dosya uzantısından biriyle eşleşen dokümanlara sonuç
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:
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: Bu örnek,
"Google": |
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).
Google'ın kullandığı yaygın bir kelimeden önce |
Ö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 |
Arama sorgunuz
|
Ö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.
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 |
Arama sorgunuz
|
Ö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 |
Not: Daha fazla
birden fazla kelimeyi tek bir kelime yerine yazarak belge başlığına
|
Ö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ı: |
Başlık Arama, tüm terimler [allintitle:] | |
---|---|
Açıklama |
Not: Arama sorgusunun önüne
|
Örnekler | Bu örnekte, "Google" kelimeleri ve "search"
arama sonuçlarındaki tüm dokümanların başlıklarında görünmelidir: |
URL Arama, tek terim [inurl:] | |
---|---|
Açıklama |
|
Ö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: |
URL Arama, tüm terimler [allinurl:] | |
---|---|
Açıklama |
|
Örnekler | Bu örnekte, "Google" kelimeleri ve "search"
arama sonuçlarındaki tüm dokümanların URL'lerinde bulunmalıdır: |
Web Belgesi Bilgileri [bilgi:] | |
---|---|
Açıklama |
Not: Aşağıdaki durumlarda başka sorgu terimi belirtemezsiniz.
|
Ö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: |
Ö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:
|
Ö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:
|
Ö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:
|
Ö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:
|
Örnekler | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Açıklama | İsteğe bağlı. Lisanslamaya dayalı filtreler. Desteklenen değerler şunlardır:
|
Ö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ş ve Geleneksel Çince Arama
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:
- c2coff istek parametresini 0 olarak ayarlayın
ve - Aşağıdakilerden birini yapı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ç:
- Otomatik Arama sonuçlarını filtreleme
- Dil ve ülke filtreleme
- Yetişkinlere Uygun İçeriği Filtrelemek için SafeSearch
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
- XML Yanıtı hakkında
- XML Normal ve Gelişmiş Arama Sorguları Sonuçları
- Normal/Gelişmiş Arama: Örnek Sorgu ve XML Sonucu
- Normal/Gelişmiş Arama: XML Etiketleri
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 "&" 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 & & & Tek Tırnak İşareti ' ' ' Çift Tırnak İşareti " " " Büyüktür İşareti > > > Küçüktür İşareti < < <
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:
* = 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 | <anchor_text> 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 <anchor_text> 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 | <C> 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 |
|
|||||||||
Örnek | <C SZ="6k" CID="kvOXK_cYSSgJ" / | |||||||||
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 | <Context> etiketi, bir dizi arama sonucuyla ilişkili etiketleri hassaslaştırma. |
Örnek | <Context> |
Alt etiketler | title, Facet+ |
İçerik Biçimi | Kapsayıcı |
TARİH | |
---|---|
Tanım | <CRAWLDATE> etiketi,
sayfa en son tarandı. |
Örnek | <CRAWLDATE>21 Mayıs, 2005</CRAWLDATE> |
Alt etiketi | K |
İçerik Biçimi | Metin |
DI | |
---|---|
Tanım | <DI> etiketi, Açık Dizin Projesini içerir (ODP) kategori bilgilerini girin. |
Örnek | <DI> |
Alt etiketler | DT?, |
Alt etiketi | SAHİP |
İçerik Biçimi | Boş |
DS | |
---|---|
Tanım | <DS> etiketi, tek kategori olabilir. |
Örnek | <DS> <s>futbol</s> doğrudan internet.</DS> |
Alt etiketi | DI |
İçerik Biçimi | Metin (HTML içerebilir) |
DT | |
---|---|
Tanım | <DT> etiketi, tek bir kategorisidir. |
Örnek | <DT>SoccerConnection.net</DT> |
Alt etiketi | DI |
İçerik Biçimi | Metin (HTML içerebilir) |
Özellik | |
---|---|
Tanım | <Facet> etiketi, <FacetItem> 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 | <FacetItem> etiketi, bir ayrıntılandırma etiketi hakkında. |
Örnek | <FacetItem> |
Alt etiketler | label, anchor_text+ |
Alt etiketi | Façeta |
İçerik Biçimi | FacetItem |
FI | |
---|---|
Tanım | <FI> 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 | <GSP> 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 |
|
||||||
Örnek | <GSP VER="3.2"> | ||||||
Alt etiketler | PARAM+, Q, RES?, TM | ||||||
İçerik Biçimi | Boş |
VAR | |
---|---|
Tanım | <HAS> 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, <ISURL> etiketini döndürür ilişkili arama sorgusu bir URL ise. |
Alt etiketi | GSP |
İçerik Biçimi | Boş |
L | |
---|---|
Tanım | <L> 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 Not: <label> etiketi ayrıntılandırma etiketini tanımlayan <Label> etiketi belirli bir URL ile ilişkilendirildiğinden emin olun. |
Örnek | <label>golf_courses</label> |
Alt etiketi | FacetItem |
İçerik Biçimi | Metin |
LANG | |
---|---|
Tanım | <LANG> 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 | <M> 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 | <NB> 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 | <NB> |
Alt etiketler | NU?, PU mu? |
Alt etiketi | RES |
İçerik Biçimi | Boş |
NU | |
---|---|
Tanım | <NU> 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 | <PARAM> 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 |
|
||||||||||||
Örnek | <PARAM name="cr" value="countryNZ" orijinal_değer="ülkeYeni Zelanda" / | ||||||||||||
Alt etiketi | GSP | ||||||||||||
İçerik Biçimi | Karmaşık |
PU | |
---|---|
Tanım | <PU> 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 | <Q> 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 | <R> 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 |
|
|||||||||
Alt etiketler | Ü, UE, T?, CRAWLDATE, S?, LANG, SAHİP | |||||||||
Alt etiketi | RES |
YENİ | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Tanım | <RES> etiketi, arama sonuçları ve bu sonuçlarla ilgili ayrıntılar. |
|||||||||
Özellikler |
|
|||||||||
Örnek | <RES SN="1" TR="10"> | |||||||||
Alt etiketler | E, FI?, XT?, NB?, G* | |||||||||
Alt etiketi | GSP | |||||||||
İçerik Biçimi | Boş |
S | |
---|---|
Tanım | <S> 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 <S>Çalı's</b> mahkeme kararı beş adayın son oya ulaşmasına izin verirken <t>...<b>...</b><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 | <Suggestion> 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 |
|
||||||
Örnek | <Öneri q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion> | ||||||
Alt etiketi | Yazım | ||||||
İçerik Biçimi | Metin (HTML) |
S | |
---|---|
Tanım | <T> 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 | <Context> alt etiketi olan <Context> 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</title> <Facet> adlı çocuğun çocuğu: <title>facet başlık</title> |
Alt etiketi | Bağlam, Facet |
İçerik Biçimi | Metin |
TM | |
---|---|
Tanım | <TM> 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 | <TT> etiketi, kullanıcılara ipucu. |
Örnek | <TT><i>İpucu: Çoğu tarayıcılarda, Return tuşuna bastığınızda Ara düğmesi.</i></TT> |
Alt etiketi | GSP |
U | |
---|---|
Tanım | <U> etiketi, URL'yi bir liste oluşturabilirsiniz. |
Örnek | <U>http://www.dominos.com/</U> |
Alt etiketi | K |
İçerik Biçimi | Metin (Mutlak URL) |
UD | |
---|---|
Tanım | <UD> 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 <UD> etiketi yalnızca şunun arama sonuçlarına dahil edilir: ud parametresini içeren istekler. Not: Bu bir beta özelliğidir. |
Örnek | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Alt etiketi | K |
İçerik Biçimi | Metin (IDN kodlu URL) |
UE | |
---|---|
Tanım | <UE> 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 | <UE>http://www.dominos.com/</UE> |
Alt etiketi | K |
İçerik Biçimi | Metin (URL çıkışlı URL) |
XT | |
---|---|
Tanım | <XT> 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:
* = 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ı kapsar. |
|||||||||
Özellikler |
| |||||||||
Alt etiketi | RES |
RU | |
---|---|
Tanım | <RU etiketi> etiketi, her bir görsel arama sonucunun ayrıntılarını içerir. |
Alt etiketi | K |