ข้อความค้นหา

ข้อความค้นหาคือคำขอจาก Google สำหรับการอัปเดตราคาหรือข้อมูลเมตา โดยจะใช้กับวิธีการส่งข้อมูลราคาทั้งแบบพุลและแบบราคาที่มีการเปลี่ยนแปลง

องค์ประกอบรูทของข้อความค้นหาคือ <Query>

โครงสร้างของข้อความค้นหาจะขึ้นอยู่กับประเภทของข้อความ ดังนี้

• ราคา: Google จะส่งข้อความค้นหาที่ขออัปเดตราคาสำหรับโรงแรมที่ระบุ

• ข้อมูลเมตา: Google จะส่งข้อความค้นหาที่ขอข้อมูลเกี่ยวกับห้องพักและข้อมูลแพ็กเกจในโรงแรมที่ระบุ

คุณกำหนดปลายทางที่ Google ใช้สำหรับข้อความคำขอและคำขอข้อมูลราคาแบบเรียลไทม์ในระหว่างการกำหนดค่าเริ่มต้น โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) สำหรับข้อมูลเพิ่มเติม

Google จะส่งข้อความ Query เป็นคำขอ HTTP POST โดยตั้งค่าส่วนหัว Content-Type เป็น "application/xml" และตั้งค่าส่วนหัว User-Agent เป็น Google-HotelAdsPrices ข้อยกเว้นของกฎนี้จะเกิดขึ้นระหว่างการทดสอบการผสานรวมปลายทางราคาด้วยตนเองผ่าน Google-TravelAds-Live ตัวอย่างคำค้นหาเหล่านั้นอาจมีหรือไม่มีส่วนหัว User-Agent ก็ได้

ดูการจัดรูปแบบโดยละเอียดสำหรับข้อความค้นหาได้ในข้อมูลอ้างอิง XML ของการค้นหา

ข้อความค้นหาราคา

ข้อความค้นหาราคาระบุชุดค่าผสมของที่พักและแผนการเดินทางที่คุณระบุราคา

เมื่อเซิร์ฟเวอร์ได้รับข้อความค้นหาราคา เซิร์ฟเวอร์ควรตอบกลับด้วยข้อความ <Transaction> ที่มีข้อมูลราคาที่ขอ

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมราคา

ข้อความค้นหามี 3 ประเภทพิเศษ ได้แก่

1. ราคาแบบเรียลไทม์: หากเปิดใช้ ระบบจะส่งคำค้นหาเมื่อผู้ใช้กำลังเรียกดูราคาสำหรับที่พักหรือชุดแผนการเดินทางที่ระบุ และคุณมีกรอบเวลาที่ระบุเพื่อตอบกลับ

2. พร้อมบริบท: หากเปิดใช้ ระบบจะรวมคำแนะนำตามบริบทของผู้ใช้ไว้ใน คำค้นหาแต่ละรายการที่ Google ส่งให้คุณ และคำแนะนำจะแสดงถึงประเภทผู้ใช้ที่พบบ่อยที่สุดซึ่งค้นหาที่พักหรือการเดินทางที่กำหนด ร่วมกัน การทำตามคำแนะนำเหล่านี้อาจช่วยเพิ่มประสิทธิภาพของ คำตอบ

3. ข้อมูลเมตา: นี่คือคำขอรายละเอียดเกี่ยวกับห้องพักและแพ็กเกจสำหรับที่พักที่ระบุ

คำขอข้อมูลราคาแบบเรียลไทม์

คำขอข้อมูลราคาแบบเรียลไทม์คือคำขอจาก Google ให้อัปเดตราคาแบบเรียลไทม์เพื่อตอบสนองต่อการค้นหาของผู้ใช้ Google ได้รับคำขอค้นหาจากผู้ใช้สำหรับชุดค่าผสมโรงแรมหรือแผนการเดินทาง และเนื่องจากไม่มีข้อมูลราคาหรือข้อมูลราคาไม่ใช่ข้อมูลปัจจุบัน Google จึงขอให้อัปเดตราคาจากคุณในขณะที่ผู้ใช้ค้นหา เมื่อใช้การค้นหาราคาแบบเรียลไทม์ Google จะพยายามรับราคาและแสดงในผลการค้นหา ณ เวลาที่ค้นหา

