Otel Listesi XML Referansı

Otel listesi, fiyat bilgilerini gireceğiniz 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 kurallarına 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 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 makalelere bakın:

Listeleme şartları

Otel listenizdeki bir tesisin Google Otel Reklamları'na uygun olması için aşağıdakileri içermesi 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ından, gemi turlarını ve apartman dairelerini uygun olmayan tesislere örnek olarak verebiliriz.

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 uygun tesislerdir. Uygun olmayan açık hava konaklama tesisleri şunlardır:

  • Konukların çadırlarda 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 şu 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 şu ö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 bir dil koduna ayarlayın. Örneğin, İngilizce için en.
<datum> Optional enum Bu öğe, feed'de sağlanan enlem/boylam koordinatları için jeodezik datumu veya referans modelini belirtir. Referans noktası değeri belirtilmezse bu öğenin varsayılan değeri WGS84 olur. Bu değer, çoğu modern GPS cihazı tarafından kullanılır. Tokyo datumu yalnızca Japonya'daki adresler için geçerlidir.

Bu öğe için geçerli değerler şunlardır:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
Not: WGS84 değerinin varsayılan 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ış 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 Unit 3, 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ı bir <content> öğesi içeren 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ıdır.

<listing> öğesi, Otel Listesi Feed'i XML hiyerarşisinde şu konumda görünür:

+ <listings>
    + <language>
    + <listing>

Söz dizimi

<listing> öğesi şu 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 yoktur.

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, siteniz için her zaman benzersiz olmalıdır. Kimlikleri yeniden KULLANMAYIN. Aksi takdirde tesis eşleşmesi sorunlarını çözmeye çalışırken sorunlar oluşabilir.

<name> Required string Otelin adı. Örneğin:
<name>Belgrave House</name>
<address> Required Object or string

Otelin tam fiziksel konumudur.

Bu öğe, simple olarak ayarlamanız gereken tek bir özellik (format) alır.

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 <component> alt öğelerini kullanın:

  • addr1: Otelin birincil açık adresi.
  • addr2: Gerekirse ikincil açık adres.
  • addr3: Gerekirse açık adresin üçüncü kısmı.
  • city: Otelin bulunduğu şehrin adı.
  • province: Otelin bulunduğu eyaletin, bölgenin veya ilçenin adı.
  • postal_code: Otelin posta kodu.

Ö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 Unit 3, 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ğer, iki harften oluşan ülke kodu olmalıdır. Ö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), gizleme olmadığı ve bunun 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 (işletme merkezinin telefon numarasını belirtmeyin).

type özelliği aşağıdakilerden biri olabilir:

  • fax: Faks numarası.
  • main: Ana telefon numarası.
  • mobile: Cep telefonu numarası.
  • tdd: İşitme Engelliler için İletişim Cihazı (TDD) telefon numarası.
  • tollfree: Ücretsiz telefon numarası.

Ö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 main türü girmeniz gerekir.

<category> Optional string Tesisin türü (ör. otel). İş ortakları, tesislerini tanımlamak için sahip oldukları her türlü dahili kategoriyi (ör. "iş oteli", "tatil köyü", "motel") kullanabilir.
<content> Optional <content> Giriş için kullanılan isteğe bağlı ayrıntılardır (ö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ış 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 Unit 3, 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ı bir <content> öğesi içeren 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 şu 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 yoktur.

Alt öğeler

<content> öğesi aşağıdaki alt öğelere sahiptir:

Alt öğe Zorunlu mu? Tür Açıklama
<text type="description"> Optional Object

Sağlayıcıdan gelen girişle ilişkilendirilmiş web sayfasıdır. Aşağıdaki alt öğelere sahiptir:

  • <link>: Açıklamanın bağlantısıdır. Bu öğeye "http://" veya
    "https://" ekleyin (isteğe bağlı).
  • <title>: Açıklamanın başlığıdır (isteğe bağlı).
  • <author>: Açıklamanın yazarıdır (isteğe bağlı).
  • <body>: Açıklamanın gövdesidir (zorunlu).
  • <date>: Açıklamanın tarihidir (isteğe bağlı).
  • Not: Bu öğeler yukarıdaki sırayla görünmelidir.

<review type="[editorial|user]"> Optional <review>

Girişin kullanıcı yorumunu veya editoryal yorumunu içerir. Girişinizde her iki türde de herhangi bir sayıda yorum olabilir.

Bir tesis için yapılan tüm yorumları <listing> öğenize dahil etmeniz gerekmez. Bu öğenin amacı, bu girişin özelliklerini veya kalitesini gösteren seçili yorumları eklemenizdir.

<attributes> Optional Object

Tesisle ilgili ayrıntıları sağlayan 0 veya daha fazla <client_attr> alt öğesi içerir. Alt öğeler aşağıdaki söz dizimini kullanır:

<client_attr name="attribute_name">attribute_value<client_attr>

Alt öğelerin listesi ve açıklaması için <attributes> bölümüne bakın.

Tüm <client_attr> öğeleri isteğe bağlıdır.

<website> alt öğesi varsa herhangi bir <client_attr> öğesinin önüne yerleştirilmelidir.

<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ş için yapılan 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 şu 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 şu özelliklere sahiptir:

Özellik Zorunlu mu? Açıklama
type Required Yorum türü. Aşağıdaki değerlerden birine ayarlayın:
  • editorial: Web sitesi veya başka bir inceleme yetkilisinin yorumudur.
  • user: Son kullanıcının yorumudur.

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ıdır. Bu öğeye "http://" veya "https://" ekleyin.
<title> Optional string (Yalnızca editoryal yorumlar) Yorumun başlığıdır.
<author> Optional string Yorumun yazarıdır. Örneğin, "Selin Toprak". Bu aynı zamanda, yorumun isimsiz olması durumunda gösterildiği bir web sitesinin veya yayının adı da olabilir.
<rating> Optional string Yorumun puanını temsil eden, 0-10 (bu sayılar dahil) arasındaki bir kayan noktalı sayıdır. Örneğin, "8,9".
<body> Optional string Yorumun metnidir. Bu öğe HTML içermemelidir.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Yalnızca kullanıcı yorumları) Yorumun tarihidir. Bu öğenin aşağıdaki özellikleriyle belirtilir:
  • day: Ayın günüdür, örneğin, "7".
  • month: 1 = Ocak, 12 = Aralık olmak üzere ayı belirten sayıdır.
  • year: Dört haneli yıldır, örneğin,"2023".

Ö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 olduğunu ve <date> değerinin yalnızca type öğesi 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. Bu öğe varsa ilk <client_attr> öğesinden önce yer alması gerekir. Ö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 niteliği veya "özelliği"dir.

attribute_name yer tutucusunun değerleri

Aşağıdaki tabloda <client_attr name="attribute_name"> öğesi için geçerli olan attribute_name değerleri 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] Dize türündeki özel özellikler. 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 proto dosyasında bulunan tüm alanların kodlanmış temsili. Kodlanmış Lodging protonun Base64 kodlu dizesi
num_reviews Girişin yorum sayısıdır. Negatif olmayan bir tam sayı.
rating Tesisin ortalama puanını temsil eden bir kayan noktalı sayıdır. Bu sayı genellikle 0-5, 0-10 veya 0-100 arasındadır ancak puan sisteminizi temsil eden herhangi bir aralığı kullanabilirsiniz. Örneğin, rating_scale değeri 5 olan bir tesisin puanı 3 veya 4 olmalıdır.

Not: rating_scale belirtilmezse varsayılan değer 0-10'dur.

Kiralık Yerler için attribute_name yer tutucusunun değerleri

Kiralık yerlere özgü özellikler ve XML örneği başlıklı makaleyi 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:

    1. Googlebot tarayıcısının, sitenizin içeriğini resimler dahil olacak şekilde taramasına olanak tanır.

      • User-agent: Googlebot
      • Allow: /
    2. 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 aşağıdaki türlerden birinde olmalıdır:

url Required Text Tam boyutlu resmin URL'sidir. İlgili sayfada kullanılacak resmi belirtmek için url özelliğini kullanın.
width Required A non-negative integer Resmin piksel cinsinden genişliğidir (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 alakalı 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ıdır. 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 kuralları

XML tabanlı bir otel listesi oluştururken aşağıdaki kuralları izleyin:

  • Otel listesi XML dosyalarınızı Google'ın XSD şemasıyla 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ğerleri belirtebilirsiniz. CDATA bölümlerini kullanıyorsanız özel karakteri kod dışında bırakmayın.

  • URL'ler dahil olmak üzere, CDATA bölümlerinde bulunmayan 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 (&) &amp; &#38;
    Tek tırnak işareti (') &apos; &#39;
    Çift tırnak işareti (") &quot; &#34;
    Büyüktür işareti (>) &gt; &#62;
    Küçüktür işareti (<) &lt; &#60;
  • Veri içermeyen XML öğeleri kullanmayın. Örneğin, bir otel için enlem ve boylam bilginiz 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 --> etiketleri arasına yerleştirin:

    <!-- 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"/>