Usage

تعرض هذه الصفحة بعض نماذج الطلبات باستخدام Travel Partner API الإصدار 3.

تقبل نقاط نهاية Travel Partner API بنية 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 ويطبّق فلترًا على التقرير باستخدام تاريخ 4/10/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

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

تتيح لك خدمة تقارير التسوية الحصول على قائمة بالتقارير وتنزيل تقرير معيّن والتحقّق من صحته، ثم تحميل التقرير إلى Google.

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

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

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

يمكنك تضمين مَعلمات طلب اختيارية لتاريخَي البدء والانتهاء من أجل حصر النتائج. على سبيل المثال، يحصر طلب البحث هذا التقارير في تلك التي تقع بين 15/6/2019 و15/9/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