Usage

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