مرجع ملف XML لقائمة الفنادق

قائمة الفنادق هي ملف واحد أو أكثر من ملفات XML التي تسرد جميع الفنادق التي ستوفّر معلومات الأسعار الخاصة بها. لا يحتوي ملف قائمة الفنادق نفسه على معلومات الأسعار.

العنصر الجذر لقائمة الفنادق هو العنصر <listings> الذي يحتوي على عناصر <listing> تصف أماكن الإقامة.

يمكنك إنشاء قائمة فنادق كجزء من عملية التنفيذ الأولية، ثم إضافة فنادق إليها أو إزالتها منها كجزء من الصيانة المنتظمة.

تأكَّد من أنّ ملفاتك تتوافق مع إرشادات بناء الجملة. على سبيل المثال، استخدِم ترميز UTF-8 وحدِّد مخطط الترميز هذا من خلال تضمين السمة encoding في علامة XML.

بعد إنشاء قائمة بالفنادق، يمكنك تحميلها يدويًا إلى Google باستخدام https://support.google.com/hotelprices/‎ أو استضافتها على الخادم.

العثور على مشاكل البيانات وحلّها

للعثور على مشاكل البيانات في قائمة الفنادق وحلّها، يُرجى الرجوع إلى المقالتَين التاليتَين:

متطلبات البيانات

للتأهُّل لعرض إعلانات الفنادق من Google، يجب أن يستوفي أحد المواقع في قائمة فنادقك المعايير التالية:

  • غرف تتيح إقامة النزلاء بمقابل مادي
  • مكان على أرض الواقع وموقع جغرافي ثابت ومفتوح للجمهور
  • الجدران الثابتة والسباكة
  • عدم تجاوز الحد الأدنى المطلوب للإقامة 7 أيام

تشمل الأمثلة الشائعة للمواقع غير المؤهّلة الرحلات البحرية والشقق لأنها عادةً لا تستوفي معايير Listing requirements.

تكون مقصورات التخييم وغيرها من مؤسسات التخييم التي تضم جدرانًا ثابتة وسباكة وأنظمة تحكّم في المناخ (بما في ذلك مواقد الحطب أو السخانات التي تعمل بالبروبان) مؤهَّلة. تشمل أماكن الإقامة الخارجية غير المؤهَّلة ما يلي:

  • مواقع التخييم، حيث يقيم الضيوف في خيام
  • بحات مركبات ترفيهية، حيث يحضر الضيوف مركباتهم الترفيهية

<listings>

‫<listings> هو العنصر الجذر لقائمة الفنادق، ويتضمّن عنصر <language> وعنصر <listing> واحدًا على الأقل.

يظهر العنصر <listings> في الموضع التالي في العرض الهرمي لملف XML الخاص بقائمة الفنادق:

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

البنية

يستخدم العنصر <listings> البنية التالية:

<?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>

السمات

يحتوي العنصر <listings> على السمات التالية:

السمة مطلوب؟ الوصف
xmlns:xsi مطلوب اضبط النوع على http://www.w3.org/2001/XMLSchema-instance.
xsi:noNamespaceSchemaLocation مطلوب اضبط النوع على http://www.gstatic.com/localfeed/local_feed.xsd.

العناصر الفرعية

يحتوي العنصر <listings> على العناصر الفرعية التالية:

العنصر الفرعي مطلوب؟ النوع الوصف
<language> Required string اللغة المستخدَمة في كتابة خلاصتك اضبط قيمة هذا العنصر على رمز لغة مكوّن من حرفَين. على سبيل المثال، en للغة الإنجليزية.
<datum> Optional enum يحدّد هذا العنصر نظام الإسناد الجيوديسي أو نموذج الإسناد الخاص بإحداثيات خطوط الطول والعرض المقدَّمة في الخلاصة. في حال عدم توفير قيمة بيانات، تكون القيمة التلقائية لهذا العنصر هي WGS84، وهي القيمة التي تستخدمها معظم أجهزة نظام تحديد المواقع العالمي (GPS) الحديثة. لا تنطبق بيانات طوكيو إلا على العناوين في اليابان.

