Usage

หน้านี้แสดงตัวอย่างการเรียกโดยใช้ Travel Partner API v3

ปลายทาง Travel Partner API ใช้ไวยากรณ์ REST ผ่านการเรียก 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

โรงแรม

บริการ Hotel View จะแสดงรายการโรงแรมทั้งหมดหรือสรุปข้อมูลของบัญชีนั้นๆ

ดูรายชื่อโรงแรม

ตัวอย่างต่อไปนี้ดึงข้อมูลรายการโรงแรมทั้งหมดในบัญชี 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-3 รายการสําหรับการรวมราคาหรือสัญญาณพิกเซลที่ตรงกันในผลลัพธ์

ในตัวอย่างนี้ รายงานความถูกต้องของราคาในวันที่ 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

ราคา

บริการมุมมองราคาช่วยให้คุณเรียกดูรายงานราคาสําหรับที่พักหนึ่งๆ ได้

การรับข้อมูลราคาสําหรับพร็อพเพอร์ตี้

หากต้องการรับรายงานราคาสําหรับโรงแรมหนึ่งๆ (รหัส=101) ที่เป็นของบัญชี 12345678 โปรดส่งคําขอนี้

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

รายงานการปรับยอด

บริการรายงานการปรับยอด

การรับรายการรายงานการปรับยอด

ตัวอย่างต่อไปนี้เพื่อดูรายการรายงานสําหรับบัญชี 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