Travel Partner API

‫Travel Partner API מספק לכם ממשק RESTful לפלטפורמת Google Hotel Center. הוא מאפשר לאפליקציה לאחזר ולשנות נתונים ב-Hotel Center בצורה יעילה, ולכן הוא מתאים לניהול חשבונות גדולים או מורכבים.

שירות: travelpartner.googleapis.com

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.

מסמך Discovery

מסמך גילוי הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי API ל-REST. היא משמשת לבניית ספריות לקוח, תוספים ל-IDE וכלים אחרים שמתקשרים עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:

נקודת קצה של שירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה (endpoint) משלו, וכל כתובות ה-URI שבהמשך הן יחסיות לנקודת הקצה הזו:

  • https://travelpartner.googleapis.com

משאב REST: ‏ v3.accounts.brands

Methods
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

Methods
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
הוצא משימוש: במקומו, אפשר להשתמש ב-PropertyPerformanceReportService.QueryPropertyPerformanceReport, שכולל גם דיווח על חשיפות.

משאב REST: ‏ v3.accounts.hotelViews

Methods
list GET /v3/{parent=accounts/*}/hotelViews
החזרת רשימת תצוגות המלונות.
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
מחזירה מידע מסוכם על מלונות.

משאב REST: ‏ v3.accounts.hotels

Methods
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
שיטה בהתאמה אישית ברמת האוסף לעדכון הסטטוס 'פעיל ב-Google' של כמה נכסים.

משאב REST: ‏ v3.accounts.icons

Methods
create POST /v3/{parent=accounts/*}/icons
מעלה סמל חדש ומתחיל את תהליך הבדיקה שלו.
get ‫GET /v3/{name=accounts/*/icons/*}
הפונקציה מחזירה את מופע Icon שמשויך לשם משאב של סמל שצוין ב-URI של הבקשה.
list GET /v3/{parent=accounts/*}/icons
מחזירה את Icons עבור חשבון שותף.

משאב REST: ‏ v3.accounts.listings

Methods
verify POST /v3/{parent=accounts/*}/listings:verify
השאילתה מחזירה רק דפים עסקיים מאומתים עם בעיות בנתונים ועם נתוני הזכאות להצגה לשותפי VR.

משאב REST: ‏ v3.accounts.participationReportViews

Methods
query GET /v3/{name=accounts/*}/participationReportViews:query
מאפשרת לשלוח שאילתה (לקבל, לסנן ולפלח) לדוח השתתפות בחשבון מסוים.

משאב REST: ‏ v3.accounts.priceAccuracyViews

Methods
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
מחזירה את תצוגת דיוק המחירים המבוקשת עם כל הפרטים.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
רשימת התצוגות הזמינות של דיוק המחירים.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
מחזירה את סיכום הדיוק במחיר.

משאב REST: ‏ v3.accounts.priceCoverageViews

Methods
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
מחזירה את תצוגת הכיסוי העדכנית של המחירים בפירוט מלא.
list GET /v3/{parent=accounts/*}/priceCoverageViews
הפונקציה מחזירה את כל היסטוריית הכיסוי של המחיר.

משאב REST: ‏ v3.accounts.priceViews

Methods
get GET /v3/{name=accounts/*/priceViews/*}
מחזירה את תצוגת המחיר המבוקשת עם כל הפרטים.

משאב REST: ‏ v3.accounts.propertyPerformanceReportViews

Methods
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
מאפשרת לבצע שאילתה (לקבל, לסנן ולפלח) בדוח של קישורים חינמיים להזמנת חדרים בחשבון ספציפי.

מקור מידע של REST: ‏ v3.accounts.reconciliationReports

Methods
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
מאמת דוח התאמה.