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