Method: accounts.properties.ingestLosPropertyPrices

ठहरने की कुल अवधि के हिसाब से फ़ॉर्मैट की गई कीमतों का इस्तेमाल करके, किसी एक प्रॉपर्टी के लिए किराये अपडेट करें. किसी प्रॉपर्टी के लिए, अनुरोध की गई सीमा में आने की हर तारीख के लिए, एलओएस के लिए तय की गई सभी कीमतें बदल जाएंगी. इनमें सभी प्रॉडक्ट और व्यस्तता की जानकारी शामिल है. तय की गई तारीख की सीमाओं से बाहर, आने की तारीख वाली कीमतों पर असर नहीं पड़ता है.

एचटीटीपी अनुरोध

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

यह यूआरएल 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)

ज़रूरी है. कम कीमत का मैसेज भेजे जाने के समय को आरएफ़सी 3339 के फ़ॉर्मैट वाली स्ट्रिंग के तौर पर दिखाया जाता है.

requestTime का इस्तेमाल करके, पिछले 24 घंटों के अंदर भेजा गया कोई भी मैसेज प्रोसेस किया जाएगा और मैसेज को खारिज नहीं किया जाएगा.

मैसेज requestTime के क्रम में प्रोसेस किए जाते हैं, भले ही वे किसी भी क्रम में मिले हों. उदाहरण के लिए, अगर उसी यात्रा की योजना के लिए 2019-05-03T14:10:00Z के requestTime वाला मैसेज मिलता है, तो 2019-05-03T14:09:00Z के requestTime के साथ किराये का अपडेट मिलने पर, उसे बाद में टाइमस्टैंप वाले मैसेज के बजाय खारिज कर दिया जाएगा.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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

उस पैकेज डेटा का यूनीक आईडी जिससे इस कीमत की जानकारी मिलती है. आपने पैकेज डेटा में जो डेटा भेजा है उससे रूम बंडल के डेटा का मिलान करने के लिए, इस आईडी का इस्तेमाल करें. ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.

अगर ratePlanId में जानकारी अपने-आप भर जाती है, तो roomTypeId को भी भरा जाना चाहिए.

LosOccupancyPrices

ठहरने की कुल अवधि के किराये को वयस्कों के लिए की गई बुकिंग के हिसाब से अलग-अलग ग्रुप में दिखाया जाता है.

JSON के काेड में दिखाना 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
फ़ील्ड
prices[]

object (LosPrices)

ठहरने की कुल अवधि के हिसाब से किराया. prices में सभी कीमतें किसी खास प्रॉपर्टी, पहुंचने की तारीख, प्रॉडक्ट, और बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या के हिसाब से लागू होती हैं.
adults

integer

एक कमरे में ज़्यादा से ज़्यादा कितने मेहमानों को कमरा बुक किया जा सकता है. इनमें वयस्क और बच्चे भी शामिल हैं. यह वैल्यू, OcupancyPrices फ़ील्ड में मौजूद सभी किराये के लिए सेट की गई है. साथ ही, यह 1 और 99 के बीच का एक पूर्णांक होना चाहिए.

LosPrices

ठहरने की कुल अवधि के हिसाब से किराया.

JSON के काेड में दिखाना 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
फ़ील्ड
rates[]

number

ठहरने की कुल अवधि के हिसाब से, मूल किराये का कॉम्पोनेंट.

अगर इससे जुड़ी taxes वैल्यू दी जाती है, तो इस दर में टैक्स शामिल नहीं होगा. कुल कीमत, उस दर और टैक्स का योग होगी.

किराये की जानकारी, कॉमा लगाकर अलग की गई सूची में होनी चाहिए. इंडेक्स n में दी गई वैल्यू, ठहरने की n+1 अवधि को दिखाती है.

आपको एक बार में 30 कीमतों का पूरा सेट भेजना होगा. अगर 30 से कम कीमतें भेजी जाती हैं, तो हम कम से कम कीमत के लिए दी गई सभी कीमतों को सामान्य रूप से प्रोसेस करेंगे और बाकी किरायों को 30 कम तक की कीमत तक प्रोसेस नहीं करेंगे. अगर आप 30 से ज़्यादा कीमतें भेजते हैं, तो हम 30वीं दर के बाद भेजी जाने वाली किसी भी कीमत को हटा देंगे.

ठहरने की कुल अवधि 0 की मदद से दिखाई जानी चाहिए.
taxes[]

number

ठहरने की कुल अवधि के हिसाब से, टैक्स का हिस्सा.

टैक्स की एक कॉमा-सेपरेटेड लिस्ट होनी चाहिए. इंडेक्स n में दी गई वैल्यू, ठहरने की n+1 अवधि को दिखाती है.
fees[]

number

ज़रूरी नहीं. ठहरने की कुल अवधि के हिसाब से, शुल्क वाला हिस्सा.

शुल्कों की सूची को कॉमा लगाकर अलग किया जाना चाहिए. इंडेक्स n में दी गई वैल्यू, ठहरने की n+1 अवधि को दिखाती है.
rateRuleId

string

खास किराये के लिए यह आईडी, दर के नियम की परिभाषा वाली फ़ाइल में दी गई दर से मेल खाता है.

इस फ़ील्ड में 40 से ज़्यादा वर्ण नहीं होने चाहिए.
currencyCode

string

तीन अक्षर वाला मुद्रा कोड, जिसमें दरों और टैक्स की जानकारी दी गई है. उदाहरण के लिए, "USD" डॉलर में शुल्क लिया जाएगा.

rates और taxes पर लागू होता है.