Method: accounts.properties.ingestLosPropertyPrices

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

คำขอ HTTP

POST https://travelpartnerprices.googleapis.com/v1/{propertyPrices.property=accounts/*/properties/*}:ingestLosPropertyPrices

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
propertyPrices.property

string

ชื่อทรัพยากรของ PropertyPrices มีรูปแบบ accounts/{account_id}/properties/{property_id}

account_id: ค่าสตริงนี้คือ "รหัสบัญชี" ที่แสดงในหน้าการตั้งค่าบัญชีใน Hotel Center

property_id: ค่าขององค์ประกอบนี้ต้องเป็นสตริงที่ตรงกับรหัสข้อมูลในฟีดข้อมูลโรงแรม

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
ช่อง
requestTime

string (Timestamp format)

ต้องระบุ ช่วงเวลาขณะที่มีการส่งข้อความราคา LoS ซึ่งแสดงเป็นสตริงที่มีรูปแบบ RFC 3339

ระบบจะประมวลผลข้อความที่ส่งด้วย requestTime ภายใน 24 ชั่วโมงก่อนหน้าและจะทิ้งข้อความที่ไม่ได้ทิ้งไว้

ระบบจะประมวลผลข้อความตามลำดับ requestTime ไม่ว่าจะได้รับข้อความในลำดับใด เช่น ระบบจะทิ้งการอัปเดตราคาที่มี requestTime เป็น 2019-05-03T14:09:00Z ที่ได้รับหลังจากข้อความสำหรับแผนการเดินทางเดียวกันที่มี requestTime เป็น 2019-05-03T14:10:00Z เพื่อใช้ข้อความที่มีการประทับเวลาในภายหลังแทน

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

ราคาสำหรับวันที่เข้าพัก ราคาทั้งหมดภายในarrivalDayPricesนี้จะใช้กับที่พักหนึ่งๆ แต่วันที่เข้าพักต่างกัน

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ PropertyPrices

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/travelpartner

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

LosPropertyPrices

ราคาระยะเวลาในการเข้าพัก ระบุที่ระดับที่พัก

การแสดง JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
ช่อง
arrivalDatePrices[]

object (LosArrivalDatePrices)

ราคาสำหรับวันที่เข้าพัก ราคาทั้งหมดภายในarrivalDayPricesนี้จะใช้กับที่พักหนึ่งๆ แต่วันที่เข้าพักต่างกัน
property

string

ชื่อทรัพยากรของ PropertyPrices มีรูปแบบ accounts/{account_id}/properties/{property_id}

account_id: ค่าสตริงนี้คือ "รหัสบัญชี" ที่แสดงในหน้าการตั้งค่าบัญชีใน Hotel Center

property_id: ค่าขององค์ประกอบนี้ต้องเป็นสตริงที่ตรงกับรหัสข้อมูลในฟีดข้อมูลโรงแรม

LosArrivalDatePrices

ราคาระยะเวลาในการเข้าพัก ซึ่งจัดกลุ่มตามช่วงวันที่เข้าพัก

การแสดง JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
ช่อง
productPrices[]

object (LosProductPrices)

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

object (Date)

ระบบจะใช้productPricesกับวันที่เข้าพักทั้งหมดระหว่างวันที่ startDate ถึง endDate ด้วย

หากพยายามระบุวันที่มาถึงเพียงวันเดียว (ไม่ใช่ช่วง) ระบบอาจละเว้น endDate
endDate

object (Date)

ระบบจะใช้productPricesกับวันที่เข้าพักทั้งหมดระหว่างวันที่ startDate ถึง endDate ด้วย

หากพยายามระบุวันที่มาถึงเพียงวันเดียว (ไม่ใช่ช่วง) ระบบอาจละเว้น endDate

วันที่

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

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ไม่ใช่ 0
  • 1 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
  • ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
  • 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง:

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี
month

integer

เดือนของปี ต้องมีค่าตั้งแต่ 1 ถึง 12 หรือ 0 เพื่อระบุปีที่ไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และจะใช้ได้สำหรับปีและเดือน หรือ 0 เพื่อระบุปีเพียงอย่างเดียว หรือ 1 ปีและเดือนที่วันไม่มีนัยสำคัญ

LosProductPrices

ราคาระยะเวลาในการเข้าพัก ซึ่งจัดกลุ่มตามประเภทผลิตภัณฑ์ (ชุดค่าผสมroomTypeId/ratePlanId)

การแสดง JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
ช่อง
occupancyPrices[]

object (LosOccupancyPrices)

ราคาสำหรับอัตราการเข้าพัก ราคาทั้งหมดภายในoccupancyPricesนี้จะใช้กับที่พักที่เฉพาะเจาะจง วันที่มาถึง ชุดค่าผสมของผลิตภัณฑ์ แต่จะใช้กับอัตราการเข้าพักที่แตกต่างกัน
roomTypeId

string

รหัสที่ไม่ซ้ำกันของห้องพักที่ใช้ราคานี้ ใช้รหัสนี้เพื่อจับคู่ข้อมูลแพ็กเกจห้องพักกับข้อมูลที่คุณส่งในข้อมูลห้องพัก ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเมตาของแพ็กเกจห้องพัก

หากมีการป้อนข้อมูล roomTypeId แล้ว จะต้องป้อนข้อมูล ratePlanId ด้วย
ratePlanId

string

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

หากมีการป้อนข้อมูล ratePlanId แล้ว จะต้องป้อนข้อมูล roomTypeId ด้วย

LosOccupancyPrices

ราคาระยะเวลาในการเข้าพัก ซึ่งจัดกลุ่มตามจำนวนอัตราการเข้าพักของผู้ใหญ่

การแสดง JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
ช่อง
prices[]

object (LosPrices)

ราคาระยะเวลาในการเข้าพัก ราคาทั้งหมดภายใน prices จะมีผลกับชุดค่าผสมของที่พัก วันที่มาถึง ผลิตภัณฑ์ และอัตราการเข้าพัก
adults

integer

จำนวนแขกสูงสุดที่จองได้ต่อห้อง รวมถึงผู้ใหญ่และเด็ก ค่านี้จะกำหนดไว้สำหรับราคาทั้งหมดภายในช่อง occupancyPrice ที่เกี่ยวข้องและต้องเป็นจำนวนเต็มบวกระหว่าง 1 ถึง 99

LosPrices

ราคาระยะเวลาในการเข้าพัก

การแสดง JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
ช่อง
rates[]

number

องค์ประกอบราคาฐานของราคาระยะเวลาในการเข้าพัก

หากระบุค่า taxes ที่เกี่ยวข้อง ราคานี้จะยังไม่รวมภาษี (ราคารวมจะเป็นผลรวมของอัตราและภาษีที่เกี่ยวข้อง)

ควรเป็นรายการอัตราที่คั่นด้วยคอมมา ค่าที่ดัชนี n สอดคล้องกับระยะเวลาในการเข้าพัก n+1

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

ระยะเวลาในการเข้าพักที่ไม่พร้อมใช้งานควรแสดงด้วย 0
taxes[]

number

องค์ประกอบด้านภาษีของราคาระยะเวลาในการเข้าพัก

ควรเป็นรายการภาษีที่คั่นด้วยคอมมา ค่าที่ดัชนี n สอดคล้องกับระยะเวลาในการเข้าพัก n+1
fees[]

number

ไม่บังคับ องค์ประกอบค่าธรรมเนียมของราคาระยะเวลาในการเข้าพัก

ควรเป็นรายการค่าธรรมเนียมที่คั่นด้วยคอมมา ค่าที่ดัชนี n สอดคล้องกับระยะเวลาในการเข้าพัก n+1
rateRuleId

string

สำหรับราคาสำหรับลูกค้าที่เข้าเกณฑ์ รหัสนี้จะจับคู่ราคากับคำจำกัดความในไฟล์คำจำกัดความกฎเกี่ยวกับอัตรา

จำนวนอักขระสูงสุดสำหรับช่องนี้คือ 40 ตัว
currencyCode

string

รหัสสกุลเงิน 3 ตัวอักษรซึ่งระบุราคาและภาษี เช่น "USD" สำหรับดอลลาร์สหรัฐ

มีผลกับ rates และ taxes