คำขอค้นหาราคาแบบเรียลไทม์ทั้งหมดมีเวลาตอบกลับจำกัด ซึ่งโดยปกติจะอยู่ที่ 4,000 มิลลิวินาที ขีดจำกัดนี้ระบุไว้ในคำขอคำขอข้อมูลราคาแบบเรียลไทม์ หากไม่สามารถตอบกลับภายในเวลาที่กำหนดได้ คุณจะพลาดโอกาสในการเข้าร่วมโปรแกรมนั้นๆ อย่างไรก็ตาม เราขอแนะนำให้ระบุราคาอยู่ดีเพื่อให้ระบบแคชราคาและใช้สำหรับโอกาสในอนาคตได้ การเชื่อมต่อสำหรับคำตอบจะยังคงเปิดอยู่เป็นเวลา 10 นาทีหรือตามที่ระบุไว้ในการกำหนดค่าของพาร์ทเนอร์

คำขอข้อมูลราคาแบบเรียลไทม์ยังเป็นแบบอิงตามบริบทและสามารถดึงข้อมูลราคาสำหรับพารามิเตอร์ต่อไปนี้ได้ด้วย ได้แก่ ประเทศของผู้ใช้ ประเภทอุปกรณ์ อัตราการเข้าพัก (จำนวนแขก) และแขกเหล่านั้นเป็นผู้ใหญ่หรือเด็ก คำขอข้อมูลราคาแบบเรียลไทม์ช่วยให้คุณ แสดงราคาที่อัปเดตล่าสุดซึ่งตรงกับสิ่งที่ลูกค้าค้นหาได้

คำขอข้อมูลราคาแบบเรียลไทม์มีไว้เพื่อเป็นกลไกสำรองสำหรับการอัปเดตราคา กลไกหลักในการกำหนดราคาใหม่ยังคงเป็นการดึงข้อมูลราคาหรือราคาที่มีการเปลี่ยนแปลง การค้นหาราคาแบบเรียลไทม์ช่วยเติมเต็มช่องว่างในกรณีที่ Google ไม่มีราคาสำหรับชุดค่าผสมของโรงแรมหรือแผนการเดินทาง

กฎสำหรับการใช้คำขอข้อมูลราคาแบบเรียลไทม์

• ไม่มีข้อมูลที่แคชไว้สำหรับแผนการเดินทางที่ระบุเนื่องจากแผนการเดินทางที่ขอ ไม่ปกติ เช่น วันที่อยู่ในอนาคตที่ไกลเกินไป หรือมีการค้นหาโรงแรม ไม่บ่อยนัก

• วันที่ที่ขอเป็นวันที่ไม่ใช่ค่าเริ่มต้น

: หมายเหตุ: วันที่เริ่มต้นไม่มีสิทธิ์สำหรับคำขอข้อมูลราคาแบบเรียลไทม์ ระบบจะขอข้อมูลราคาแบบเรียลไทม์สำหรับวันที่ที่ไม่ใช่ค่าเริ่มต้นเท่านั้น

โดยปกติแล้ว Google จะแคชผลลัพธ์ของราคาแบบเรียลไทม์เพื่อไม่ให้มีการค้นหาโรงแรมหรือ แผนการเดินทางเดียวกันอีก โดยสามารถขอได้ทั้งชุดค่าผสมโรงแรมหรือแผนการจองเดียว รวมถึงชุดค่าผสมโรงแรมหลายแห่งหรือแผนการจองเดียว

ฟีเจอร์ราคาแบบเรียลไทม์พร้อมบริบทช่วยให้ Google ส่งคำขอข้อมูลราคาแบบเรียลไทม์ที่เฉพาะเจาะจงตามประเภทอุปกรณ์ของผู้ใช้ ประเทศที่ผู้ใช้ทำการค้นหา และจำนวนผู้เข้าพัก รวมถึงเด็ก ทั้งข้อความค้นหาและข้อความธุรกรรมได้รับการขยายให้รวมองค์ประกอบ <Context> ซึ่งกำหนดพารามิเตอร์การค้นหา ระบบจะแคชราคาที่ได้รับจากคำขอข้อมูลราคาแบบเรียลไทม์ที่มีบริบทเป็น RoomBundle ได้ หากเป็นราคาสำหรับอัตราการเข้าพักที่เฉพาะเจาะจง และเป็นราคาสำหรับลูกค้าที่เข้าเกณฑ์ หากเป็นราคาสำหรับประเทศของผู้ใช้หรืออุปกรณ์ของผู้ใช้

การค้นหาที่มีบริบท

