Usage

تعرض هذه الصفحة بعض نماذج المكالمات باستخدام الإصدار 3 من واجهة برمجة تطبيقات شركاء السفر.

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

https://travelpartner.googleapis.com/v3/accounts/account_id

للحصول على قائمة كاملة بحقول الطلبات والردود، يُرجى الاطّلاع على كتالوج موارد واجهة برمجة التطبيقات.

تقرير أداء الموقع

توفّر خدمة عرض تقرير أداء الموقع إمكانية طلب (تقرير وفلترة وتقسيم) تقرير أداء الموقع لحساب معيّن.

طلب البحث عن تقرير أداء الموقع

يحصل المثال التالي على تقرير أداء الموقع لجميع المواقع في الحساب 12345678، وتتم فلترته حتى تاريخ 11 أيار (مايو) 2022، ويتم تجميعه حسب رقم تعريف فندق الشريك.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId

الفنادق

توفّر خدمة عرض الفندق قائمة بجميع الفنادق أو ملخّصًا لها لحساب معيّن.

جارٍ الحصول على قائمة بالفنادق

يسترد المثال التالي قائمة بجميع الفنادق في الحساب 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelviews

يقبل الطلب معلّمات طلب البحث للتنقّل بين النتائج المتعددة الصفحات:

GET base_url/hotelviews?pageSize=10&pageToken=11

الحصول على ملخّص عن المواقع

يحصل هذا المثال على ملخص لمواقع الحساب 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelviews:summarize

تقرير المشاركة

توفّر خدمة عرض تقرير المشاركة إمكانية طلب (تقرير وفلترة وتقسيم) تقرير المشاركة لحساب معيّن.

طلب بحث عن تقرير المشاركة

يحصل المثال التالي على تقرير المشاركة لجميع المواقع في الحساب 12345678 ويفلتر التقرير باستخدام تاريخ 10/4/20.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

دقة السعر

تتيح خدمة الاطّلاع على دقة السعر استرداد تقارير دقة الأسعار وبطاقات قياس الأداء لحساب معيّن.

الحصول على تقرير دقة الأسعار

يسترد المثال التالي تقرير دقة السعر في 26/8/2019 للحساب 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

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

في هذا المثال، يشمل تقرير دقة الأسعار في 26/8/2019 الأسعار المطابقة وإشارات البكسل:

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

تقارير دقة الأسعار المتاحة

للحصول على قائمة بالتقارير المتاحة، أرسِل هذا الطلب:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

يمكنك تضمين معلّمات طلب البحث المعتادة للتنقّل بين النتائج.

الحصول على نتيجة دقة السعر

للحصول على بطاقة قياس أداء دقة الأسعار، استخدِم الطريقة summarize:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

تغطية الأسعار

توفّر خدمة مرات مشاهدة تغطية السعر أحدث تقرير حول تغطية الأسعار أو سجلّ تغطية الأسعار بالكامل.

الحصول على أحدث الإحصاءات المتعلقة بتغطية الأسعار

يسترجع المثال التالي آخر إحصاءات تغطية الأسعار للحساب 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

جارٍ الحصول على سجلّ تغطية الأسعار

يحصل هذا الطلب على سجلّ تغطية الأسعار بالكامل للحساب:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

السعر

تتيح لك خدمة الاطّلاع على الأسعار إمكانية استرداد تقرير السعر لموقع معيّن.

الحصول على بيانات الأسعار لأحد المواقع

للحصول على تقرير الأسعار لفندق معيّن (رقم التعريف=101) ينتمي إلى الحساب 12345678، يُرجى إصدار هذا الطلب:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

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

خدمة تقارير التسوية

الحصول على قائمة بتقارير التسوية

يحصل المثال التالي على قائمة بتقارير الحساب 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

ويمكنك تضمين معلّمات طلب البحث الاختيارية لتاريخ البدء والانتهاء للحدّ من النتائج. على سبيل المثال، يقتصر طلب البحث هذا على التقارير بين 6/15/2019 و9/15/2019 فقط:

GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15

جارٍ تنزيل تقرير تسوية

يسترد هذا المثال تقرير booking_report.csv (كاستجابة JSON) الذي تم تحميله في 2019-08-26T12:00:00:

GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv

جارٍ التحقق من تقرير التسوية

ويمكنك استخدام هذه الطريقة للتحقّق من صحة التقرير قبل تحميله. لا يؤدي التحقق من التقرير إلى تحميله.

يتم تضمين تقرير التسوية في نص الطلب، كقيمة للحقل contents. يجب أن يتّبع تقرير التسوية البنية الموضّحة في تقارير التسوية.

يوضّح المثال التالي تقريرًا للحساب 12345678:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate

جارٍ تحميل تقرير تسوية

بعد تأكيد أنّ تقرير التسوية صالح، يمكنك تحميله إلى Google، كما هو موضّح في المثال التالي:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports