Bu sayfada, Travel Partner API v3'ü kullanan bazı örnek çağrılar sunulmaktadır.
Travel Partner API uç noktaları, HTTPS çağrılarında RESTful söz dizimini kabul eder. Tüm API istekleri için base_url:
https://travelpartner.googleapis.com/v3/accounts/account_id
İstek ve yanıt alanlarının tam listesi için API kaynakları kataloğuna göz atın.
Tesis performansı raporu
Mülk Performansı Raporu Görüntüleme Hizmeti, belirli bir hesaba ait mülk performansı raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sunar.
Mülk performans raporuna sorgu gönderme
Aşağıdaki örnekte, 12345678
kimlikli hesaptaki tüm tesisler için tesis performansı raporu alınır, 11 Mayıs 2022 tarihine göre filtrelenir ve iş ortağı otel kimliğine göre gruplandırılır.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Oteller
Otel Görünümü Hizmeti, belirli bir hesap için tüm otellerin listesini veya özetini sağlar.
Otel listesi alma
Aşağıdaki örnekte, 12345678
hesabındaki tüm otellerin listesi alınmaktadır:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
İstek, çok sayfalı sonuçlar arasında gezinmek için sorgu parametrelerini kabul eder:
GET base_url/hotelViews?pageSize=10&pageToken=11
Mülk özeti alma
Bu örnek, 12345678
hesabı için mülklerin özetini alır:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Katılım raporu
Katılım Raporu Görüntüleme Hizmeti, belirli bir hesaba ait katılım raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sunar.
Katılım raporu sorgulama
Aşağıdaki örnekte, 12345678
hesabındaki tüm mülklerin katılım raporu alınır ve rapor 04.10.2020 tarihi kullanılarak filtrelenir.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Fiyat doğruluğu
Fiyat Doğruluğu Görüntüleme Hizmeti, belirli bir hesap için fiyat doğruluğu raporlarının ve puan kartlarının alınmasını sağlar.
Fiyat doğruluğu raporu alma
Aşağıdaki örnekte, 12345678
kimlikli hesap için 26.08.2019 tarihinde fiyat doğruluk raporu alınmaktadır:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Yanıt içinde sayfalandırma için kullanılan normal sorgu parametrelerinin yanı sıra, eşleşen fiyatları veya piksel sinyallerini sonuçlara dahil etmek için birkaç parametre daha vardır.
Bu örnekte, 26.08.2019 tarihli fiyat doğruluğu raporunda eşleşen fiyatlar ve piksel sinyalleri yer almaktadır:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Mevcut fiyat doğruluğu raporlarını listeleme
Kullanılabilir raporların listesini almak için şu isteği gönderin:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Sonuçlar arasında gezinmek için normal sorgu parametrelerini ekleyebilirsiniz.
Fiyat doğruluk puanı alma
Fiyat doğruluğu puan kartını almak için summarize
yöntemini kullanın:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Fiyat kapsamı
Fiyat Kapsamı Görüntüleme Hizmeti, en son fiyat kapsamı raporunu veya fiyat kapsamı geçmişinin tamamını sağlar.
En son fiyat kapsamı istatistiklerini alma
Aşağıdaki örnekte, 12345678
kimlikli hesap için en son fiyat kapsamı istatistikleri alınmaktadır:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Fiyat kapsamı geçmişini alma
Bu istek, bir hesabın fiyat kapsamı geçmişinin tamamını alır:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Fiyat
Fiyat Görüntüleme Hizmeti, belirli bir mülk için fiyat raporu almanıza olanak tanır.
Bir mülk için fiyatlandırma verilerini alma
12345678
hesabına ait belirli bir otelin (ID=101
) fiyatlandırma raporunu almak için şu isteği gönderin:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Mutabakat raporları
Mutabakat Raporları Hizmeti, rapor listesi almanıza, belirli bir raporu indirmenize, doğrulamanıza ve ardından raporu Google'a yüklemenize olanak tanır.
Mutabakat raporlarının listesini alma
Aşağıdaki örnekte, 12345678
hesabı için rapor listesi alınır:
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 parametrelerini ekleyebilirsiniz. Örneğin, bu sorgu raporları yalnızca 15.06.2019 ile 15.09.2019 arasındaki raporlarla sınırlar:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Mutabakat raporu indirme
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
Mutabakat raporunu doğrulama
Bu yöntemi, raporu yüklemeden önce doğrulamak için kullanabilirsiniz. Bir raporun doğrulanması, raporun yüklenmesine neden olmaz.
Mutabakat raporu, contents
alanının değeri olarak isteğin gövdesine eklenir. Mutabakat raporu, Mutabakat raporları bölümünde açıklanan söz dizimine uygun olmalıdır.
Aşağıdaki örnekte, 12345678
hesabı için bir rapor doğrulanıyor:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Mutabakat raporu yükleme
Bir mutabakat raporunun geçerli olduğunu onayladıktan sonra, bu örnekteki gibi Google'a yükleyebilirsiniz:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports