Usage

Bu sayfada, Travel Partner API v3 sürümünü kullanan bazı örnek aramalar sunulmaktadır.

Travel Partner API uç noktaları, HTTPS çağrıları aracılığıyla REST özellikli söz dizimi kullanır. 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.

Mülk Performansı Raporu

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

Oteller

Otel Görünümü Hizmeti, tüm otellerin listesini veya belirli bir hesap için otellerin özetini sağlar.

Otellerin listesini alma

Aşağıdaki örnekte, 12345678 hesabındaki tüm otellerin listesi gösterilmektedir:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelviews

İstek, çok sayfalı sonuçlarda gezinmek için sorgu parametrelerini kabul eder:

GET base_url/hotelviews?pageSize=10&pageToken=11

Tesis özeti alma

Bu örnekte, 12345678 hesabına ait mülklerin özeti gösterilmiştir:

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 hesap için bir katılım raporunu sorgulama (alma, filtreleme, segmentlere ayırma) olanağı sağlar.

Katılım raporu sorgulama

Aşağıdaki örnekte 12345678 hesabındaki tüm mülkler için katılım raporu alınmış ve 10.04.2020 tarihi kullanılarak rapor filtrelenmiştir.

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ünüm Hizmeti, belirli bir hesabın fiyat doğruluk raporlarının ve puan kartlarının alınmasını sağlar.

Fiyat doğruluğu raporu alma

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

Sonuçlara göz atmak 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ı istatistikleri alınıyor

Aşağıdaki örnek, 12345678 hesabı için en son fiyat kapsamı istatistiklerini alır:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

Fiyat kapsamı geçmişini alma

Bu istek, bir hesap için 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 tesis için fiyat raporu almanızı sağlar.

Tesis 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

Mutabakat raporlarının listesini alma

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

Mutabakat raporunu 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. 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

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