การค้นหาบริบทคือคำขอปกติในการอัปเดตฐานข้อมูลสำหรับพร็อพเพอร์ตี้หรือการเดินทางที่ระบุ โดยจะมีรายการบริบทของผู้ใช้ ซึ่งเป็นที่นิยมสำหรับชุดค่าผสมเหล่านั้น หากใช้ราคาสำหรับลูกค้าที่เข้าเกณฑ์ การส่งราคาสำหรับบริบทของผู้ใช้ที่เป็นไปได้ทั้งหมดอาจมีค่าใช้จ่ายสูง ดังนั้นคุณจึงใช้รายการบริบทของผู้ใช้นี้เพื่อจำกัดการตอบกลับได้ การแสดงราคาสำหรับบริบทของผู้ใช้ที่ระบุเท่านั้น จะครอบคลุมคำค้นหาของผู้ใช้ที่เกี่ยวข้องส่วนใหญ่

หากสนใจรับคำค้นหาที่มีบริบท โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) โดยพาร์ทเนอร์จะยืนยันว่าคุณพร้อมรับข้อความดังกล่าว แล้วจึงปรับการกำหนดค่าเพื่อเริ่มส่งบริบทของผู้ใช้ ในการค้นหาให้คุณ

ข้อความการค้นหาข้อมูลเมตา

ข้อความค้นหาข้อมูลเมตามีรายละเอียดเกี่ยวกับข้อมูลห้องพักและแพ็กเกจสำหรับที่พักที่ระบุ

เมื่อได้รับข้อความค้นหาข้อมูลเมตา คุณควรตอบกลับด้วยข้อความ <Transaction> ที่ระบุราคาสำหรับที่พักที่ขอในองค์ประกอบ <Result>

ดูข้อมูลเพิ่มเติมได้ที่การกำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ

การค้นหาควบคุม

ส่วนนี้อธิบายวิธีควบคุมที่พักและแผนการเดินทาง ที่สามารถเป็นหัวข้อของข้อความการค้นหาจาก Google

ขอบเขตแผนการเดินทาง

คุณกำหนดขอบเขตที่เป็นไปได้ของการค้นหาราคาได้โดยใช้ <ItineraryCapabilities> คุณกำหนดกฎที่กำหนดช่วงวันที่ และระยะเวลาในการเข้าพักสูงสุดที่คุณรองรับ

คุณตั้งค่าเริ่มต้นสำหรับ <MaxAdvancePurchase> และ <MaxLengthOfStay> ซึ่งใช้กับชุดค่าผสมโรงแรมหรือแผนการเดินทางทั้งหมดได้ คุณยังกำหนดการตั้งค่าเหล่านี้สำหรับกลุ่มโรงแรมได้ด้วย

ตัวอย่างข้อความค้นหา

ส่วนนี้แสดงตัวอย่างข้อความการค้นหาราคาและข้อความการค้นหาข้อมูลเมตาหลายรายการ ดูตัวอย่างเพิ่มเติมได้ในการอ้างอิง XML ของการค้นหา

ตัวอย่างแผนการเดินทาง

ตัวอย่างต่อไปนี้แสดง <Query> ของราคาที่ขอให้อัปเดตราคา สำหรับโรงแรม 4 แห่ง ซึ่งมีห้องว่าง 3 คืนและเริ่มตั้งแต่วันที่ 23 พฤษภาคม 2023

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8&qu>ot;?
Query<
  Check>in2<023-05>-<23/Chec>kin<
  Nights3/N>ights<
  Prope>rtyL<ist
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Prop>e<rty
  >/PropertyList
/Query

ตัวอย่างนี้ขออัปเดตราคาสำหรับโรงแรมแต่ละแห่ง

5/23/18 - 6/26/18

ตัวอย่างการค้นหาราคาแบบเรียลไทม์

ตัวอย่างต่อไปนี้แสดงคำขอข้อมูลราคาแบบเรียลไทม์ที่มีเวลารับการตอบกลับ 500 มิลลิวินาที

<?xml version="1.0" encodin>g<="UTF-8"?
Query lat>e<ncySensitive="true"
!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a> Li<ve Pric>ing Query <request >--
<  Chec>k<in2023->05-<23/Checkin>
  <Nights2/Nig>h<ts
  DeadlineMs500/DeadlineMs
!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a> Li<ve Pricing Q>uery <request >--
  Pr<opertyLis>t
 <   Pro>perty678<1291/Property
  /PropertyList
!-- Note that Context tags> ar<e poten>t<ially repeatable --
  Context
!-- The total number of guests occupying> the <room (adu>l<ts+childre>n) --<
    Occupancy3/>Occupan<cy
    Oc>c<upancyDeta>i<ls
      NumAdults2/NumAdults
!-- In this example one of the >3 guest<s is a 5>yr old ch<ild --
      C>hildren<
        >Child< age="5">;</
      /Children
    /OccupancyDetails
!-- The user was locate>d in <the US when> t<his search w>a<s made --
    UserCountryUS/UserCountry
!-- The user was searching from >a mob<ile device> at th<e time of s>ear<ch --
  > < UserDevicemobile/UserDevice
  /Context
/Query

ตัวอย่างนี้ขอราคาสำหรับโรงแรม 1 แห่ง

6/23/23 - 6/25/23

ดูตัวอย่างการตอบกลับข้อความธุรกรรมสำหรับการค้นหานี้ได้ในการอ้างอิง XML ของราคาและห้องว่าง (ธุรกรรม)

ตัวอย่างการค้นหาที่มีบริบท

ตัวอย่างการค้นหาแบบมีบริบทมีดังนี้

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8&qu>ot;?
Query<
  Check>in2<023-05>-<23/Chec>kin<
  Nights2/Nights
 > Prop<ertyContextList>
    Pr<opertyCo>ntext
 <     Property867<5309/Property
      !-- In the future, device m>ight be< specif><ied --
    >  <ContextUserC><ountryUS>/UserCo<untry/C><ontext
    >  <ContextUserC><ountryGB>/User<Country/Context
>    /<PropertyContext>
    Pr<opertyCo>ntext
 <     Property867<5310/Pro>perty
 <     Property867<5311/Pr><operty
    >  <ContextUserC><ountryCA>/User<Country/Context
>   < /PropertyContext
  >/<Proper>tyContextList
/Query

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8&qu>ot;?
Query<
  Check>in2<025-07>-<10/Chec>kin<
  Nights2/Nights
 > Prop<ertyContextList>
    Pr<opertyCo>ntext
 <     Property867<5309/Pr>operty
  <    >Context
 <       UserCountryU<S/UserCo>untry
 <     /Cont<ext
      >Occupan<cy3/Occupancy
  >    Occup<ancyDetai>l<s
        >NumAdults<2/NumAdu>lts
       < Children
    >      Chi<ld age=&q>uot;7&q<uot;/
        /Ch>ildre<n
      /Occupan>cyDet<ails
    /Prope>rtyCont<ext
    >Propert<yContext
>      P<roperty>8675310/P<roperty
   >  < Context
   >     Us<erCountr>yGB/Use<rCountry
> <     /Context
   <   Occupa>ncy1/Occupancy
 <     Occup<ancyDetail>s
     <   NumAdul>ts1/NumAdult<s
      /Occupan>cyD<etails
    /Property>C<ontext>
  /PropertyContextList
/Query

โดยมี Context queries ที่ระบุบริบทประเทศของผู้ใช้เท่านั้น ในอนาคต คำค้นหาดังกล่าวอาจระบุอุปกรณ์ของผู้ใช้ด้วย

ช่วงวันที่เช็คอิน

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

ตัวอย่างต่อไปนี้แสดงข้อความ <Query> สำหรับช่วงวันที่เช็คอิน

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8">;?
Query
 < Fi>rstDate202<3-05-23/>FirstDate
<  LastDat>e20<23-05->2<6/LastD>ate<
  Nights3/N>ights<
  Prope>rtyL<ist
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Prop>e<rty
  >/PropertyList
/Query

ตัวอย่างนี้ขออัปเดตราคาสำหรับการเข้าพักต่อไปนี้ (สำหรับโรงแรมแต่ละแห่ง)

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

การเข้าพักตามช่วงเวลา

ตัวอย่างต่อไปนี้แสดงข้อความ <Query> เกี่ยวกับราคาสำหรับการเข้าพักตามช่วงเวลา

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8">;?
Query
 < Fi>rstDate202<3-05-23/>FirstDate
<  LastDat>e20<23-05-26/LastD>a<te
  AffectedNi>ght<s3/AffectedN>ights<
  Prope>rtyL<ist
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Prop>e<rty
  >/PropertyList
/Query

ตัวอย่างนี้ขออัปเดตราคาสำหรับโรงแรมแต่ละแห่ง

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

รวมถึงการเข้าพักที่เริ่มต้นก่อน (แต่รวมถึง) คืนที่ระบุ

5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

ข้อความค้นหาข้อมูลเมตา

ตัวอย่างต่อไปนี้แสดงข้อความ <Query> ที่ขออัปเดตข้อมูลเมตาสำหรับข้อมูลห้องพักและแพ็กเกจของที่พักหลายแห่ง

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8"?
Query
 > Hote<lInfoPro>pert<ies
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Property
  >/<HotelI>nfoProperties
/Query

คุณตอบกลับข้อความค้นหาประเภทนี้ด้วยข้อความ Transaction ที่กำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ ดูข้อมูลเพิ่มเติมได้ที่การกำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