หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

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

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

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

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

ข้อความค้นหาเกี่ยวกับราคา

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

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

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

ข้อความค้นหาพิเศษมี 3 ประเภทดังนี้

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

การค้นหาราคาแบบเรียลไทม์

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

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

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

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

กฎในการใช้การค้นหาราคาแบบเรียลไทม์

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

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

5/23/18 - 6/26/18

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

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

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="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 Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

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

6/23/23 - 6/25/23

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

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

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

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

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

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

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

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

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </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" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </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" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

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