Release Notes

Travel Partner API เวอร์ชัน 3 ช่วยให้คุณเข้าถึงแบบเป็นโปรแกรมเพื่อดำเนินการต่อไปนี้ได้

การจัดการการลิงก์บัญชีระหว่าง Hotel Center กับ Google Ads
การจัดการการตั้งค่าโรงแรมที่เลือก
การจัดการแบรนด์และไอคอน (เบต้าแบบปิด)
ข้อมูลประสิทธิภาพของที่พักผ่านบริการมุมมองรายงานประสิทธิภาพของที่พัก
ข้อมูลโรงแรมผ่านบริการมุมมองโรงแรม
ข้อมูลรายงานการเข้าร่วมผ่านบริการมุมมองรายงานการเข้าร่วม
ข้อมูลความถูกต้องของราคาผ่านบริการมุมมองความถูกต้องของราคา
ข้อมูลความครอบคลุมของราคาผ่านบริการมุมมองความครอบคลุมของราคา
ข้อมูลแผนการเดินทางและราคาผ่านบริการมุมมองราคา
การจัดการรายงานการกระทบยอดค่าคอมมิชชันผ่านบริการรายงานการกระทบยอด (พาร์ทเนอร์ที่ใช้รูปแบบการจ่ายค่าคอมมิชชันต่อการเข้าพักเท่านั้น)

ปลายทาง

ปลายทางของ Travel Partner API สามารถเข้าถึงได้ผ่านไวยากรณ์ REST-ful จากการเรียก HTTPS URL ฐานสำหรับคำขอทั้งหมดคือ

https://travelpartner.googleapis.com

