หน้านี้แสดงการเรียกใช้ตัวอย่างบางรายการโดยใช้ Travel Partner API v3
ปลายทางของ Travel Partner API ยอมรับไวยากรณ์ RESTful ในการเรียก HTTPS base_url สำหรับคำขอ API ทั้งหมดคือ
https://travelpartner.googleapis.com/v3/accounts/account_id
ดูรายการช่องคำขอและการตอบกลับทั้งหมดได้ในแคตตาล็อกทรัพยากร API
รายงานประสิทธิภาพของที่พัก
บริการมุมมองรายงานประสิทธิภาพของพร็อพเพอร์ตี้ช่วยให้คุณสามารถค้นหา (รับ กรอง และจัดกลุ่ม) รายงานประสิทธิภาพของพร็อพเพอร์ตี้สําหรับบัญชีหนึ่งๆ ได้
การค้นหารายงานประสิทธิภาพของพร็อพเพอร์ตี้
ตัวอย่างต่อไปนี้จะดึงรายงานประสิทธิภาพของพร็อพเพอร์ตี้สำหรับพร็อพเพอร์ตี้ทั้งหมดในบัญชี 12345678
โดยกรองตามวันที่ 11 พฤษภาคม 2022 และจัดกลุ่มตามรหัสโรงแรมของพาร์ทเนอร์
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
โรงแรม
บริการมุมมองโรงแรมจะแสดงรายการโรงแรมทั้งหมดหรือข้อมูลสรุปของโรงแรมสำหรับบัญชีหนึ่งๆ
การรับรายการโรงแรม
ตัวอย่างต่อไปนี้ดึงข้อมูลรายชื่อโรงแรมทั้งหมดในบัญชี 12345678
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
คำขอจะยอมรับพารามิเตอร์การค้นหาสำหรับการไปยังส่วนต่างๆ ในผลการค้นหาแบบหลายหน้า ดังนี้
GET base_url/hotelViews?pageSize=10&pageToken=11
ดูสรุปพร็อพเพอร์ตี้
ตัวอย่างนี้จะแสดงข้อมูลสรุปของพร็อพเพอร์ตี้สำหรับบัญชี 12345678
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
รายงานการเข้าร่วม
บริการมุมมองรายงานการเข้าร่วมช่วยให้คุณสามารถค้นหา (รับ กรอง และแบ่งกลุ่ม) รายงานการเข้าร่วมสำหรับบัญชีหนึ่งๆ ได้
การค้นหารายงานการเข้าร่วม
ตัวอย่างต่อไปนี้จะดึงรายงานการมีส่วนร่วมสําหรับพร็อพเพอร์ตี้ทั้งหมดในบัญชี 12345678
และกรองรายงานโดยใช้วันที่ 4/10/20
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
ความถูกต้องของราคา
บริการมุมมองความถูกต้องของราคาช่วยให้ดึงข้อมูลรายงานและตารางสรุปความถูกต้องของราคาสำหรับบัญชีหนึ่งๆ ได้
การรับรายงานความถูกต้องของราคา
ตัวอย่างต่อไปนี้จะดึงข้อมูลรายงานความถูกต้องของราคาในวันที่ 26/8/2019 สำหรับบัญชี 12345678
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
นอกเหนือจากพารามิเตอร์การค้นหาปกติสำหรับการแบ่งหน้าผ่านการตอบกลับแล้ว ยังมีพารามิเตอร์อีก 2 รายการสำหรับการรวมราคาที่ตรงกันหรือสัญญาณพิกเซลไว้ในผลลัพธ์
ในตัวอย่างนี้ รายงานความถูกต้องของราคาในวันที่ 26/8/2019 มีราคาที่ตรงกันและสัญญาณพิกเซล
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
แสดงรายงานความถูกต้องของราคาที่มี
หากต้องการดูรายการรายงานที่ใช้ได้ ให้ส่งคำขอนี้
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
คุณสามารถใส่พารามิเตอร์การค้นหาปกติเพื่อแบ่งหน้าผลลัพธ์ได้
การรับคะแนนความถูกต้องของราคา
หากต้องการดูตารางสรุปสถิติความถูกต้องของราคา ให้ใช้วิธี summarize
ดังนี้
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
ความครอบคลุมของราคา
บริการมุมมองความครอบคลุมของราคาจะแสดงรายงานความครอบคลุมของราคาล่าสุดหรือประวัติความครอบคลุมของราคาทั้งหมด
การดูสถิติความครอบคลุมของราคาล่าสุด
ตัวอย่างต่อไปนี้จะดึงสถิติความครอบคลุมของราคาล่าสุดสำหรับบัญชี 12345678
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
การดูประวัติความครอบคลุมของราคา
คำขอนี้จะดึงประวัติความครอบคลุมของราคาทั้งหมดสำหรับบัญชี
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
ราคา
บริการมุมมองราคาช่วยให้คุณดึงข้อมูลรายงานราคาสำหรับที่พักที่ต้องการได้
การรับข้อมูลราคาสำหรับที่พัก
หากต้องการรับรายงานราคาสำหรับโรงแรมหนึ่งๆ (ID=101
) ที่เป็นของบัญชี 12345678
ให้ส่งคำขอนี้
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
รายงานการปรับยอด
บริการรายงานการปรับยอดช่วยให้คุณดูรายการรายงาน ดาวน์โหลดรายงานที่ต้องการ ตรวจสอบความถูกต้อง แล้วอัปโหลดรายงานไปยัง Google ได้
การรับรายการรายงานการปรับยอด
ตัวอย่างต่อไปนี้จะรับรายการรายงานสำหรับบัญชี 12345678
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
คุณสามารถใส่พารามิเตอร์การค้นหาวันที่เริ่มต้นและวันที่สิ้นสุดที่ไม่บังคับเพื่อจำกัดผลลัพธ์ได้ เช่น การค้นหานี้จะจำกัดรายงานเฉพาะรายงานระหว่างวันที่ 15/6/2019 ถึง 15/9/2019
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
การดาวน์โหลดรายงานการปรับยอด
ตัวอย่างนี้จะดึงข้อมูลรายงาน booking_report.csv
(เป็นการตอบกลับ JSON) ที่อัปโหลดที่ 2019-08-26T12:00:00
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
การตรวจสอบรายงานการปรับยอด
คุณสามารถใช้วิธีนี้เพื่อตรวจสอบความถูกต้องของรายงานก่อนอัปโหลด การตรวจสอบรายงานไม่ได้เป็นการอัปโหลดรายงาน
รายงานการกระทบยอดจะรวมอยู่ในเนื้อหาของคำขอเป็นค่าสำหรับฟิลด์ contents
รายงานการปรับยอดต้องเป็นไปตามไวยากรณ์ที่อธิบายไว้ในรายงานการปรับยอด
ตัวอย่างต่อไปนี้จะตรวจสอบรายงานสำหรับบัญชี 12345678
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
การอัปโหลดรายงานการปรับยอด
หลังจากยืนยันว่ารายงานการปรับยอดถูกต้องแล้ว คุณจะอัปโหลดรายงานไปยัง Google ได้เหมือนในตัวอย่างนี้
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports