Travel Partner API

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

• משאב REST: גרסה 3.accounts.accountLinks
• משאב REST: גרסה 3.accounts.brands
• משאב REST: v3.accounts.freeBookingLinksReportViews
• משאב REST: v3.accounts.hotelViews
• משאב REST: גרסה 3.accounts.hotels
• משאב REST: גרסה 3.accounts.icon
• משאב REST: v3.accounts.participationReportViews
• משאב REST: v3.accounts.priceAccuracyViews
• משאב REST: v3.accounts.priceCoverageViews
• משאב REST: גרסה 3.accounts.priceViews
• משאב REST: גרסה 3.accounts.propertyperformanceReportViews
• משאב REST: v3.accounts.reconciliationReports

שירות: drivepartner.googleapis.com

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

מסמך Discovery

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

• https://travelpartner.googleapis.com/$discovery/rest?version=v3

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

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

• https://travelpartner.googleapis.com

משאב REST: v3.accounts.accountLinks

שיטות
create	POST /v3/{parent=accounts/*}/accountLinks יוצרת קישור חדש בין חשבון Hotel Center לבין חשבון Google Ads.
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 (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 מאמת דוח התאמה.