การอ้างอิง XML ของข้อมูลโรงแรม

ข้อมูลโรงแรมคือไฟล์ XML อย่างน้อย 1 ไฟล์ที่แสดงรายการโรงแรมทั้งหมดที่คุณต้องให้ข้อมูลราคา โดยที่ไฟล์ข้อมูลโรงแรมนั้นจะไม่มีข้อมูลราคาอยู่

องค์ประกอบรูทของข้อมูลโรงแรมคือองค์ประกอบ <listings> ซึ่งมีองค์ประกอบ <listing> ที่อธิบายที่พักของคุณ

คุณจะสร้างข้อมูลโรงแรมซึ่งเป็นส่วนหนึ่งของการใช้งานเริ่มต้น แล้วเพิ่มหรือนําโรงแรมออกในฐานะส่วนหนึ่งของการบํารุงรักษาตามปกติ

ตรวจสอบว่าไฟล์เป็นไปตามหลักเกณฑ์ไวยากรณ์ เช่น ใช้การเข้ารหัส UTF-8 และระบุสคีมาการเข้ารหัสนี้โดยรวมแอตทริบิวต์ encoding ในแท็ก XML

หลังจากสร้างข้อมูลโรงแรมแล้ว ให้อัปโหลดข้อมูลไปยัง Google ด้วยตนเองโดยใช้ https://support.google.com/hotelprices/ หรือโฮสต์ข้อมูลไว้ในเซิร์ฟเวอร์ของคุณ

ค้นหาและแก้ไขปัญหาเกี่ยวกับข้อมูล

หากต้องการค้นหาและแก้ไขปัญหาเกี่ยวกับข้อมูลในข้อมูลโรงแรม โปรดดูบทความต่อไปนี้

ข้อกำหนดเกี่ยวกับข้อมูล

ที่พักในข้อมูลโรงแรมต้องมีข้อมูลต่อไปนี้จึงจะมีสิทธิ์ใช้ Google Hotel Ads

  • ห้องที่แขกที่ชำระเงินเข้าพักได้
  • มีสถานที่ตั้งจริงและสถานที่ตั้งตายตัวซึ่งเปิดให้สาธารณชนเข้าชม
  • มีผนังติดตั้งตายตัวและระบบประปา
  • ข้อกําหนดการเข้าพักขั้นต่ำต้องไม่เกิน 7 วัน

ตัวอย่างทั่วไปของที่พักที่ไม่มีสิทธิ์ ได้แก่ การล่องเรือและอพาร์ตเมนต์เนื่องจากมักจะไม่ตรงตามเกณฑ์ของ Listing requirements

กระท่อมสำหรับตั้งแคมป์และสถานที่ตั้งแคมป์อื่นๆ ที่มีผนังติดตั้งตายตัว ระบบประปา และระบบปรับอากาศ (รวมถึงเตาผิงหรือเครื่องทำความร้อนที่ใช้แก๊ส) ถือว่ามีสิทธิ์ใช้งาน ที่พักกลางแจ้งที่ไม่มีสิทธิ์ ได้แก่

  • พื้นที่ตั้งแคมป์ที่แขกพักในเต็นท์
  • ที่จอดรถบ้านที่แขกนำรถบ้านมาเอง

<listings>

<listings> เป็นองค์ประกอบรูทของข้อมูลโรงแรมและมีองค์ประกอบ <language> และมี <listing> อย่างน้อย 1 รายการ

องค์ประกอบ <listings> จะปรากฏในตำแหน่งต่อไปนี้ในลำดับชั้น XML ของข้อมูลโรงแรม

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

ไวยากรณ์

องค์ประกอบ <listings> ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="xsi"
    xsi:noNamesp>ace<SchemaLo>cation="s<chema_xsd>&qu<ot;
 > language la<nguage>_co<de/lang>uage
  d<atum dat>um_code< /datum
 > listing listing/listing
  ...
/listings

Attributes

องค์ประกอบ <listings> มีแอตทริบิวต์ต่อไปนี้

แอตทริบิวต์ จำเป็นหรือไม่ คำอธิบาย
xmlns:xsi ต้องระบุ ตั้งค่าเป็น http://www.w3.org/2001/XMLSchema-instance
xsi:noNamespaceSchemaLocation ต้องระบุ ตั้งค่าเป็น http://www.gstatic.com/localfeed/local_feed.xsd

องค์ประกอบลูก

องค์ประกอบ <listings> มีองค์ประกอบย่อยต่อไปนี้

องค์ประกอบย่อย จำเป็นหรือไม่ ประเภท คำอธิบาย
<language> Required string ภาษาที่ใช้เขียนฟีด กําหนดค่าขององค์ประกอบนี้เป็น รหัสภาษาแบบ 2 ตัวอักษร เช่น en สำหรับภาษาอังกฤษ
<datum> Optional enum องค์ประกอบนี้ระบุข้อมูลอ้างอิงทางภูมิศาสตร์หรือโมเดลอ้างอิงสำหรับ พิกัดละติจูด/ลองจิจูดที่ระบุในฟีด หากไม่ได้ระบุค่า Datum ไว้ ค่าเริ่มต้นขององค์ประกอบนี้คือ WGS84 ซึ่ง อุปกรณ์ GPS สมัยใหม่ส่วนใหญ่ใช้ Datum โตเกียวใช้ได้กับ ที่อยู่ในญี่ปุ่นเท่านั้น

ค่าที่ถูกต้องสำหรับองค์ประกอบนี้ ได้แก่

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
หมายเหตุ: หากต้องการใช้ค่าเริ่มต้นของ WGS84 อย่าใส่องค์ประกอบ <datum> ในรายการโรงแรม
<listing> Required <listing> อย่างน้อย 1 รายการที่อธิบายถึงแต่ละโรงแรมในฟีด โปรดทราบว่าแต่ละโรงแรมในข้อมูลต้องมีรหัสที่ไม่ซ้ำกันสำหรับเว็บไซต์ของคุณ และไม่ควรใช้รหัสนี้ซ้ำ

ตัวอย่าง

ที่อยู่แบบมีโครงสร้าง

ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีที่อยู่แบบมีโครงสร้าง

<?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" encodin>g<="UTF-8&>quo<t;?
lis>tings< ... 
  list<ing
   > !-- Specify listing's child elements in t>he or<de>r shown <bel>ow. -<-
  >  idhotel_<ID/id>
    <namehot>el_name</name
    address
    >  component name<="add>r1"<;street_address_1/comp>onent
      comp<onent name>="<addr2"street_add>ress_2/co<mponent
  >    com<ponent name="city&qu>ot;city_name/<component
>      c<omponent name="province>"provi<nce_name/c>ompon<ent
    >  com<ponent name="postal_code"postal_code/component
    /address
    !-- You> can <also< define> an address free<form, al>tho>ugh th<is is n>ot recommend<ed: --
 >   !-<- addres>sfreeform_addr<ess/addre>ss --<

    cou>ntrycountry_cod<e/country
>    l<atitudehotel_latitude/latitude
    longitud>ehotel_longi<tude/l>ongit<ude
    >phone< type=&qu>o<t;[fax|main|mobile|tdd|tollfree]"phone_number/phone
    >categ<oryhote>l/categ<ory !-- >You< can use> <whatever >property type categories you wish --
    contentcontent/content
  /listing
/listings

Attributes

องค์ประกอบ <listing> ไม่มีแอตทริบิวต์

องค์ประกอบลูก

องค์ประกอบ <listing> มีองค์ประกอบย่อยต่อไปนี้

องค์ประกอบย่อย จำเป็นหรือไม่ ประเภท คำอธิบาย
<id> Required string ตัวระบุที่ไม่ซ้ำกันสําหรับโรงแรม

หมายเหตุ: ค่านี้ต้องไม่ซ้ำกับเว็บไซต์ของคุณไม่ว่าเวลาใดก็ตาม อย่าใช้รหัสซ้ำเนื่องจากอาจทำให้เกิดปัญหาเมื่อพยายามแก้ไขปัญหาการจับคู่ที่พัก
<name> Required string ชื่อโรงแรม เช่น 
<name>Belgrave House</name>
<address> Required Object or string

ตําแหน่งที่ตั้งจริงของโรงแรม

