Method: accounts.properties.ingestLosPropertyPrices

Konaklama süresi biçimindeki fiyatları kullanarak tek bir tesisin fiyatlarını güncelleyin. Belirli bir tesis için, istenen aralıktaki her varış tarihinde, tüm ürünler ve doluluk dahil olmak üzere tüm KS fiyatları değiştirilir. Varış tarihleri, belirtilen tarih aralıklarının dışında olan fiyatlar bundan etkilenmez.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
propertyPrices.property

string

PropertyPrices öğesinin kaynak adı. accounts/{account_id}/properties/{property_id} biçimindedir.

account_id: Bu dize değeri "Account ID"dir. değerinin Hotel Center'daki Hesap ayarları sayfasında listelenen değeri değiştirin.

property_id: Bu öğenin değeri, Otel Listesi Feed'inizdeki giriş kimliğiyle eşleşen bir dize olmalıdır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Alanlar
requestTime

string (Timestamp format)

Zorunlu. RFC 3339 biçimli bir dize olarak ifade edilen, LoS Fiyat mesajının gönderildiği an.

Son 24 saat içinde requestTime ile gönderilen tüm iletiler işlenir ve alınmayanlar silinir.

Mesajlar, alındıkları sıraya bakılmaksızın requestTime sırasına göre işlenir. Örneğin, aynı seyahat planları için requestTime değerindeki 2019-05-03T14:10:00Z tutarındaki mesajdan sonra alınan, 2019-05-03T14:09:00Z tutarındaki requestTime tutarındaki fiyat güncellemesi silinir ve zaman damgası bulunan sonraki mesajın gösterilir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Varış tarihi için fiyatlar. Bu arrivalDayPrices içindeki tüm fiyatlar, belirli bir tesis için geçerlidir ancak varış tarihleri farklı.

Yanıt gövdesi

Başarılıysa yanıt metni, PropertyPrices öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

LosPropertyPrices

Tesis düzeyinde belirtilen konaklama süresi fiyatlarıdır.

JSON gösterimi
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Alanlar
arrivalDatePrices[]

object (LosArrivalDatePrices)

Varış tarihi için fiyatlar. Bu arrivalDayPrices içindeki tüm fiyatlar, belirli bir tesis için geçerlidir ancak varış tarihleri farklı.

property

string

PropertyPrices öğesinin kaynak adı. accounts/{account_id}/properties/{property_id} biçimindedir.

account_id: Bu dize değeri "Account ID"dir. değerinin Hotel Center'daki Hesap ayarları sayfasında listelenen değeri değiştirin.

property_id: Bu öğenin değeri, Otel Listesi Feed'inizdeki giriş kimliğiyle eşleşen bir dize olmalıdır.

LosArrivalDatePrices

Varış tarihi aralıklarına göre gruplandırılmış konaklama süresi fiyatları.

JSON gösterimi
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Alanlar
productPrices[]

object (LosProductPrices)

Bir ürünün fiyatları. Bu productPrices içindeki tüm fiyatlar belirli bir tesis, varış tarihi kombinasyonu için geçerlidir ancak farklı ürünler için geçerlidir.

startDate

object (Date)

productPrices tutarı, startDate ile endDate arasındaki tüm varış tarihlerine (bu tarihler dahil) uygulanacaktır.

Yalnızca tek bir varış tarihi belirtmeye çalışıyorsanız (aralık belirtilmiyorsa) endDate atlanabilir.

endDate

object (Date)

productPrices tutarı, startDate ile endDate arasındaki tüm varış tarihlerine (bu tarihler dahil) uygulanacaktır.

Yalnızca tek bir varış tarihi belirtmeye çalışıyorsanız (aralık belirtilmiyorsa) endDate atlanabilir.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.

month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

LosProductPrices

Ürün türüne (roomTypeId/ratePlanId kombinasyonları) göre gruplandırılmış konaklama süresi fiyatları.

JSON gösterimi
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Alanlar
occupancyPrices[]

object (LosOccupancyPrices)

Doluluk sayısına göre belirlenen fiyatlar. Bu occupancyPrices içindeki tüm fiyatlar belirli bir tesis, varış tarihi, ürün kombinasyonu için ancak farklı doluluk değerleri için geçerlidir.

roomTypeId

string

Bu fiyatın atıfta bulunduğu odanın benzersiz kimliği. Oda Paketi verilerini oda verilerinde gönderdiklerinizle eşleştirmek için bu kimliği kullanın. Daha fazla bilgi için Oda Paketi meta verileri konusuna bakın.

roomTypeId doldurulursa ratePlanId alanının da doldurulması gerekir.

ratePlanId

string

Bu fiyatın işaret ettiği paket verilerinin benzersiz kimliği. Oda Paketi verilerini, paket verilerinde gönderdiklerinizle eşleştirmek için bu kimliği kullanın. Daha fazla bilgi için Oda Paketi meta verileri konusuna bakın.

ratePlanId doldurulursa roomTypeId alanının da doldurulması gerekir.

LosOccupancyPrices

Yetişkin sayısına göre gruplandırılmış konaklama süresi fiyatları.

JSON gösterimi
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Alanlar
prices[]

object (LosPrices)

Konaklama süresi fiyatları. prices içindeki tüm fiyatlar belirli bir tesis, varış tarihi, ürün ve doluluk kombinasyonu için geçerlidir.

adults

integer

Yetişkinler ve çocuklar da dahil olmak üzere oda başına rezervasyon yapılabilen maksimum konuk sayısıdır. Bu değer, ilgili doluluk değerleri alanındaki tüm fiyatlar için belirlenir ve 1 ile 99 arasında pozitif bir tam sayı olmalıdır.

LosPrices

Konaklama süresi fiyatları.

JSON gösterimi
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Alanlar
rates[]

number

Konaklama süresi fiyatlarının taban ücret bileşeni.

Karşılık gelen bir taxes değeri sağlanırsa bu oran vergiyi içermez (toplam fiyat ilgili oran ve verginin toplamı olur).

Virgülle ayrılmış ücret listesi olmalıdır. n dizinindeki değer, n+1 konaklama süresine karşılık gelir.

30 fiyatlık KS grubunun tamamını tek seferde göndermeniz gerekir. 30 KS'den az ücret gönderirseniz, sağlanan tüm KS fiyatları normal şekilde işleme alınır. Geri kalan ücretler ise 30 KS'ye kadar kullanılamaz. 30'dan fazla fiyat gönderirseniz 30. ücretten sonra göndereceğiniz tüm fiyatlar düşürülür.

Müsait olmayan konaklama süreleri 0 ile gösterilmelidir.

taxes[]

number

Konaklama süresi fiyatlarının vergi bileşeni.

Virgülle ayrılmış bir vergi listesi olmalıdır. n dizinindeki değer, n+1 konaklama süresine karşılık gelir.

fees[]

number

İsteğe bağlı. Konaklama süresi fiyatlarının ücret bileşeni.

Virgülle ayrılmış bir ücret listesi olmalıdır. n dizinindeki değer, n+1 konaklama süresine karşılık gelir.

rateRuleId

string

Koşullu fiyatlar için bu kimlik, ücreti Ücret Kuralı Tanımlama dosyanızdaki bir tanımla eşleştirir.

Bu alan için karakter sınırı 40 karakterdir.

currencyCode

string

Oranların ve vergilerin sağlandığı üç harfli para birimi kodu. Örneğin, "USD" ABD doları cinsinden alınacaktır.

rates ve taxes için geçerlidir.