القيم الصالحة لهذا العنصر هي:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
ملاحظة: لاستخدام القيمة التلقائية WGS84، لا تضمِّن العنصر <datum> في قائمة الفنادق.
<listing> Required <listing> إدخال واحد أو أكثر يصف كل فندق في الخلاصة يُرجى العِلم أنّ كل فندق في القائمة يجب أن يتضمّن معرّفًا فريدًا خاصًا بموقعك الإلكتروني، ويجب عدم إعادة استخدام هذا المعرّف مطلقًا.

أمثلة

عنوان منظَّم

يعرض المثال التالي قائمة فنادق جزئية تتضمّن عنوانًا منظَّمًا:

<?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>

العنوان بالشكل الحر

يعرض المثال التالي قائمة فنادق جزئية مع عنوان بالتنسيق الحر:

<?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>

المحتوى الاختياري

يعرض المثال التالي قائمة فنادق جزئية تتضمّن بيانات فندق تتضمّن <content> اختيارية:

<?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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>

تعريف فندق ضمن عنصر <listings> في قائمة فنادق

يظهر العنصر <listing> في الموضع التالي في العرض الهرمي لملف XML الخاص بخلاصة قوائم الفنادق:

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

البنية

يستخدم العنصر <listing> البنية التالية:

<?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>

السمات

لا يحتوي العنصر <listing> على أي سمات.

العناصر الفرعية

يحتوي العنصر <listing> على العناصر الفرعية التالية:

العنصر الفرعي مطلوب؟ النوع الوصف
<id> Required string معرّف فريد للفندق.

ملاحظة: يجب أن تكون هذه القيمة فريدة لموقعك الإلكتروني في جميع الأوقات. لا تعِد استخدام المعرّفات، لأنّ ذلك قد يتسبّب في حدوث مشاكل عند محاولة حلّ المشاكل المتعلّقة بمطابقة المواقع.
<name> Required string اسم الفندق. على سبيل المثال: 
<name>Belgrave House</name>
<address> Required Object or string

تمثّل هذه السمة الموقع الجغرافي الكامل للفندق.

يأخذ هذا العنصر سمة واحدة، وهي format، ويجب ضبطها على simple.

يجب توفير عنوان الشارع والمدينة والولاية أو المنطقة التي يقع فيها الفندق والرمز البريدي الخاص به كحدّ أدنى. استخدِم عناصر <component> الثانوية لوصف كل جزء من أجزاء العنوان التالية:

  • addr1: عنوان الشارع الأساسي للفندق.
  • ‫addr2: عنوان الشارع الثانوي، إذا لزم الأمر
  • ‫addr3: الجزء الثالث من عنوان الشارع، إذا لزم الأمر.
  • ‫city: اسم مدينة الفندق
  • province: تمثّل هذه السمة اسم المدينة أو المنطقة أو المقاطعة التي يقع فيها الفندق.
  • ‫postal_code: الرمز البريدي للفندق.

على سبيل المثال:

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

بدلاً من ذلك، يمكنك تقديم عنوان "حر"، ولكن لا يُنصح بذلك. على سبيل المثال:

<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>

يُرجى العلم أنّ صناديق البريد أو غير ذلك من العناوين المخصّصة للبريد فقط لا تُعتبر عناوين جغرافية كاملة.
<country> Required string البلد الذي تقع فيه هذه البطاقة. يجب أن تكون القيمة رمز بلد مكوّنًا من حرفَين. على سبيل المثال، رمز مصر هو "EG" والإمارات "AE". على سبيل المثال: 
<country>US</country>
<latitude> Required* float خط العرض الذي يمثّل الموقع الجغرافي للفندق ضمن البيانات. على سبيل المثال: 
<latitude>37.423738</latitude>

يمكن إنشاء هذه القيمة باستخدام أدوات ترميز المواقع الجغرافية، مثل Google Maps API.
<longitude> Required* float خط الطول الذي يمثّل الموقع الجغرافي للفندق ضمن البيانات. على سبيل المثال: 
<longitude>-122.090101</longitude>

يمكن إنشاء هذه القيمة باستخدام أدوات ترميز المواقع الجغرافية، مثل Google Maps API.
<location_precision> Optional integer تمثّل هذه السمة دقة الموقع الجغرافي للمكان المُرسَل بالمتر عندما يتم إخفاء خطوط الطول والعرض للمكان. يشير الرقم صفر (0) إلى عدم وجود تشويش وأنّ الموقع الجغرافي هو الموقع الدقيق. ملاحظة: ينطبق هذا العنصر على "أماكن الاستئجار" فقط.
<phone> Required* string