องค์ประกอบนี้ใช้แอตทริบิวต์ format อย่างเดียว ซึ่งคุณต้องตั้งค่าเป็น simple

คุณต้องระบุที่อยู่ เมือง รัฐหรือภูมิภาค และรหัสไปรษณีย์ของโรงแรมเป็นอย่างน้อย ใช้องค์ประกอบย่อย <component> เพื่ออธิบายแต่ละส่วนของที่อยู่ดังต่อไปนี้

  • addr1: ที่อยู่หลักของโรงแรม
  • addr2: ที่อยู่สำรอง หากจำเป็น
  • addr3: ส่วนที่ 3 ของที่อยู่ หากจำเป็น
  • city: ชื่อเมืองที่โรงแรมตั้งอยู่
  • province: ชื่อของรัฐ ภูมิภาค หรือจังหวัดที่โรงแรมตั้งอยู่
  • postal_code: รหัสไปรษณีย์ของโรงแรม

เช่น

<address format="si>mpl<e"
  component na>me="add<r1"6 >Aca<cia Ave/component
  co>mponent< name=&quo>t;a<ddr2"Floor 5/com>ponent<
  compone>nt <name="city"Lond>on/component
 < component> na<me="province"Great>er Londo<n/componen>t<
  compo>nent name="postal_code"SW1W 9TQ/component
/address

คุณจะระบุที่อยู่เป็น "รูปแบบอิสระ" ก็ได้ แต่เราไม่แนะนำวิธีนี้ เช่น

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

โปรดทราบว่าตู้ ปณ. หรือที่อยู่ทางไปรษณีย์อื่นๆ สำหรับส่งจดหมายเพียงอย่างเดียวไม่ถือว่าเป็นที่อยู่จริง
<country> Required string ประเทศที่โรงแรมแห่งนี้ตั้งอยู่ ค่าต้องเป็นรหัสประเทศ 2 ตัวอักษร เช่น สหรัฐอเมริกาคือ "US" และแคนาดาคือ "CA" เช่น 
<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

หมายเลขติดต่อของโรงแรมอย่างน้อย 1 รายการ หากโรงแรมนี้เป็นสาขาหนึ่งของธุรกิจ โปรดระบุหมายเลขโทรศัพท์เฉพาะของสาขา (ไม่ใช่หมายเลขโทรศัพท์ของสำนักงานใหญ่ส่วนกลาง)

แอตทริบิวต์ type อาจเป็นค่าใดค่าหนึ่งต่อไปนี้

  • fax: หมายเลขโทรศัพท์เครื่องโทรสาร
  • main: หมายเลขโทรศัพท์หลัก
  • mobile: หมายเลขโทรศัพท์มือถือ
  • tdd: หมายเลขโทรศัพท์ของอุปกรณ์โทรคมนาคมสําหรับคนหูหนวก (TDD)
  • tollfree: หมายเลขโทรฟรี

เช่น

<!-- Singapore (country code +65) --&g<t;
phone type=&qu>ot;main"<+65 67>2<2-2323/phone
!-- U.S. (country <code +1) -->
>phone type=&quo<t;fax&>quot;+1 408-555-1111/phone

อย่างน้อยที่สุด คุณต้องระบุประเภท main
<category> Optional string ประเภทของที่พัก เช่น โรงแรม พาร์ทเนอร์จะใช้หมวดหมู่ภายในใดก็ได้เพื่ออธิบายลักษณะที่พัก เช่น "โรงแรมเพื่อธุรกิจ" "รีสอร์ต" "โมเต็ล" และอื่นๆ ที่คล้ายกัน
<content> Optional <content> รายละเอียดที่ไม่บังคับซึ่งใช้สำหรับข้อมูล เช่น คำอธิบาย คะแนน และจุดเด่นของที่พัก

* ต้องระบุหมายเลขโทรศัพท์หรือละติจูด/ลองจิจูด แต่เราขอแนะนำให้คุณระบุข้อมูลทั้ง 2 อย่าง

ตัวอย่าง

ที่อยู่แบบมีโครงสร้าง

ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีที่อยู่แบบมีโครงสร้าง

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot;
  languageen/<la>nguage
  listing
    !-- The value of id must be unique to your> site< f>or all< ti>me. D<o NO>T reuse IDs. -<-
   > id12<3abc/id
    nameBelgrav>e House</name
    address form>at="sim<ple"
