Usage

หน้านี้แสดงการเรียกใช้ตัวอย่างบางรายการโดยใช้ 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