Release Notes

يمنحك الإصدار 3 من واجهة برمجة تطبيقات شريك السفر إمكانية وصول آلي إلى:

  • إدارة عمليات ربط الحسابات بين "مركز إدارة معلومات الفنادق" و"إعلانات Google"
  • إدارة إعدادات الفنادق المحدّدة
  • إدارة العلامات التجارية والرموز (إصدار تجريبي مغلق)
  • بيانات أداء الموقع من خلال خدمة الملفات الشخصية لتقرير أداء الموقع
  • بيانات الفنادق من خلال "خدمة مشاهدة الفندق"
  • بيانات تقارير المشاركة من خلال خدمة مشاهدة تقرير المشاركة
  • بيانات دقة الأسعار من خلال خدمة "دقة السعر"
  • بيانات تغطية الأسعار من خلال خدمة مشاهدات "تغطية السعر"
  • بيانات برنامج الرحلة والأسعار من خلال خدمة "الاطّلاع على الأسعار"
  • إدارة تقارير تسوية العمولات من خلال خدمة تقارير التسوية (شركاء العمولات لكل إقامة فقط)

نقاط النهاية

يمكن الوصول إلى نقاط نهاية واجهة برمجة تطبيقات شركاء السفر من خلال بنية REST-ful الواردة من طلبات HTTPS. عنوان URL الأساسي لجميع الطلبات هو:

https://travelpartner.googleapis.com

نقاط نهاية الخدمة
روابط الحسابات

تُدير الروابط بين حساب على "إعلانات Google" وحساب على "مركز إدارة معلومات الفنادق".

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

تقارير التسوية

إنشاء تقارير تسوية العمولات والتحقّق منها واستردادها (إعلانات الفنادق فقط).

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

يمكنك البحث عن رقم تعريف حسابك ضمن عرض معلومات الحساب ضمن علامة التبويب الحساب في مركز إعلانات الفنادق.

سجلّ التغييرات

تم نقل بيانات العديد من الخدمات في الإصدار 2.1 من Travel Partner API إلى Google Ads API. ونتيجةً لذلك، لا تحتفظ واجهة برمجة تطبيقات الإصدار 3 من برنامج شركاء السفر إلا بالخدمات الخاصة بالفنادق.

خدمة عرض الفنادق

  • HotelViewService.ListHotelViews (المعروفة سابقًا باسم Hotel 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 في واجهة برمجة التطبيقات لبطاقة قياس الأداء)
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats إلى https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
    • تمت إعادة تسمية بعض الحقول.

ParticipationReportViewService (المعروفة سابقًا action_stats في واجهة برمجة التطبيقات لبطاقة قياس الأداء)

  • ParticipationReportService.QueryParticipationReport
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats إلى https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
    • تمت إضافة معلمات طلب البحث.
    • تمت إعادة تسمية الحقول وإعادة تنظيمها.

PricePriceracyViewService (المعروفة سابقًا باسم price_accuracy API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy إلى https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
    • تعرض واجهة برمجة التطبيقات الجديدة قائمة بأسماء موارد عرض الفنادق بدلاً من الإصدار السابق، الذي يعرض قائمة بتواريخ التقارير.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 إلى https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
    • لم يعد تنسيق ملف CSV متوافقًا.
    • تمت إعادة تسمية بعض الحقول.

ServicePriceageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (المعروفة سابقًا باسم price_coverage_stats_history في واجهة برمجة التطبيقات لبطاقة قياس الأداء)
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من 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 في واجهة برمجة التطبيقات لبطاقة قياس الأداء)
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من 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
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id إلى https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
    • تمت إعادة تسمية بعض الحقول.
    • تمت إزالة معلومات عروض الأسعار من الرد.

طرق تسوية التقارير (المعروفة سابقًا باسم Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports إلى https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.GetReconciliationReport
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename إلى https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
  • ReconciliationReportService.CreateReconciliationReport
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports إلى https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
  • ReconciliationReportService.ValidateReconciliationReport
    • تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate إلى https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

الإيقاف

متوقف
يشير إلى أنّ إصدار واجهة برمجة التطبيقات سيستمر في العمل على النحو المتوقّع، ولكن قد لا يتم تحديثه باستخدام ميزات جديدة أو إصلاح أخطاء. بالإضافة إلى ذلك، عند إيقاف أحد الإصدارات، يتم تحديد تاريخ غروب الشمس.
بدون غروب
يشير إلى أن إصدار واجهة برمجة التطبيقات قد تمت إزالته ولم يعد متاحًا. الحد الأدنى للمدة الزمنية بين الإيقاف و الغروب هو 3 أشهر.

يعرض الجدول التالي الجدول الحالي لإصدارات واجهة برمجة التطبيقات، بالإضافة إلى تواريخ الإيقاف وتوقّف الخدمة المتوقَّعة:

الإصدار تاريخ الإيقاف تاريخ الغروب
الإصدار 3.0 لا ينطبق لا ينطبق
الإصدار 2.1 أيلول (سبتمبر) 2019 31 أيار (مايو) 2020
الإصدار 2.0 (واجهة برمجة تطبيقات عروض الأسعار) شباط (فبراير) 2018 أيار (مايو) 2018
الإصدار 2.0 (جميع واجهات برمجة التطبيقات الأخرى) أيلول (سبتمبر) 2019 15 شباط (فبراير) 2020
الإصدار 1.2 شباط (فبراير) 2018 أيار (مايو) 2018
الإصدار 1.1 حزيران (يونيو) 2016 تشرين الأول (أكتوبر) 2016
الإصدار 1.0 نيسان (أبريل) 2015 تشرين الأول (أكتوبر) 2015

المصادقة

للوصول إلى واجهة برمجة تطبيقات شركاء السفر، يجب على العملاء المصادقة باستخدام مصادقة OAuth2.

للاطّلاع على مثال على التطبيق ومعلومات إضافية حول استخدام OAuth للاتصال بواجهة برمجة تطبيقات شريك السفر، يُرجى الرجوع إلى مصادقة واجهة برمجة التطبيقات.