>      c<omponent name="ad>dr1&quo<t;6 Acacia> Ave/co<mponent
      compone>nt nam<e="ad>dr2&quo<t;Floor 5/component
     > component nam<e="ci>ty"<;London/component
      comp>onent na<me="p>rovin<ce">Great<er Lond>on</compone>nt
  <    component nam<e="p>ostal<_code&quo>t;SW1W 9TQ/<component
>    /<address
    count>ryGB/country<
    l>atitu<de35.070>374/l<atitude
 > <  longitude-106.213648/longitude
    phone type="main&qu>ot;<123-456->7890/ph<one
    c>ategoryhotel/category !-- You can use whatever property type categories you wish --
  /listing
  ...
/listings

ที่อยู่รูปแบบอิสระ

ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีที่อยู่รูปแบบอิสระ

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot;
  languageen/<la>nguage
  listing
    !-- The value of id must be unique to your> site< f>or all< ti>me. D<o NO>T reuse IDs. -<-
   > id12<3abc/id>
    nameBelgrave House/name
    ad<dress6 E>lm Av<e Unit >3,< Boston,> MA, <02472/ad>dress
   < c>ountryUS/cou<ntry
    >latitude35.<070374/lat>itude<
    longitude-10>6.213648/lon<gitude>
    <phone ty>pe=&q<uot;main&>q<uot;123-456-7890/phone
    categoryhotel/category !-- You can> us<e whatev>er prop<erty type> categories you wish --
  /listing
  ...
/listings

เนื้อหาที่ไม่บังคับ

ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีข้อมูล <content> ที่ไม่บังคับ

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
  la<ngu>ageen</lan>guage
  list<ing
 >   id<123456/id
    nameMy Ap>artment</name
    address form>at="simple"<;
      co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
      component name=&q>uot;c<ity"L>os Ange<les/component
      compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
   <   component name<="pr>ovinc<e"CA>/component<
    /addr>ess
 <   country>US/country
    <latitu>de40.<730610/l>atitu<de
    lo>n<gitude-73.935242/longitude
    phone type="main"123>45678</phone
>    cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
>    conte<nt
  >    text type="descrip<tion&q>uot;
    <    >linkhttps://examplelisting.com/listings/12345/link
     <   title3 bedr<ooms with ocean views/title
        >bodySta<y in >this ne<wly renova>ted 3BR h<ouse wi>th ocean views./body
    <    date month=&q<uot;7" day="23&>quo<t; year=&quo>t;2023&<quot;/
    >  /text<
      attributes
        websitehttps://h>otel.exam<ple.>com/website
     <   client_attr< name>="rating"<;8.2/c>lient_a<ttr
  >    /<attribut>es
<      im>age typ<e="p>hoto" url="https://image_url"
        linkhttps://image_url/link
        titleMain hotel picture/title
      /image
    /content
  /listing
  ...
/listings

<content>

เพิ่มข้อมูลของโรงแรม เช่น คะแนน สิ่งอํานวยความสะดวก และรายละเอียดอื่นๆ องค์ประกอบ <content> เป็นค่าที่ไม่บังคับ องค์ประกอบย่อยทั้งหมดภายใน <content> เป็นค่าที่ไม่บังคับ

องค์ประกอบ <content> จะปรากฏในตำแหน่งต่อไปนี้ในลำดับชั้น XML ของฟีดข้อมูลโรงแรม

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

ไวยากรณ์

