Mülk Performans Raporu Görünüm Hizmeti, belirli bir hesap için bir mülk performans raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sağlar.
Mülk performans raporunu sorgulama
Aşağıdaki örnekte, 12345678 hesabındaki tüm tesisler için 11 Mayıs 2022 tarihine göre filtrelenmiş ve iş ortağı otel kimliğine göre gruplandırılmış tesis performans raporu alınmıştır.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Aşağıdaki örnek, 12345678 hesabı için 26.08.2019 tarihli fiyat doğruluğu raporunu alır:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Yanıta göre sayfalara ayırmaya ilişkin normal sorgu parametrelerinin yanı sıra, sonuçlara eşleşen fiyatlar veya piksel sinyalleri eklemek için birkaç parametre daha bulunur.
Bu örnekte, 26.08.2019 tarihli fiyat doğruluğu raporu eşleşen fiyatları ve piksel sinyallerini içerir:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Mevcut fiyat doğruluğu raporlarını listeleme
Kullanılabilen raporların listesini almak için bu isteği gönderin:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Aşağıdaki örnekte 12345678 hesabı için raporların bir listesi verilmiştir:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Sonuçları sınırlamak için isteğe bağlı başlangıç ve bitiş tarihi sorgu parametreleri ekleyebilirsiniz. Örneğin, bu sorgu raporları yalnızca 15.06.2019 ile 15.9.2019 arasındaki raporları kapsamaktadır:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Bu örnek, 2019-08-26T12:00:00 tarihinde yüklenen booking_report.csv raporunu (JSON yanıtı olarak) alır:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Örnek yanıt
{
"contents": "Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status\n\n111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
Mutabakat raporunu doğrulama
Bu yöntemi, raporu yüklemeden önce doğrulamak için kullanabilirsiniz. Doğrulanan bir rapor yüklenmez.
Mutabakat raporu, isteğin gövde metnine contents alanının değeri olarak eklenir. Mutabakat raporu, Mutabakat raporları bölümünde açıklanan söz dizimine uygun olmalıdır.
Aşağıdaki örnek, 12345678 hesabı için bir raporu doğrular:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Örnek başarılı yanıt
{
"successfulRecordCount": 3
}
Mutabakat raporu yükleme
Mutabakat raporunun geçerli olduğunu onayladıktan sonra aşağıdaki örnekte olduğu gibi, raporu Google'a yükleyebilirsiniz:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Tüm hakları saklıdır. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2022-08-23 UTC.
[null,null,["Son güncelleme tarihi: 2022-08-23 UTC."],[[["The Travel Partner API uses REST-ful syntax for HTTPS calls to various endpoints, allowing access to data like property performance, hotel details, and price accuracy."],["You can query reports, like the Property Performance Report or the Participation Report, to gain insights into your hotel data using specific filters and aggregations."],["The API provides methods for retrieving hotel lists, summaries, price coverage information, and pricing data for individual properties within your account."],["Reconciliation Reports, specifically for Hotel Ads, can be listed, downloaded, validated, and uploaded through dedicated API endpoints."],["The base URL for all API requests is `https://travelpartner.googleapis.com/v3/accounts/account_id`, and detailed documentation for resources is available in the API resources catalog."]]],[]]