Method: accounts.properties.ingestLosPropertyPrices

מעדכנים את המחירים של נכס אחד באמצעות מחירים בפורמט של משך השהייה. לגבי כל תאריך הגעה בטווח המבוקש יוחלפו כל מחירי ה-LOS שלו, כולל כל המוצרים ומספרי האורחים. אין השפעה על מחירים עם תאריכי הגעה מחוץ לטווחי התאריכים שצוינו.

בקשת HTTP

POST https://travelpartnerprices.googleapis.com/v1/{propertyPrices.property=accounts/*/properties/*}:ingestLosPropertyPrices

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
propertyPrices.property

string

שם המשאב של PropertyPrices. בפורמט הזה: accounts/{account_id}/properties/{property_id}.

account_id: ערך המחרוזת הזה הוא 'מספר החשבון' שמופיע בדף הגדרות החשבון ב-Hotel Center.

property_id: הערך של הרכיב הזה חייב להיות מחרוזת שתואמת למזהה כרטיס המוצר בפיד של רשימת המלונות שלכם.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
שדות
requestTime

string (Timestamp format)

חובה. הרגע בזמן שבו נשלחה ההודעה LoS Price, מבוטאת כמחרוזת בפורמט RFC 3339.

כל הודעה שנשלחה באמצעות requestTime ב-24 השעות האחרונות תטופל והודעות שלא יימחקו.

ההודעות מעובדות לפי הסדר של requestTime, בלי קשר לסדר שבו הן התקבלו. לדוגמה, עדכון מחיר עם ערך requestTime של 2019-05-03T14:09:00Z שהתקבל אחרי הודעה לגבי אותם מסלולי נסיעה עם requestTime מסוג 2019-05-03T14:10:00Z יבוטל, לטובת ההודעה עם חותמת הזמן המאוחרת יותר.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

מחירים לתאריך ההגעה. כל המחירים בarrivalDayPrices חלים על נכס ספציפי, אבל תאריכי הגעה שונים.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של PropertyPrices.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/travelpartner

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

LosPropertyPrices

מחירי משך השהייה שצוינו ברמת המלון.

ייצוג JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
שדות
arrivalDatePrices[]

object (LosArrivalDatePrices)

מחירים לתאריך ההגעה. כל המחירים בarrivalDayPrices חלים על נכס ספציפי, אבל תאריכי הגעה שונים.
property

string

שם המשאב של PropertyPrices. בפורמט הזה: accounts/{account_id}/properties/{property_id}.

account_id: ערך המחרוזת הזה הוא 'מספר החשבון' שמופיע בדף הגדרות החשבון ב-Hotel Center.

property_id: הערך של הרכיב הזה חייב להיות מחרוזת שתואמת למזהה כרטיס המוצר בפיד של רשימת המלונות שלכם.

LosArrivalDatePrices

מחירי משך השהייה, מקובצים לפי טווחי תאריכי הגעה.

ייצוג JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
שדות
productPrices[]

object (LosProductPrices)

מחירי מוצר. כל המחירים בproductPrices הזה חלים על נכס ספציפי, על שילוב ספציפי של תאריך ההגעה, אבל על מוצרים שונים.
startDate

object (Date)

המחיר productPrices יחול על כל תאריכי ההגעה בין startDate לבין endDate, כולל.

אם מנסים לציין רק תאריך הגעה אחד (ולא טווח), אפשר להשמיט את endDate.
endDate

object (Date)

המחיר productPrices יחול על כל תאריכי ההגעה בין startDate לבין endDate, כולל.

אם מנסים לציין רק תאריך הגעה אחד (ולא טווח), אפשר להשמיט את endDate.

תאריך

מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. המצב הזה יכול לייצג אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שונים של שנה, חודש ויום.
  • חודש ויום, עם שנה אפס (למשל יום נישואין).
  • שנה בפני עצמה, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך תפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה שבה חל התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך חייב להיות 1 עד 12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

היום בחודש. הערך צריך להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם אין חשיבות לציון יום מסוים.

LosProductPrices

מחירי משך השהייה, מקובצים לפי סוג המוצר (שילובים שלroomTypeId/ratePlanId).

ייצוג JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
שדות
occupancyPrices[]

object (LosOccupancyPrices)

מחירים לחדרים פנויים. כל המחירים בoccupancyPrices הזה חלים על נכס ספציפי, תאריך הגעה ספציפי ושילוב מוצרים, אבל על תפוסה שונה.
roomTypeId

string

המזהה הייחודי של החדר שאליו מתייחס המחיר. המזהה הזה מתאים בין הנתונים של חבילת החדר לבין הנתונים ששלחת בנתוני החדר. מידע נוסף זמין במאמר בנושא מטא-נתונים של חבילת חדר.

אם השדה roomTypeId מאוכלס, צריך לאכלס גם את ratePlanId.
ratePlanId

string

המזהה הייחודי של נתוני החבילה שאליהם מתייחס המחיר. המזהה הזה מאפשר להתאים בין הנתונים של חבילת החדר לבין הנתונים ששלחתם בנתוני ה-package. מידע נוסף זמין במאמר בנושא מטא-נתונים של חבילת חדר.

אם השדה ratePlanId מאוכלס, צריך לאכלס גם את roomTypeId.

LosOccupancyPrices

המחירים של משך השהייה, מקובצים לפי מספר האורחים למבוגרים.

ייצוג JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
שדות
prices[]

object (LosPrices)

המחירים של משך השהייה. כל המחירים בטווח prices חלים על שילוב ספציפי של נכס, תאריך הגעה, מוצר ותפוסה.
adults

integer

המספר המקסימלי של אורחים שאפשר להזמין בכל חדר, כולל מבוגרים וילדים. הערך הזה מוגדר לכל התעריפים בשדה OccupancyPrices התואם, והוא צריך להיות מספר שלם חיובי בין 1 ל-99.

LosPrices

המחירים של משך השהייה.

ייצוג JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
שדות
rates[]

number

רכיב התעריף הבסיסי של מחירי משך השהייה.

אם צוין ערך תואם של taxes, שיעור זה לא כולל את המס (המחיר הכולל יהיה הסכום של התעריף והמס הרלוונטיים).

רשימת התעריפים צריכה להיות מופרדת בפסיקים. הערך באינדקס n תואם למשך השהייה של n+1.

עליכם לשלוח את קבוצת ה-LoS המלאה של 30 המחירים בכל פעם. אם תשלחו פחות מ-30 מחירים, נעבד את כל מחירי ה-LoS שסופקו כרגיל, ושאר התעריפים לא זמינים עד לסכום LoS 30. אם תשלחו יותר מ-30, נוריד את כל המחירים שתשלחו מעבר לתעריף ה-30.

משך שהייה לא זמין צריך להיות מיוצג באמצעות 0.
taxes[]

number

רכיב המס של מחירי משך השהייה.

רשימת המיסים צריכה להיות מופרדת בפסיקים. הערך באינדקס n תואם למשך השהייה של n+1.
fees[]

number

זה שינוי אופציונלי. רכיב העמלה של מחירי משך השהייה.

רשימת העמלות צריכה להיות מופרדת בפסיקים. הערך באינדקס n תואם למשך השהייה של n+1.
rateRuleId

string

כשמדובר בתעריפים בלעדיים, המזהה הזה תואם תעריף להגדרה בקובץ 'הגדרת כלל דירוג'.

מגבלת התווים לשדה הזה היא 40 תווים.
currencyCode

string

קוד המטבע בן שלוש האותיות שבו מופיעים התעריפים והמיסים. לדוגמה, "USD" לדולר ארה"ב.

חל על rates ו-taxes.