Release Notes

Travel Partner API เวอร์ชัน 3 ให้สิทธิ์เข้าถึงแบบเป็นโปรแกรมแก่

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

ปลายทาง

ปลายทางปลายทางของ Travel Partner API เข้าถึงได้ผ่านไวยากรณ์ที่มี REST จากการเรียก 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
ไอคอน	จัดการไอคอน (เบต้าแบบปิด) 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

คุณจะหารหัสบัญชีได้ในส่วนมุมมองข้อมูลบัญชีของแท็บบัญชีในศูนย์ช่วยเหลือของ Google Hotel Ads

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

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

บริการ Hotel View

• 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 (เดิมคือ price_accuracy report 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 อีกต่อไป
  • มีการเปลี่ยนชื่อบางช่อง

บริการมุมมองความครอบคลุมของราคา

• 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 (เดิมเรียกว่า Price 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 (เดิมคือ Reconciliation Reports 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 รวมทั้งวันที่เลิกใช้งานและเลิกใช้งานตามที่คาดหวัง

เวอร์ชัน	วันที่เลิกใช้งาน	วันที่พระอาทิตย์ตก
เวอร์ชัน 3.0	ไม่มี	ไม่มี
เวอร์ชัน 2.1	กันยายน 2019	31 พฤษภาคม 2020
v2.0 (API การเสนอราคา)	กุมภาพันธ์ 2018	พฤษภาคม 2018
v2.0 (API อื่นๆ ทั้งหมด)	กันยายน 2019	15 กุมภาพันธ์ 2020
เวอร์ชัน 1.2	กุมภาพันธ์ 2018	พฤษภาคม 2018
เวอร์ชัน 1.1	มิถุนายน 2016	ตุลาคม 2016
เวอร์ชัน 1.0	เมษายน 2015	ตุลาคม 2015

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

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

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