Travel Partner API

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

שירות: drivepartner.googleapis.com

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

מסמך Discovery

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

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

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

  • https://travelpartner.googleapis.com

משאב 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
(deprecated)		 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
שיטה מותאמת אישית ברמת האוסף לעדכון הסטטוס של Live on Google למספר נכסים.

משאב REST: v3.accounts.icon

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

משאב 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.reconciliationReporting

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