องค์ประกอบ <content> ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encodin>g<="UTF-8&>quo<t;?
lis>tings< ... 
 > listin<g
    conten<t
  >    !-- Specify text's child elements in t>he orde<r shown below. --
     > text typ<e=&q>uot;descript<ion&q>uot;
    <    <>/span>linklisting_li<nk/lin>k
       < titlelisting_title/<title
 >       au<thor>listing_author/auth<or
  >      bod<ylisting_description/body
        dat>e month<=&quo>t;MM&qu<ot; day="DD" year=>"Y<YYY"/>
      /t<ext
   >   !-- 0 or more attribut<es: --
 >     attr<ibutes
        websitehttps://hotel.e>xample.com/website<
        cli>ent_attr <name="alternate_hotel_id&>quot;altern<ate_hotel_id>/client_a<ttr
        client_attr n>ame="hotel_<brand"h>otel_br<and/client_>attr
  <      client_attr name="rating">;aggreg<ate_rating/client_attr
      /attributes
 >     !-- <a pi>cture of the hote<l or >property-<-
   >   image type=&quo<t;phot>o"< url=&>quot;<https://>ima<ge_url&q>uot;
  <      linkhttps://image_url/link
        titleMain Hotel Picture/title
      /image
    /content
  /listing
  ...
/listings

Attributes

องค์ประกอบ <content> ไม่มีแอตทริบิวต์

องค์ประกอบลูก

องค์ประกอบ <content> มีองค์ประกอบย่อยต่อไปนี้

องค์ประกอบย่อย จำเป็นหรือไม่ ประเภท คำอธิบาย
<text type="description"> Optional Object

หน้าเว็บที่เชื่อมโยงกับข้อมูลจากผู้ให้บริการ มีองค์ประกอบย่อยดังนี้

  • <link>: ลิงก์ไปยังคำอธิบาย รวม "http://" หรือ
    "https://" ในองค์ประกอบนี้ (ไม่บังคับ)
  • <title>: ชื่อคำอธิบาย (ไม่บังคับ)
  • <author>: ผู้เขียนคำอธิบาย (ไม่บังคับ)
  • <body>: เนื้อหาของคำอธิบาย (ต้องระบุ)
  • <date>: วันที่ของคำอธิบาย (ไม่บังคับ)

    • หมายเหตุ: องค์ประกอบเหล่านี้ต้องปรากฏตามลำดับด้านบน
<review type="[editorial|user]"> Optional <review>

มีรีวิวผู้ใช้หรือรีวิวบรรณาธิการของข้อมูล โดยจะมีรีวิวทั้ง 2 ประเภทกี่รายการก็ได้

คุณไม่จำเป็นต้องใส่รีวิวทั้งหมดสำหรับที่พักในองค์ประกอบ <listing> องค์ประกอบนี้มีไว้เพื่อให้คุณใส่รีวิวที่เลือกซึ่งแสดงจุดเด่นหรือคุณภาพของโรงแรม

ประเด็นสำคัญ: ควรส่ง <review> สำหรับบัญชีที่พักให้เช่าเท่านั้น โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) เพื่อขอข้อมูลเพิ่มเติม
<attributes> Optional Object

มีองค์ประกอบย่อย <client_attr> 0 รายการขึ้นไปที่มีรายละเอียดเกี่ยวกับที่พัก องค์ประกอบย่อยใช้ไวยากรณ์ต่อไปนี้

<client_attr name=&quot;attribute_>name"attri<bute_valuec>lient_attr

สําหรับข้อมูลและคำอธิบายขององค์ประกอบย่อย โปรดดู <attributes>

องค์ประกอบ <client_attr> ทั้งหมดเป็นค่าที่ไม่บังคับ

หากมีองค์ประกอบย่อย <website> จะต้องอยู่ก่อนองค์ประกอบ <client_attr>
<image> Optional Object แท็กซ้ำ มีข้อมูลรูปภาพโดยละเอียด

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีองค์ประกอบ <content>

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
  la<ngu>ageen</lan>guage
  list<ing
 >   id<123456/id
    nameMy Ap>artment</name
    address form>at="simple"<;
      co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
      component name=&q>uot;c<ity"L>os Ange<les/component
      compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
   <   component name<="pr>ovinc<e"CA>/component<
    /addr>ess
 <   country>US/country
    <latitu>de40.<730610/l>atitu<de
    lo>n<gitude-73.935242/longitude
    phone type="main"123>45678</phone
>    cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
>    conte<nt
  >    text type="descrip<tion&q>uot;
    <    >linkhttps://examplelisting.com/listings/12345/link
     <   title3 bedr<ooms with ocean views/title
        >bodySta<y in >this ne<wly renova>ted 3BR h<ouse wi>th ocean views./body
    <    date month=&q<uot;7" day="23&>quo<t; year=&quo>t;2023&<quot;/
    >  /text<
      attributes
        websitehttps://h>otel.exam<ple.>com/website
     <   client_attr< name>="rating"<;8.2/c>lient_a<ttr
  >    /<attribut>es