رقم هاتف واحد أو أكثر للفندق إذا كانت البطاقة خاصة بفرع من فروع النشاط التجاري، يُرجى تقديم رقم الهاتف الخاص بموقع الفرع (وليس رقم الهاتف الخاص بالمقر الرئيسي).

يمكن أن تكون السمة type إحدى القيم التالية:

  • ‫fax: رقم هاتف الفاكس.
  • ‫main: رقم الهاتف الصوتي الرئيسي
  • ‫mobile: رقم الهاتف الجوّال
  • ‫tdd: رقم هاتف جهاز تواصل للصم (TDD)
  • ‫tollfree: رقم هاتف مجاني

على سبيل المثال:

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

يجب تقديم main نوع على الأقل.
<category> Optional string تحدّد هذه السمة نوع المكان المخصّص للاستئجار، مثل فندق. يمكن للشركاء استخدام أي فئات داخلية لديهم لوصف أماكنهم المتاحة للاستئجار، مثل "فنادق أعمال" و"منتجعات" و"استراحات" وما شابه ذلك.
<content> Optional <content> تفاصيل اختيارية تُستخدَم في البطاقة، مثل الوصف والتقييمات وميزات المكان المخصّص للاستئجار

* يجب إدخال رقم هاتف أو خط الطول/العرض. ننصحك بتحديد كليهما.

أمثلة

عنوان منظَّم

يعرض المثال التالي قائمة فنادق جزئية تتضمّن عنوانًا منظَّمًا:

<?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>

العنوان بالشكل الحر

يعرض المثال التالي قائمة فنادق جزئية مع عنوان بالتنسيق الحر:

<?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>

المحتوى الاختياري

يعرض المثال التالي قائمة فنادق جزئية تتضمّن بيانات فندق تتضمّن <content> اختيارية:

<?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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>

تضيف هذه السمة معلومات حول مكان للاستئجار، مثل التقييمات ووسائل الراحة وغيرها من التفاصيل. العنصر <content> اختياري. ضمن <content>، جميع العناصر الفرعية اختيارية.

يظهر العنصر <content> في الموضع التالي في العرض الهرمي لملف XML الخاص بخلاصة قوائم الفنادق:

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

البنية

يستخدم العنصر <content> البنية التالية:

<?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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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>

السمات

لا يحتوي العنصر <content> على أي سمات.

العناصر الفرعية

يحتوي العنصر <content> على العناصر الفرعية التالية:

العنصر الفرعي مطلوب؟ النوع الوصف
<text type="description"> Optional Object

تمثّل هذه السمة صفحة الويب المرتبطة ببيانات مقدّم الخدمة. تتوفر به العناصر الفرعية التالية:

  • ‫<link>: رابط يؤدي إلى الوصف أدرِج "http://‎" أو
    "https://‎" في هذا العنصر (اختياري).
  • ‫<title>: تمثّل هذه السمة عنوان الوصف (اختيارية).
  • <author>: مؤلف الوصف (اختياري).
  • <body>: نص الوصف (مطلوب)
  • <date>: تاريخ الوصف (اختياري)

    • ملاحظة: يجب أن تظهر هذه العناصر بالترتيب المذكور أعلاه.
<review type="[editorial|user]"> Optional <review>

تحتوي هذه السمة على مراجعة كتبها مستخدم أو مراجعة تحريرية حول المكان المخصّص للاستئجار. يمكن أن تتضمّن بطاقة بياناتك أي عدد من المراجعات، سواء كانت من النوع الأول أو الثاني.

لست بحاجة إلى تضمين كل المراجعات الخاصة بمكان الإقامة في العنصر <listing>، بل يهدف هذا العنصر إلى السماح لك بتضمين مراجعات محدّدة توضّح ميزات أو جودة مكان الإقامة هذا.

نقطة أساسية: يجب إرسال <review> لحسابات أماكن الاستئجار فقط. يُرجى التواصل مع مدير الحساب التقني للحصول على مزيد من المعلومات.
<attributes> Optional Object

يحتوي على 0 أو أكثر من العناصر الفرعية <client_attr> التي تقدّم تفاصيل حول الموقع. تستخدم العناصر الفرعية البنية التالية:

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

للحصول على قائمة ووصف للعناصر الفرعية، يُرجى الرجوع إلى <attributes>.

