توفّر لك واجهة Travel Partner API واجهة RESTful لمنصة Google Hotel Center. تتيح هذه الواجهة للتطبيق استرداد بيانات Hotel Center وتغييرها بكفاءة، وبالتالي فهي مناسبة لإدارة الحسابات الكبيرة أو المعقّدة.
- مورد REST: v3.accounts.accountLinks
- مورد REST: v3.accounts.brands
- مورد REST: v3.accounts.freeBookingLinksReportViews
- مورد REST: v3.accounts.hotelViews
- مورد REST: v3.accounts.hotels
- مورد REST: v3.accounts.icons
- مورد REST: v3.accounts.listings
- مورد REST: v3.accounts.participationReportViews
- مورد REST: v3.accounts.priceAccuracyViews
- مورد REST: v3.accounts.priceCoverageViews
- مورد REST: v3.accounts.priceViews
- مورد REST: v3.accounts.propertyPerformanceReportViews
- مورد REST: v3.accounts.reconciliationReports
الخدمة: travelpartner.googleapis.com
لطلب هذه الخدمة، ننصح باستخدام مكتبات العميل التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند طلب بيانات من واجهة برمجة التطبيقات.
مستند الاستكشاف
مستند الاستكشاف هو عبارة عن مواصفات يمكن أن تقرأها الآلة لوصف REST API واستخدامها. وهو يُستخدم لإنشاء مكتبات العميل ومكوّنات IDE الإضافية وغيرها من الأدوات التي تتفاعل مع Google APIs. تجدر الإشارة إلى أنّ خدمة واحدة قد تقدّم أكثر من وثيقة استكشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:
https://travelpartner.googleapis.com
مورد REST: v3.accounts.accountLinks
| الطُرق | |
|---|---|
create |
POST /v3/{parent=accounts/*}/accountLinks تنشئ هذه الطريقة رابط حساب جديدًا بين حساب على Hotel Center وحساب على "إعلانات Google". |
delete |
DELETE /v3/{name=accounts/*/accountLinks/*} لحذف رابط حساب |
get |
GET /v3/{name=accounts/*/accountLinks/*} تعرض هذه الطريقة مثيل AccountLink المرتبط باسم مورد ربط الحساب المحدّد في عنوان URL للطلب. |
list |
GET /v3/{parent=accounts/*}/accountLinks تعرض هذه الطريقة روابط الحسابات لحساب على Hotel Center. |
patch |
PATCH /v3/{accountLink.name=accounts/*/accountLinks/*} تعدّل هذه الطريقة هدف ربط الحساب. |
مورد REST: v3.accounts.brands
| الطُرق | |
|---|---|
create |
POST /v3/{parent=accounts/*}/brands تُستخدَم لإنشاء علامة تجارية جديدة. |
get |
GET /v3/{name=accounts/*/brands/*} تعرض هذه السمة مثيل Brand المرتبط باسم مورد العلامة التجارية الخاص بمعرّف الموارد المنتظم للطلب. |
list |
GET /v3/{parent=accounts/*}/brands تعرض هذه الطريقة العلامات التجارية لحساب شريك. |
patch |
PATCH /v3/{brand.name=accounts/*/brands/*} تعدّل هذه الطريقة علامة تجارية. |
مورد REST: v3.accounts.freeBookingLinksReportViews
| الطُرق | |
|---|---|
query |
GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query تم إيقافها نهائيًا: استخدِم PropertyPerformanceReportService.QueryPropertyPerformanceReport بدلاً منها، إذ تتضمّن أيضًا إعداد تقارير عن مرّات الظهور. |
مورد REST: v3.accounts.hotelViews
| الطُرق | |
|---|---|
list |
GET /v3/{parent=accounts/*}/hotelViews تعرض هذه الطريقة قائمة بعروض الفنادق. |
summarize |
GET /v3/{parent=accounts/*}/hotelViews:summarize تعرض هذه السمة معلومات موجزة عن الفنادق. |
مورد REST: v3.accounts.hotels
| الطُرق | |
|---|---|
setLiveOnGoogle |
POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle طريقة مخصّصة على مستوى المجموعة لتعديل حالة "مباشر على Google" لعدة مواقع. |
مورد REST: v3.accounts.icons
| الطُرق | |
|---|---|
create |
POST /v3/{parent=accounts/*}/icons تحميل رمز جديد وبدء عملية مراجعته |
get |
GET /v3/{name=accounts/*/icons/*} تعرض هذه الطريقة مثيل Icon المرتبط باسم مورد رمز محدّد في معرّف الموارد المنتظم للطلب. |
list |
GET /v3/{parent=accounts/*}/icons تعرض هذه الطريقة Icons لحساب شريك. |
مورد REST: v3.accounts.listings
| الطُرق | |
|---|---|
verify |
POST /v3/{parent=accounts/*}/listings:verify تعرض هذه الطريقة المؤسسات التي تم التحقّق منها والتي تتضمّن بياناتها مشاكل وتستوفي معايير الأهلية للعرض على شركاء الواقع الافتراضي فقط. |
مورد REST: v3.accounts.participationReportViews
| الطُرق | |
|---|---|
query |
GET /v3/{name=accounts/*}/participationReportViews:query تتيح إمكانية طلب (الحصول على تقرير مشاركة وفلترته وتقسيمه) لحساب معيّن. |
مورد REST: v3.accounts.priceAccuracyViews
| الطُرق | |
|---|---|
get |
GET /v3/{name=accounts/*/priceAccuracyViews/*} تعرض هذه السمة طريقة العرض المطلوبة لدقة الأسعار بالتفصيل. |
list |
GET /v3/{parent=accounts/*}/priceAccuracyViews تعرض هذه السمة طرق العرض المتاحة لدقة الأسعار. |
summarize |
GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize تعرض هذه السمة ملخّصًا عن دقة الأسعار. |
مورد REST: v3.accounts.priceCoverageViews
| الطُرق | |
|---|---|
getLatest |
GET /v3/{parent=accounts/*}/priceCoverageViews:latest تعرض هذه السمة أحدث طريقة عرض لتغطية السعر بالتفصيل الكامل. |
list |
GET /v3/{parent=accounts/*}/priceCoverageViews تعرض هذه السمة سجلّ تغطية السعر بالكامل. |
مورد REST: v3.accounts.priceViews
| الطُرق | |
|---|---|
get |
GET /v3/{name=accounts/*/priceViews/*} تعرض هذه السمة طريقة عرض السعر المطلوبة بالتفصيل الكامل. |
مورد REST: v3.accounts.propertyPerformanceReportViews
| الطُرق | |
|---|---|
query |
GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query تتيح هذه الطريقة إمكانية طلب (الحصول على البيانات وفلترتها وتقسيمها) تقرير عن روابط الحجز المجانية لحساب معيّن. |
مورد REST: v3.accounts.reconciliationReports
| الطُرق | |
|---|---|
create |
POST /v3/{parent=accounts/*}/reconciliationReports لإنشاء تقرير تسوية وتحميله إلى Google |
get |
GET /v3/{name=accounts/*/reconciliationReports/*} تعرض هذه الطريقة تقرير تسوية. |
list |
GET /v3/{parent=accounts/*}/reconciliationReports تعرض هذه الطريقة قائمة بأسماء تقارير التسوية التي تم إنشاؤها. |
validate |
POST /v3/{parent=accounts/*}/reconciliationReports:validate للتحقّق من صحة تقرير تسوية. |