ปลายทางบริการ
ลิงก์บัญชี	จัดการลิงก์ระหว่างบัญชี Google Ads กับบัญชี Hotel Center `POST /v3/accounts/account id/accountLinks DELETE /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks PATCH /v3/accounts/account id/accountLinks/account link id`
แบรนด์	แก้ไขการกำหนดค่าแบรนด์ (เบต้าแบบปิด) `POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id`
โรงแรม	แก้ไขการตั้งค่าโรงแรมที่เลือก `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
มุมมองโรงแรม	แสดงผลรายการมุมมองโรงแรมหรือข้อมูลสรุป `GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize`
Icons	จัดการไอคอน (เบต้าแบบปิด) `POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id`
มุมมองรายงานการมีส่วนร่วม	แสดงมุมมองรายงานการมีส่วนร่วม หรือแสดงข้อมูลชุดย่อยที่กรองแล้วของข้อมูลมุมมองโดยใช้การค้นหา `GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query`
มุมมองความถูกต้องของราคา	แสดงผลมุมมองความถูกต้องของราคาที่เฉพาะเจาะจง มุมมองความถูกต้องที่ใช้ได้ หรือข้อมูลสรุป `GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize`
มุมมองความครอบคลุมของราคา	แสดงผลมุมมองความครอบคลุมของราคาล่าสุดหรือประวัติความครอบคลุมทั้งหมด `GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews`
การดูราคา	แสดงผลมุมมองราคาที่ขอพร้อมรายละเอียดทั้งหมด `GET /v3/accounts/account id/priceViews/partner hotel id`
มุมมองรายงานประสิทธิภาพของที่พัก	แสดงมุมมองรายงานประสิทธิภาพของพร็อพเพอร์ตี้โดยใช้การค้นหา `GET /v3/accounts/account id/participationReportViews:query`
รายงานการปรับยอด	สร้าง ตรวจสอบ และดึงรายงานการปรับยอดค่าคอมมิชชัน (Hotel Ads เท่านั้น) `POST /v3/accounts/account id/reconciliationReports POST /v3/accounts/account id/reconciliationReports:validate GET /v3/accounts/account id/reconciliationReports/datetime~filename GET /v3/accounts/account id/reconciliationReports`

คุณดูรหัสบัญชีได้ในมุมมองข้อมูลบัญชีของแท็บบัญชีใน Hotel Ads Center

บันทึกการเปลี่ยนแปลง

บริการหลายอย่างใน Travel Partner API v2.1 ได้รับการย้ายข้อมูลไปยัง Google Ads API แล้ว ด้วยเหตุนี้ Travel Partner API v3 จึงมีเพียงบริการที่เฉพาะเจาะจงสำหรับโรงแรมเท่านั้น

HotelViewService

HotelViewService.ListHotelViews (เดิมคือ Hotels API)
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/hotels เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews แล้ว
- นำพารามิเตอร์คำขอ type ออกแล้ว
- นำฟิลด์ manifestOnly ออกจากการตอบกลับ
- มีการเปลี่ยนชื่อฟิลด์บางรายการ
HotelViewService.SummarizeHotelViews (เดิมคือ hotel_list_stats ใน Scorecard API)
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize แล้ว
- มีการเปลี่ยนชื่อฟิลด์บางรายการ

ParticipationReportViewService (เดิมคือ opportunity_stats ใน Scorecard API)

ParticipationReportService.QueryParticipationReport
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query แล้ว
- เพิ่มพารามิเตอร์การค้นหาแล้ว
- เปลี่ยนชื่อและปรับโครงสร้างฟิลด์แล้ว

PriceAccuracyViewService (เดิมคือ API รายงานความถูกต้องของราคา)

PriceAccuracyViewService.ListPriceAccuracyViews
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews แล้ว
- API ใหม่จะแสดงรายการชื่อทรัพยากรของมุมมองโรงแรม ซึ่งแตกต่างจากเวอร์ชันก่อนหน้าที่จะแสดงรายการวันที่ของรายงาน
PriceAccuracyViewService.ListPriceAccuracyViews
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 แล้ว
- ระบบไม่รองรับเอาต์พุต CSV อีกต่อไป
- มีการเปลี่ยนชื่อฟิลด์บางรายการ

PriceCoverageViewService

PriceAccuracyViewService.ListPriceCoverageViews (เดิมคือ price_coverage_stats_history ใน Scorecard API)
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews แล้ว
- มีการเปลี่ยนชื่อฟิลด์บางรายการ
PriceAccuracyViewService.GetLatestPriceCoverageViews (เดิมคือ price_coverage_stats ใน Scorecard API)
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest แล้ว
- มีการเปลี่ยนชื่อฟิลด์บางรายการ

PriceViewService (เดิมคือ Prices API)

PriceViewService.GetPriceView
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id แล้ว
- มีการเปลี่ยนชื่อฟิลด์บางรายการ
- นำข้อมูลราคาเสนอออกจากคำตอบ

เมธอด ReconciliationReportService (เดิมคือ API รายงานการปรับยอด)

ReconciliationReportService.ListReconciliationReports
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports แล้ว
ReconciliationReportService.GetReconciliationReport
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename แล้ว
ReconciliationReportService.CreateReconciliationReport
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports แล้ว
ReconciliationReportService.ValidateReconciliationReport
- เปลี่ยนปลายทาง API จาก https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate เป็น https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate แล้ว

การเลิกใช้งาน

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

ตารางต่อไปนี้แสดงกำหนดการปัจจุบันของเวอร์ชัน API รวมถึงวันที่เลิกใช้งานและวันที่เลิกใช้ที่คาดไว้

เวอร์ชัน	วันที่เลิกใช้งาน	วันที่หยุดให้บริการ
v3.0	ไม่มี	ไม่มี
v2.1	กันยายน 2019	31 พฤษภาคม 2020
v2.0 (Bids API)	กุมภาพันธ์ 2018	พฤษภาคม 2018
v2.0 (API อื่นๆ ทั้งหมด)	กันยายน 2019	15 กุมภาพันธ์ 2020
v1.2	กุมภาพันธ์ 2018	พฤษภาคม 2018
v1.1	มิถุนายน 2016	ตุลาคม 2016
v1.0	เมษายน 2015	ตุลาคม 2015

การตรวจสอบสิทธิ์

หากต้องการเข้าถึง Travel Partner API ไคลเอ็นต์ต้องตรวจสอบสิทธิ์โดยใช้การตรวจสอบสิทธิ์ OAuth2

ดูแอปพลิเคชันตัวอย่างและข้อมูลเพิ่มเติมเกี่ยวกับการใช้ OAuth เพื่อเชื่อมต่อกับ Travel Partner API ได้ที่การตรวจสอบสิทธิ์ API

Release Notes จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