جميع عناصر <client_attr> اختيارية.

إذا كان هناك عنصر ثانوي <website>، يجب وضعه قبل أي عنصر <client_attr>.
<image> Optional Object علامة مكرّرة تحتوي على معلومات تفصيلية عن الصورة

مثال

يعرض المثال التالي قائمة فنادق جزئية تتضمّن العنصر <content>:

<?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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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> لوصف وسائل الراحة المتوفرة في المكان المخصّص للاستئجار وتصنيف التقييمات الخاصة به.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <attributes>

العناصر الفرعية

العنصر الفرعي مطلوب؟ الوصف
<website> Optional الموقع الإلكتروني الأساسي للفندق. وفي حال توفّره، يجب وضعه قبل عنصر <client_attr> الأول. مثال: 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional تمثّل هذه السمة ميزة إضافية أو "سمة" للمكان المتاح للاستئجار يمكن تحديدها باستخدام attribute_name أو attribute_name المتوافقَين مع الأماكن المتاحة للاستئجار.

قيم العنصر النائب attribute_name

يسرد الجدول التالي القيم الصالحة لـ attribute_name في العنصر <client_attr name="attribute_name">.

قيم attribute_name الوصف قيم المحتوى الصالحة
alternate_hotel_id معرّف بديل لموقعك. من المفيد استخدام أرقام تعريف منفصلة إذا كنت بحاجة إلى معرّف موقع واحد لمعلومات خلاصتك ومعرّف موقع آخر لمحرّك الحجز. أي قيمة سلسلة
متوقّفة نهائيًا: أي سمة مخصّصة من نوع السلسلة ولا يتم عرضها للمستخدمين.

ملاحظة مهمة: يُرجى التواصل مع مدير الحساب الفني (TAM) إذا كنت تريد استخدام متغيرات CUSTOM.

 أي قيمة سلسلة
hotel_brand العلامة التجارية التي ينتمي إليها الفندق. على سبيل المثال، "ماريوت" أو "هيلتون". لا يتم عرض هذا المعرّف للمستخدمين، ولكن يمكن استخدامه لتجميع الفنادق. أي قيمة سلسلة
lodging تمثيل مشفّر لجميع الحقول المتاحة في Lodging proto. سلسلة مرمّزة باستخدام Base64 من البروتوكول المرمّز Lodging
num_reviews تمثّل هذه السمة عدد المراجعات الخاصة بالمكان المخصّص للاستئجار.

نقطة أساسية: يجب إرسال "num_reviews" لخلاصات "الأماكن المتاحة للاستئجار" فقط.

 أي عدد صحيح غير سالب
rating تمثّل هذه السمة عددًا عشريًا يمثّل تقييم السمة المجمّع. يتراوح هذا الرقم عادةً بين 0 و5 أو 0 و10 أو 0 و100، ولكن يمكنك استخدام أي نطاق يمثّل نظام التقييم الخاص بك. على سبيل المثال، يجب أن يكون تقييم المكان المخصّص للاستئجار 3 أو 4 إذا كانت قيمة rating_scale هي 5.

ملاحظة: مقياس التقييم التلقائي هو 0-10 إذا لم يتم تحديده.

قيم العنصر النائب attribute_name الخاص بالأماكن المخصّصة للاستئجار

يُرجى الرجوع إلى السمات الخاصة بالأماكن المتاحة للاستئجار ومثال XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

تُستخدَم الصور لعرض المكان المخصّص للاستئجار في معرّف بيانات المكان. يجب أن تتوافق جميع الصور المستخدَمة مع الإرشادات التالية:

  • نسبة العرض إلى الارتفاع المقترَحة للصور هي 4:3.
  • يجب أن يكون عنوان URL للصورة متاحًا لبرنامج الزحف "Googlebot للصور".

  • إذا كان موقعك الإلكتروني يتضمّن ملف robots.txt في المستوى الجذر، تأكَّد من أنّه يتضمّن أحد الخيارَين الموضّحَين أدناه:

    1. يسمح لبرنامج الزحف Googlebot بالزحف إلى محتوى موقعك الإلكتروني، بما في ذلك الصور.

      • User-agent: Googlebot
      • Allow: /

    2. يسمح لزاحف "Googlebot للصور" بالزحف إلى الصور على موقعك الإلكتروني.

      • User-agent: Googlebot-Image
      • Allow: /

  • لا يُسمح بلقطات الشاشة للصور أو المواقع الإلكترونية. يجب أن تكون الصور أصلية وفعلية أو فوتوغرافية.

