Otel listesi, fiyat bilgilerini sağlayacağınız tüm otelleri listeleyen bir veya daha fazla XML dosyasıdır. Otel listesi dosyasının kendisi fiyat bilgisi içermez.
Otel listesinin kök öğesi, tesislerinizi açıklayan <listing>
öğelerini içeren <listings>
öğesidir.
İlk uygulamanızın bir parçası olarak otel listesi oluşturduktan sonra, düzenli bakım kapsamında listede otel ekleme veya kaldırma işlemleri yaparsınız.
Dosyalarınızın söz dizimi yönergelerine uygun olduğundan emin olun.
Örneğin, UTF-8 kodlamasını kullanın ve XML etiketinize encoding
özelliğini ekleyerek bu kodlama şemasını belirtin.
Bir otel listesi oluşturduktan sonra bu listeyi Hotel Center'ı kullanarak Google'a manuel olarak yükleyebilir veya sunucunuzda barındırabilirsiniz.
Veri sorunlarını bulma ve düzeltme
Otel listenizdeki veri sorunlarını bulmak ve düzeltmek için aşağıdaki makaleleri inceleyin:
Listeleme gereksinimleri
Otel listenizdeki bir tesisin Google Otel Reklamları'na uygun olması için aşağıdakilere sahip olması gerekir:
- Konukların ücret ödeyerek konaklayabileceği odalar
- Fiziksel varlık ve herkese açık sabit bir konum
- Sabit duvarlar ve sıhhi tesisat
- 7 günden uzun olmayan minimum konaklama süresi şartı
Genellikle Listing requirements
ölçütlerini karşılamadıkları için gemi seyahatleri ve apartmanlar, uygun olmayan tesislere örnek olarak verilebilir.
Kamp kulübeleri ve sabit duvarları, sıhhi tesisatı ve iklimlendirme sistemleri (odun sobaları veya propan ısıtıcılar dahil) bulunan diğer kamp yerleri uygundur. Uygun olmayan açık hava konaklama tesisleri şunlardır:
- Konukların çadırda kaldığı kamp alanları
- Konukların kendi karavanlarıyla geldiği karavan parkları
<listings>
<listings>
, bir otel listesinin kök öğesidir ve bir <language>
öğesi ve en az bir <listing>
içerir.
<listings>
öğesi, otel listesi XML hiyerarşisinde şu konumda görünür:
+ <listings>
+ <language>
+ <datum>
+ <listing>
Söz dizimi
<listings>
öğesi aşağıdaki söz dizimini kullanır:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
xsi:noNamespaceSchemaLocation="schema_xsd">
<language> language_code</language>
<datum> datum_code </datum>
<listing> listing</listing>
...
</listings>
Özellikler
<listings>
öğesi aşağıdaki özelliklere sahiptir:
Özellik | Zorunlu mu? | Açıklama |
---|---|---|
xmlns:xsi |
Zorunlu | http://www.w3.org/2001/XMLSchema-instance olarak ayarlayın. |
xsi:noNamespaceSchemaLocation |
Zorunlu | http://www.gstatic.com/localfeed/local_feed.xsd olarak ayarlayın. |
Alt öğeler
<listings>
öğesi aşağıdaki alt öğelere sahiptir:
Alt öğe | Zorunlu mu? | Tür | Açıklama |
---|---|---|---|
<language> | Required | string | Feed'inizin yazıldığı dildir. Bu öğenin değerini
iki harfli dil kodu olarak ayarlayın. Örneğin, İngilizce için en . |
<datum> | Optional | enum | Bu öğe, feed'de sağlanan enlem/boylam koordinatları için coğrafi veriyi veya referans modelini belirtir. Veri değeri sağlanmazsa bu öğe için varsayılan değer, çoğu modern GPS cihazı tarafından kullanılan WGS84 olur. Tokyo verisi yalnızca Japonya'daki adresler için geçerlidir.
Bu öğe için geçerli değerler şunlardır:
WGS84 değerini kullanmak için <datum> öğesini otel listesine eklemeyin.
|
<listing> | Required | <listing> |
Feed'deki her bir oteli açıklayan bir veya daha fazla giriştir. Listedeki her otelin, sitenize özgü bir kimliği olması gerektiğini ve bu kimliğin hiçbir zaman yeniden kullanılmaması gerektiğini unutmayın. |
Örnekler
Yapılandırılmış Adres
Aşağıdaki örnekte, yapılandırılmış bir adres içeren kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address format="simple">
<component name="addr1">6 Acacia Ave</component>
<component name="addr2">Floor 5</component>
<component name="city">London</component>
<component name="province">Greater London</component>
<component name="postal_code">SW1W 9TQ</component>
</address>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
Serbest Biçimli Adres
Aşağıdaki örnekte, serbest biçimli adres içeren kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
İsteğe Bağlı İçerik
Aşağıdaki örnekte, isteğe bağlı <content>
içeren bir girişin yer aldığı kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<listing>
Otel listesi <listings>
öğesindeki bir otel tanımı.
<listing>
öğesi, Otel Listesi Feed'i XML hiyerarşisinde şu konumda görünür:
+ <listings>
+ <language>
+ <listing>
Söz dizimi
<listing>
öğesi aşağıdaki söz dizimini kullanır:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<!-- Specify <listing>'s child elements in the order shown below. -->
<id>hotel_ID</id>
<name>hotel_name</name>
<address>
<component name="addr1">street_address_1</component>
<component name="addr2">street_address_2</component>
<component name="city">city_name</component>
<component name="province">province_name</component>
<component name="postal_code">postal_code</component>
</address>
<!-- You can also define an address freeform, although this is not recommended: -->
<!-- <address>freeform_address</address> -->
<country>country_code</country>
<latitude>hotel_latitude</latitude>
<longitude>hotel_longitude</longitude>
<phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>content</content>
</listing>
</listings>
Özellikler
<listing>
öğesinin özelliği yok.
Alt öğeler
<listing>
öğesi aşağıdaki alt öğelere sahiptir:
Alt öğe | Zorunlu mu? | Tür | Açıklama |
---|---|---|---|
<id> | Required | string | Otel için benzersiz bir tanımlayıcı.
Not: Bu değer, sitenize özgü olmalıdır. Kimlikleri yeniden kullanmayın. Bu durum, tesis eşleştirme sorunlarını çözmeye çalışırken sorunlara yol açabilir. |
<name> | Required | string | Otelin adı. Örneğin:
<name>Belgrave House</name> |
<address> | Required | Object or string | Otelin tam fiziksel konumu. Bu öğe, En azından, otelin açık adresini, şehri, eyaleti veya bölgeyi ve posta kodunu sağlamanız gerekir. Adresin aşağıdaki bölümlerinin her birini açıklamak için
Örneğin: <address format="simple"> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Floor 5</component> <component name="city">London</component> <component name="province">Greater London</component> <component name="postal_code">SW1W 9TQ</component> </address> Alternatif olarak "serbest biçimli" adres de sağlayabilirsiniz ancak bu önerilmez. Örneğin: <address>6 Elm Ave, Boston, MA, 02472</address> Posta kutularının veya sadece posta gönderilebilen adreslerin tam fiziksel adres olarak kabul edilmediğini unutmayın. |
<country> | Required | string | Bu girişin bulunduğu ülkedir. Bu değerin bir iki harfli ülke kodu olması gerekir.
Örneğin, Türkiye "TR", Yunanistan "GR"dir. Örneğin:
<country>US</country> |
<latitude> | Required* | float | Tesisin konumuna karşılık gelen enlem. Örneğin:
<latitude>37.423738</latitude> Bu değer, Google Maps API gibi coğrafi kodlama araçlarıyla oluşturulabilir. |
<longitude> | Required* | float | Tesisin konumuna karşılık gelen boylam. Örneğin:
<longitude>-122.090101</longitude> Bu değer, Google Maps API gibi coğrafi kodlama araçlarıyla oluşturulabilir. |
<location_precision> | Optional | integer | Tesis enlem ve boylamı gizlendiğinde tesis konumunun metre cinsinden gönderilen doğruluğudur. Sıfır (0), kod karartma olmadığı ve öğenin tam konum olduğu anlamına gelir. Not: Bu öğe yalnızca Kiralık Yerler için geçerlidir. |
<phone> | Required* | string | Otelin bir veya daha fazla iletişim numarasıdır. Giriş bir işletme şubesiyse lütfen şubeye özgü telefon numarasını belirtin (merkezi genel merkezinin telefon numarasını belirtmeyin).
Örneğin: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> En azından bir |
<category> | Optional | string | Tesisin türüdür (ör. otel). İş ortakları, tesislerini tanımlamak için sahip oldukları tüm dahili kategorileri (ör. "iş otelleri", "tatiller", "moteller" vb.) kullanabilir. |
<content> |
Optional | <content> |
Giriş için kullanılan isteğe bağlı ayrıntılar (ör. açıklama, puanlar ve tesis özellikleri). |
* Telefon numarası veya enlem/boylam gereklidir. Her ikisini de tanımlamanızı öneririz.
Örnekler
Yapılandırılmış Adres
Aşağıdaki örnekte, yapılandırılmış bir adres içeren kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address format="simple">
<component name="addr1">6 Acacia Ave</component>
<component name="addr2">Floor 5</component>
<component name="city">London</component>
<component name="province">Greater London</component>
<component name="postal_code">SW1W 9TQ</component>
</address>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
Serbest Biçimli Adres
Aşağıdaki örnekte, serbest biçimli adres içeren kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
İsteğe Bağlı İçerik
Aşağıdaki örnekte, isteğe bağlı <content>
içeren bir girişin yer aldığı kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<content>
Bir girişle ilgili puanlar ve yorumlar, imkanlar ve diğer ayrıntılar gibi bilgileri ekler. <content>
öğesi isteğe bağlıdır. <content>
içinde tüm alt öğeler isteğe bağlıdır.
<content>
öğesi, Otel Listesi Feed'i XML hiyerarşisinde şu konumda görünür:
+ <listings>
+ <language>
+ <listing>
+ <content>
Söz dizimi
<content>
öğesi aşağıdaki söz dizimini kullanır:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
<!-- Specify <text>'s child elements in the order shown below. -->
<text type="description">
<link>listing_link</link>
<title>listing_title</title>
<author>listing_author</author>
<body>listing_description</body>
<date month="MM" day="DD" year="YYYY"/>
</text>
<!-- 0 or more reviews: -->
<review type="[editorial|user]">
...
</review>
<!-- 0 or more attributes: -->
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
<client_attr name="custom_0">custom_attribute_0</client_attr>
<client_attr name="custom_1">custom_attribute_1</client_attr>
<client_attr name="custom_2">custom_attribute_2</client_attr>
<client_attr name="custom_3">custom_attribute_3</client_attr>
<client_attr name="custom_4">custom_attribute_4</client_attr>
<client_attr name="hotel_brand">hotel_brand</client_attr>
<client_attr name="num_reviews">number_of_reviews</client_attr>
<client_attr name="rating">aggregate_rating</client_attr>
</attributes>
<!-- a picture of the hotel or property-->
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main Hotel Picture</title>
</image>
</content>
</listing>
...
</listings>
Özellikler
<content>
öğesinin özelliği yok.
Alt öğeler
<content>
öğesi aşağıdaki alt öğelere sahiptir:
Alt öğe | Zorunlu mu? | Tür | Açıklama |
---|---|---|---|
<text |
Optional | Object | Sağlayıcının girişiyle ilişkili web sayfası. Aşağıdaki alt öğelere sahiptir:
Not: Bu öğeler yukarıdaki sırayla görünmelidir. |
<review |
Optional | <review> |
Girişin kullanıcı yorumunu veya editoryal yorumunu içerir. Girişinizde her iki türde de herhangi bir sayıda yorum bulunabilir. Bir tesisle ilgili tüm yorumları |
<attributes> | Optional | Object | Tesisle ilgili ayrıntıları sağlayan 0 veya daha fazla <client_attr name="attribute_name">attribute_value<client_attr> Alt öğelerin listesi ve açıklaması için Tüm
|
<image> | Optional | Object | Tekrarlanan etikettir. Ayrıntılı resim bilgileri içerir. |
Örnek
Aşağıdaki örnekte, <content>
öğesini içeren kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<review>
Kullanıcı yorumu veya editoryal yorum içerir. Bir girişle ilgili tüm yorumları <listing>
öğenize dahil etmeniz gerekmez. Bu öğenin amacı, bu girişin özelliklerini veya kalitesini gösteren seçili yorumları eklemenizdir.
<review>
öğesi, Otel Listesi Feed'i XML hiyerarşisinde şu konumda görünür:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
Söz dizimi
<review>
öğesi aşağıdaki söz dizimini kullanır:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
...
<!-- Specify <review>'s child elements in the order shown below. -->
<review type="editorial">
<link>review_link</link>
<title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
<author>review_author</author>
<rating>review_rating</rating>
<body>review_text</body>
<date>review_date</date>
<servicedate>review_servicedate</servicedate>
</review>
<review type="user">
<link>review_link</link>
<author>review_author</author>
<date month="MM" day="DD" year="YYYY"/> <!-- Date is for reviews of type "user" only -->
<servicedate month="MM" day="DD" year="YYYY"/> <!-- Service Date is for reviews of type "user" only -->
<rating>review_rating</rating>
<body>review_text</body>
</review>
</content>
</listing>
</listings>
Özellikler
<review>
öğesi aşağıdaki özelliklere sahiptir:
Özellik | Zorunlu mu? | Açıklama |
---|---|---|
type | Required | İncelemenin türü. Aşağıdaki değerlerden birine ayarlayın:
|
Alt öğeler
<review>
öğesi aşağıdaki alt öğelere sahiptir:
Alt öğe | Zorunlu mu? | Tür | Açıklama |
---|---|---|---|
<link> | Optional | string | Yorumun bağlantısı. Bu öğeye "http://" veya "https://" ekleyin. |
<title> | Optional | string | (Yalnızca editoryal yorumlar) Yorumun başlığı. |
<author> | Optional | string | Yorumun yazarıdır. Örneğin, "Suzan Vural". Bu, onaylanmamışsa yorumun göründüğü web sitesinin veya yayının adı da olabilir. |
<rating> | Optional | string | Yorumun puanını temsil eden, 0 ile 10 arasında (ikisi de dahil) kayan nokta cinsinden bir sayı. Örneğin, "8.9". |
<body> | Optional | string | Yorumun metni. Bu öğe HTML içermemelidir. |
<date month="MM" day="DD" year="YYYY"/> | Optional | Object | (Yalnızca kullanıcı yorumları) Yorumun tarihi. Bu öğenin aşağıdaki özellikleriyle belirtilir:
Örneğin, 7 Haziran 2023 şu şekilde yazılır: <date month="6" day="7" year="2023"/> |
<servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (Yalnızca kullanıcı yorumları) Yorumcunun, incelenen girişi ziyaret ettiği tarihtir. Biçim yukarıdaki <date> ile aynıdır.
Örneğin, 7 Haziran 2023 şu şekilde yazılır: <servicedate month="6" day="7" year="2023"/> <servicedate> için en azından ayın ve yılın doldurulmadığı yorumlar gösterilmeyebilir. Gün gerekli değildir. |
<title>
öğesinin, yalnızca yorumun type
öğesi editorial
olduğunda <review>
için geçerli bir alt öğe ve <date>
değerinin yalnızca type
değeri user
olduğunda geçerli olduğunu unutmayın.
Örnek
Aşağıdaki örnekte, editoryal yorum ve kullanıcı yorumu içeren bir girişin yer aldığı kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<attributes>
<attributes>
etiketi, tesisin sunduğu imkanları açıklamak ve tesisin puan ve yorumlarını sınıflandırmak için kullanılabilir.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
Alt öğeler
Alt öğe | Zorunlu mu? | Açıklama | |
---|---|---|---|
<website> | Optional | Otelin birincil web sitesidir. Öğe varsa ilk <client_attr> öğesinin önüne yerleştirilmelidir. Örnek:
<website>https://hotel.example.com</website> |
|
<client_attr name="attribute_name"> | Optional | Tesisin desteklenen
attribute_name veya
Kiralık Yerler için attribute_name kullanılarak belirtilebilen ek özelliği veya "özelliği"dir.
|
özellik_adı yer tutucusu için değerler
Aşağıdaki tabloda, <client_attr name="attribute_name"> öğesindeki attribute_name için geçerli değerler listelenmektedir.
attribute_name için değerler |
Açıklama | Geçerli içerik değerleri |
---|---|---|
alternate_hotel_id | Tesisiniz için alternatif bir tanımlayıcı. Feed bilgileriniz için bir tesis tanımlayıcısına ve rezervasyon motorunuz için başka bir tesis tanımlayıcısına ihtiyacınız varsa ayrı kimliklere sahip olmak yararlıdır. | Herhangi bir dize değeri |
custom_[0-4] | Herhangi bir dize türünde özel özelliktir. Bunlar kullanıcılara gösterilmez. | Herhangi bir dize değeri |
hotel_brand | Bu otelin ait olduğu marka. Örneğin, "Marriott" veya "Hilton". Bu ad kullanıcılara gösterilmez ancak otelleri gruplandırmak için kullanılabilir. | Herhangi bir dize değeri |
lodging | Lodging protokolünde bulunan tüm alanların kodlanmış temsili. |
Kodlanmış
Lodging protokolünün Base64 olarak kodlanmış dizesi |
num_reviews | Girişin yorum sayısıdır. | Negatif olmayan bir tam sayı. |
rating | Tesisin toplam puanını temsil eden kayan noktalı sayı. | Bu sayı genellikle 0-5, 0-10 veya 0-100 arasındadır ancak puan sisteminizi temsil eden herhangi bir aralığı kullanabilirsiniz. |
Kiralık Yerler için özellik_adı yer tutucusunun değerleri
Kiralık Yerlere özel özellikler ve XML örneğini inceleyin.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
Tesisin giriş kimliğinde gösterilmesi için resimler kullanılır. Kullanılan tüm resimler şu kurallara uygun olmalıdır:
- Resimler için önerilen en boy oranı 4:3'tür.
- Resim URL'sine Googlebot Resim tarayıcısı tarafından erişilebilmelidir.
Siteniz kök düzeyinde bir robots.txt dosyası içeriyorsa sitenin aşağıda gösterilen iki seçenekten birini içerdiğini doğrulayın:
Googlebot tarayıcısının, sitenizin içeriğini resimler dahil olacak şekilde taramasına olanak tanır.
- User-agent: Googlebot
- Allow: /
Googlebot-Image tarayıcısının sitenizdeki resimleri taramasına olanak tanır.
- User-agent: Googlebot-Image
- Allow: /
Resimlerin veya web sitelerinin ekran görüntülerine izin verilmez. Resimler orijinal ve gerçek resimler veya fotoğraflar olmalıdır.
Özellikler
- Resim bir reklam ise
"ad"
- Resim bir restoran menüsüyse
"menu"
- Resim işletmenin bir fotoğrafıysa
"photo"
Özellik adı | Zorunlu mu? | Biçim | Açıklama |
---|---|---|---|
type | Required | Text | Resim şunlardan biri olmalıdır: |
url | Required | Text | Tam boyutlu resmin URL'si. İlgili sayfada kullanılacak resmi belirtmek için url özelliğini kullanın. |
width | Required | A non-negative integer | Resmin piksel cinsinden genişliği (720 pikselden büyük olması önerilir) |
height | Required | A non-negative integer | Resmin piksel cinsinden yüksekliğidir (720 pikselden büyük olması önerilir) |
Alt öğeler
Alt öğe | Zorunlu mu? | Açıklama |
---|---|---|
<link> | İstenir ancak yerel fotoğraf girişleri için zorunludur. | Bu etiket, sitenizde ilgili resmin bulunduğu sayfanın geçerli ve güncel URL'sini içerir. Resmin URL'sini içermez.
Örnek:<link><http://www.example.com/magic_pizza/></link> |
<title> | İstek Tarihi | Bu etiket, resmin başlığını içerir. Örnek:
<title>"Luxury Apartment"</title> |
<author> | Zorunlu değil | İçeriği yazan kişinin adı. Değer, bir kullanıcı adı veya "Ad Soyadı" biçimindeki tam ad olabilir. |
<date> | Zorunlu | Bu etiket, içerik öğesinin oluşturulduğu tarihi tanımlar. Aşağıdaki örnekte olduğu gibi yıl, ay ve gün girmeniz gerekir: <date month="6" day="7" year="2023"/> |
Örnek
Aşağıdaki örnekte resim etiketleri içeren kısmi bir otel listesi gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<content>
<review>
</review>
<attributes>
</attributes>
<image type="photo" url="https://image_url" width="400" height="300">
<link>https://image_url</link>
<title>Apartment at Sandstone</title>
<author>Jessica Landlord</author>
<date month="6" day="7" year="2023"/>
</image>
</content>
</listing>
...
</listings>
Söz dizimi yönergeleri
XML tabanlı bir otel listesi oluştururken aşağıdaki yönergeleri kullanın:
Otel Listesi XML dosyalarınızı Google'ın XSD Şeması ile doğrulayın.
UTF-8 kodlamasını kullanın. Bu kodlama şemasını, aşağıdaki örneklerde gösterildiği gibi XML etiketinize
encoding
özelliğini ekleyerek belirtin.CDATA
bölümleriyle feed'inizde veri değerlerini belirtebilirsiniz.CDATA
bölümlerini kullanıyorsanız özel karakterleri kod dışında bırakmayın.URL'ler dahil olmak üzere
CDATA
bölümlerinde yer almayan veri değerleri için çıkış kodları kullanın. Bu özel karakterleri temsil etmek için varlık kodunu veya karakter kodunu kullanabilirsiniz. Aşağıdaki tabloda, kullanabileceğiniz yaygın varlık ve karakter kodları listelenmiştir:Karakter Varlık Karakter Kodu Ve işareti (&) & & Tek Tırnak İşareti (') ' ' Çift Tırnak İşareti (") " " Büyüktür (>) > > Küçüktür işareti (<) < < Veri içermeyen XML öğelerini dahil etmeyin. Örneğin, bir otelin enlem ve boylamı yoksa boş
<latitude/>
ve<longitude/>
öğeleri eklememelisiniz.XML öğelerinizde hiçbir koşulda (kod dışı bırakılmış olsa bile) HTML kullanmayın.
Yüklemeden önce feed'inizi doğrulamak için http://www.gstatic.com/localfeed/local_feed.xsd yerel feed XSD'sini kullanabilirsiniz.
Feed'inizde yorumlar kullanmak için yorumu aşağıdaki örnekte gösterildiği gibi
<!--
ve-->
etiketleriyle sarmalayın:<!-- This is a comment -->
Bir kullanıcı
<review>
içinde<date>
öğesini kapattığınızdan emin olun. Örneğin:<date day="2" month="12" year="2017"/>