تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Release Notes

يمنحك الإصدار 3 من Travel Partner API إمكانية الوصول الآلي إلى ما يلي:

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

نقاط النهاية

يمكن الوصول إلى نقاط نهاية Travel Partner API من خلال بنية REST-ful من طلبات HTTPS. عنوان URL الأساسي لجميع الطلبات هو:

https://travelpartner.googleapis.com

نقاط نهاية الخدمة
روابط الحسابات	يدير الروابط بين حساب على "إعلانات Google" وحساب على 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`
تقارير التسوية	تُنشئ تقارير تسوية العمولات وتتحقّق من صحتها وتسترجعها (إعلانات الفنادق فقط). `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 من Travel Partner API بالخدمات الخاصة بالفنادق فقط.

HotelViewService

HotelViewService.ListHotelViews (المعروفة سابقًا باسم Hotels 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)
- تم تغيير نقطة نهاية واجهة برمجة التطبيقات من 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
- تم تغيير نقطة نهاية واجهة برمجة التطبيقات من https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats إلى https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
- تمت إضافة مَعلمات طلب البحث.
- تمت إعادة تسمية الحقول وإعادة هيكلتها.

‫PriceAccuracyViewService (المعروفة سابقًا باسم واجهة برمجة التطبيقات لتقرير price_accuracy)

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 متاحًا.
- تمت إعادة تسمية بعض الحقول.

PriceCoverageViewService

PriceAccuracyViewService.ListPriceCoverageViews (كانت سابقًا price_coverage_stats_history في Scorecard 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)
- تم تغيير نقطة نهاية واجهة برمجة التطبيقات من 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.
- تمت إعادة تسمية بعض الحقول.
- تمت إزالة معلومات عروض الأسعار من الردّ.

طُرق ReconciliationReportService (المعروفة سابقًا باسم 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 أشهر.

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

الإصدار	تاريخ الإيقاف النهائي	تاريخ الإيقاف النهائي
v3.0	لا ينطبق	لا ينطبق
v2.1	أيلول (سبتمبر) 2019	‫31 مايو 2020
الإصدار 2.0 (Bids API)	شباط (فبراير) 2018	أيار (مايو) 2018
الإصدار 2.0 (جميع واجهات برمجة التطبيقات الأخرى)	أيلول (سبتمبر) 2019	‫15 شباط (فبراير) 2020
v1.2	شباط (فبراير) 2018	أيار (مايو) 2018
v1.1	يونيو 2016	تشرين الأول (أكتوبر) 2016
v1.0	نيسان (أبريل) 2015	تشرين الأول (أكتوبر) 2015

المصادقة

للوصول إلى Travel Partner API، يجب أن يصادق العملاء باستخدام مصادقة OAuth2.

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

Release Notes تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.