السمات

  • ‫"ad" إذا كانت الصورة إعلانًا
  • "menu" إذا كانت الصورة لقائمة طعام في مطعم
  • "photo" إذا كانت الصورة عبارة عن صورة للنشاط التجاري
اسم السمة مطلوب؟ التنسيق الوصف
type Required Text

يجب أن تكون الصورة واحدة مما يلي:
url Required Text تمثّل هذه السمة عنوان URL للصورة بالحجم الكامل. استخدِم السمة url لتحديد الصورة التي سيتم استخدامها على تلك الصفحة.
width Required A non-negative integer عرض الصورة بالبكسل (يُنصح بأن يكون أكبر من 720 بكسل)
height Required A non-negative integer ارتفاع الصورة بالبكسل (يُنصح بأن يكون أكثر من 720 بكسل)

العناصر الفرعية

العنصر الفرعي مطلوب؟ الوصف
<link> مطلوب، ولكنّه إلزامي لبيانات الصور المحلية. تحتوي هذه العلامة على عنوان URL صالح وحديث للصفحة على موقعك الإلكتروني التي تظهر فيها الصورة ذات الصلة. لا يحتوي على عنوان URL الخاص بالصورة نفسها. مثال:
<link><http://www.example.com/magic_pizza/></link>
<title> تاريخ الطلب تحتوي هذه العلامة على عنوان الصورة. مثال: 
<title>"Luxury Apartment"</title>
<author> غير مطلوب تمثّل هذه السمة اسم مؤلف المحتوى. يمكن أن تكون القيمة إما اسم مستخدم أو اسمًا كاملاً بالتنسيق "الاسم الأول اسم العائلة".
<date> مطلوب

تحدّد هذه العلامة تاريخ إنشاء عنصر المحتوى. يجب إدخال السنة والشهر واليوم، كما في المثال التالي:

<date month="6" day="7" year="2023"/>

مثال

يعرض المثال التالي قائمة جزئية بالفنادق مع علامات الصور:

<?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>

إرشادات حول البنية

عند إنشاء قائمة فنادق بتنسيق XML، اتّبِع الإرشادات التالية:

  • تحقَّق من صحة ملفات XML الخاصة بقوائم الفنادق باستخدام مخطط XSD من Google.

  • استخدِم ترميز UTF-8. حدِّد مخطط الترميز هذا من خلال تضمين السمة encoding في علامة XML، كما هو موضّح في الأمثلة أدناه.

  • يمكنك تحديد قيم البيانات في خلاصتك باستخدام أقسام CDATA. إذا كنت تستخدم أقسام CDATA، لا تتجنّب الرموز الخاصة.

  • استخدِم رموز إلغاء لقيم البيانات التي لا تندرج ضمن أقسام CDATA، بما في ذلك عناوين URL. يمكنك استخدام رمز الكيان أو رمز الحرف لتمثيل هذه الرموز الخاصة. يسرد الجدول التالي رموز الكيانات والأحرف الشائعة التي يمكنك استخدامها:

    حرف الكيان رمز الحرف
    علامة العطف (&) &amp; &#38;
    علامة الاقتباس المفردة (') &apos; &#39;
    علامة الاقتباس المزدوجة (") &quot; &#34;
    أكبر من (>) &gt; &#62;
    أصغر من (<) &lt; &#60;

  • احذف عناصر XML التي لا تحتوي على بيانات. على سبيل المثال، إذا لم تتوفّر لديك خطوط الطول والعرض الخاصة بفندق، عليك عدم تضمين العنصرَين الفارغَين <latitude/> و<longitude/>.

  • لا تستخدم HTML في عناصر XML تحت أي ظرف من الظروف (حتى إذا تم تجاهل بعض الرموز).

  • للتحقّق من صحة خلاصتك قبل تحميلها، يمكنك استخدام ملف XSD الخاص بالخلاصة المحلية http://www.gstatic.com/localfeed/local_feed.xsd.

  • لاستخدام التعليقات في خلاصتك، ضع التعليق بين علامتَي <!-- و-->، كما هو موضّح في المثال التالي:

    <!-- This is a comment -->