توفّر لك Travel Partner API واجهة RESTful لمنصة Google 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 واستخدامها. ويتم استخدامها لإنشاء مكتبات برامج للعملاء ومكوّنات إضافية لبيئات التطوير المتكاملة وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفّر هذه الخدمة مستند الاكتشاف التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدّد عنوان الشبكة لخدمة API. قد تتضمّن خدمة واحدة نقاط نهاية متعددة للخدمة. تتضمّن هذه الخدمة نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (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 المرتبط باسم مورد العلامة التجارية لعنوان URI الخاص بالطلب. |
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 تعرض هذه الطريقة Icon لحساب شريك. |
مورد 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 للتحقّق من صحة تقرير تسوية. |