Method: accounts.properties.ingestLosPropertyPrices

Perbarui harga untuk satu properti menggunakan harga berformat lama menginap. Untuk properti tertentu, semua tanggal kedatangan dalam rentang yang diminta akan diganti semua harga propertinya, termasuk semua produk dan jumlah tamu. Harga dengan tanggal kedatangan di luar rentang tanggal yang ditentukan tidak akan terpengaruh.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
propertyPrices.property

string

Nama resource PropertyPrices. Memiliki formulir accounts/{account_id}/properties/{property_id}.

account_id: Nilai string ini adalah "Account ID" yang tercantum di halaman Setelan akun di Pusat Pengelolaan Hotel.

property_id: Nilai elemen ini harus berupa string yang cocok dengan ID listingan di Feed Daftar Hotel Anda.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Kolom
requestTime

string (Timestamp format)

Wajib diisi. Waktu saat pesan LoS Price dikirim, yang dinyatakan sebagai string berformat RFC 3339.

Setiap pesan yang dikirim dengan requestTime dalam 24 jam sebelumnya akan diproses, dan yang belum dikirim akan dihapus.

Pesan diproses dalam urutan requestTime, terlepas dari urutan penerimaannya. Misalnya, pembaruan harga dengan requestTime 2019-05-03T14:09:00Z yang diterima setelah pesan untuk itinerari yang sama dengan requestTime 2019-05-03T14:10:00Z akan dihapus dan digantikan oleh pesan yang diberi stempel waktu berikutnya.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Harga untuk tanggal kedatangan. Semua harga dalam arrivalDayPrices ini berlaku untuk properti tertentu, tetapi tanggal kedatangan berbeda.

Isi respons

Jika berhasil, isi respons memuat instance PropertyPrices.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

LosPropertyPrices

Harga panjang masa inap, yang ditentukan di tingkat properti.

Representasi JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Kolom
arrivalDatePrices[]

object (LosArrivalDatePrices)

Harga untuk tanggal kedatangan. Semua harga dalam arrivalDayPrices ini berlaku untuk properti tertentu, tetapi tanggal kedatangan berbeda.
property

string

Nama resource PropertyPrices. Memiliki formulir accounts/{account_id}/properties/{property_id}.

account_id: Nilai string ini adalah "Account ID" yang tercantum di halaman Setelan akun di Pusat Pengelolaan Hotel.

property_id: Nilai elemen ini harus berupa string yang cocok dengan ID listingan di Feed Daftar Hotel Anda.

LosArrivalDatePrices

Harga panjang masa inap, dikelompokkan menurut rentang tanggal kedatangan.

Representasi JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Kolom
productPrices[]

object (LosProductPrices)

Harga untuk suatu produk. Semua harga dalam productPrices ini berlaku untuk properti tertentu, kombinasi tanggal kedatangan, tetapi produknya berbeda.
startDate

object (Date)

productPrices akan diterapkan ke semua tanggal kedatangan antara startDate dan endDate, inklusif.

Jika hanya mencoba menentukan satu tanggal kedatangan (dan bukan rentang), endDate dapat dihilangkan.
endDate

object (Date)

productPrices akan diterapkan ke semua tanggal kedatangan antara startDate dan endDate, inklusif.

Jika hanya mencoba menentukan satu tanggal kedatangan (dan bukan rentang), endDate dapat dihilangkan.

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

LosProductPrices

Harga lama menginap, yang dikelompokkan menurut jenis produk (kombinasi roomTypeId/ratePlanId).

Representasi JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Kolom
occupancyPrices[]

object (LosOccupancyPrices)

Harga untuk jumlah tamu. Semua harga dalam occupancyPrices ini berlaku untuk properti, tanggal kedatangan, dan kombinasi produk tertentu, tetapi untuk jumlah tamu yang berbeda.
roomTypeId

string

ID unik untuk kamar yang dirujuk harga ini. Gunakan ID ini untuk mencocokkan data Paket Kamar dengan data yang Anda kirim dalam data kamar. Untuk mengetahui informasi selengkapnya, lihat metadata Paket Kamar.

Jika roomTypeId diisi, ratePlanId juga harus diisi.
ratePlanId

string

ID unik untuk data paket yang dirujuk oleh harga ini. Gunakan ID ini untuk mencocokkan data Paket Kamar dengan data yang Anda kirim dalam data paket. Untuk mengetahui informasi selengkapnya, lihat metadata Paket Kamar.

Jika ratePlanId diisi, roomTypeId juga harus diisi.

LosOccupancyPrices

Harga lama menginap, dikelompokkan menurut jumlah tamu dewasa.

Representasi JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Kolom
prices[]

object (LosPrices)

Harga panjang masa inap. Semua harga di prices berlaku untuk kombinasi properti, tanggal kedatangan, produk, dan jumlah tamu tertentu.
adults

integer

Jumlah maksimum tamu yang dapat dipesan per kamar, termasuk dewasa dan anak-anak. Nilai ini ditetapkan untuk semua tarif dalam kolom jumlah tamu yang sesuai dan harus berupa bilangan bulat positif antara 1 dan 99.

LosPrices

Harga panjang masa inap.

Representasi JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Kolom
rates[]

number

Komponen tarif dasar dari harga lama menginap.

Jika nilai taxes yang sesuai diberikan, tarif ini tidak termasuk pajak (harga total adalah jumlah dari tarif dan pajak yang relevan).

Harus berupa daftar tarif yang dipisahkan koma. Nilai pada indeks n sesuai dengan lama menginap n+1.

Anda harus mengirimkan rangkaian lengkap LoS yang berisi 30 harga sekaligus. Jika Anda mengirim kurang dari 30, kami akan memproses semua harga LoS yang diberikan seperti biasa, dan tarif lainnya tidak tersedia hingga LoS 30. Jika Anda mengirim lebih dari 30 harga, kami akan menurunkan harga yang Anda kirim di luar tarif ke-30.

Panjang masa inap yang tidak tersedia harus ditampilkan dengan 0.
taxes[]

number

Komponen pajak harga lama menginap.

Harus berupa daftar pajak yang dipisahkan koma. Nilai pada indeks n sesuai dengan lama menginap n+1.
fees[]

number

Opsional. Komponen biaya harga lama menginap.

Harus berupa daftar biaya yang dipisahkan dengan koma. Nilai pada indeks n sesuai dengan lama menginap n+1.
rateRuleId

string

Untuk tarif bersyarat, ID ini mencocokkan tarif dengan definisi di file Definisi Aturan Tarif Anda.

Batas karakter untuk kolom ini adalah 40 karakter.
currencyCode

string

Kode mata uang tiga huruf tempat tarif dan pajak diberikan. Misalnya, "USD" untuk dolar AS.

Berlaku untuk rates dan taxes.