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

السعر

تتيح لك خدمة "عرض الأسعار" استرداد تقرير أسعار لمكان محدّد.

الحصول على بيانات الأسعار لمكان مخصّص للاستئجار

للحصول على تقرير الأسعار لفندق معيّن (ID=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