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

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

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

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

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

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

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

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

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

ข้อความสอบถามราคา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เมื่อได้รับข้อความค้นหาข้อมูลเมตา คุณควรตอบกลับด้วยข้อความ <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

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

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

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 ที่ กำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ สำหรับข้อมูลเพิ่มเติม โปรดดู การกำหนดข้อมูลเมตาของห้องพักและแพ็กเกจ