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

ไอคอน

จัดการไอคอน (เบต้าแบบปิด)

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 จึงมีเพียงบริการที่เฉพาะเจาะจงสำหรับโรงแรมเท่านั้น

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