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