<      im>age typ<e="p>hoto" url="https://image_url"
        linkhttps://image_url/link
        titleMain 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 แบรนด์ของโรงแรม เช่น "Marriott" หรือ "Hilton" ซึ่งไม่ได้แสดงต่อผู้ใช้ แต่ใช้สำหรับการจัดกลุ่มโรงแรมได้ ค่าสตริงใดก็ได้
lodging การแสดงที่เข้ารหัสของฟิลด์ทั้งหมดที่มีใน Lodging proto สตริงที่เข้ารหัส Base64 ของ เข้ารหัส โปรโตคอล Lodging
num_reviews จำนวนรีวิวของโรงแรม

ประเด็นสำคัญ: ควรส่ง "num_reviews" สำหรับฟีด ที่พักให้เช่าเท่านั้น

 จำนวนเต็มใดๆ ที่ไม่เป็นลบ
rating จำนวนลอยตัวที่แสดงการจัดอันดับที่พักโดยรวม ตัวเลขนี้มักอยู่ระหว่าง 0-5, 0-10 หรือ 0-100 แต่คุณจะใช้ช่วงใดก็ได้ที่แสดงระบบการให้คะแนนของคุณ เช่น คะแนนของที่พักควรเป็น 3 หรือ 4 สำหรับ rating_scale ที่มีค่า 5

หมายเหตุ: หากไม่ได้ระบุไว้ rating_scale เริ่มต้นจะเป็น 0-10

ค่าสำหรับตัวยึดตำแหน่ง attribute_name ของที่พักให้เช่า

ดูแอตทริบิวต์และตัวอย่าง XML สำหรับที่พักให้เช่าโดยเฉพาะ

<image>

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

รูปภาพจะใช้เพื่อแสดงที่พักในรหัสโรงแรม รูปภาพทั้งหมดที่ใช้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้

  • สัดส่วนภาพที่แนะนำสำหรับรูปภาพคือ 4:3
  • โปรแกรม Crawl รูปภาพของ Googlebot ต้องเข้าถึง URL ของรูปภาพได้

  • หากเว็บไซต์มี robots.txt อยู่ที่ระดับรูท ให้ตรวจสอบว่าไฟล์มี 1 ใน 2 ตัวเลือกต่อไปนี้ตามที่แสดง

    1. อนุญาตให้ Crawler ของ Googlebot ทำการ Crawl เนื้อหาและรูปภาพในเว็บไซต์ของคุณ

      • User-agent: Googlebot
      • Allow: /

    2. โปรแกรมรวบรวมรูปภาพ Googlebot รวบรวมรูปภาพในเว็บไซต์ของคุณ

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

  • ไม่อนุญาตให้ใช้ภาพหน้าจอของรูปภาพหรือเว็บไซต์ รูปภาพที่ใช้ได้ต้องเป็นรูปหรือภาพถ่ายที่เป็นต้นฉบับที่แท้จริงเท่านั้น

Attributes

  • "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 Apart<ment&q>uot;/title
<author> ไม่จำเป็น ชื่อของผู้เขียนเนื้อหา ค่าอาจเป็นชื่อผู้ใช้หรือชื่อเต็มในรูปแบบ "ชื่อจริง นามสกุล"
<date> ต้องระบุ

แท็กนี้จะระบุวันที่สร้างรายการเนื้อหา คุณต้องป้อนปี เดือน และวันตามตัวอย่างต่อไปนี้

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงข้อมูลโรงแรมบางส่วนที่มีแท็กรูปภาพ

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot;
  l>anguage<en/language
  listing
    content
      image type="photo">; url=&qu<ot;h>ttps://image_url&<quot;> width=&q<uot;4>00" height="<300&qu>ot;
     <   linkhttps://image_u<rl/link>
        <titleApartment at Sandstone/title
 >       <author>Jessi<ca Landl>ord</author
>       < date mon>th="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 -->