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

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

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

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

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

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

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

Google จะส่งข้อความค้นหาเป็นคำขอ POST ของ HTTP โดยตั้งค่าส่วนหัว 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 นาทีหรือตามที่ระบุไว้ในการกำหนดค่าของพาร์ทเนอร์

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ส่วนนี้แสดงตัวอย่างข้อความค้นหาราคาและข้อความค้นหาข้อมูลเมตาหลายรายการ ดูตัวอย่างเพิ่มเติมได้ใน การอ้างอิง 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, 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>

การค้นหาที่มีบริบทซึ่งรวมถึงอัตราการเข้าพัก

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </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>

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