Release Notes

Travel Partner API'nin 3. sürümü, aşağıdakilere programatik erişim sağlar:

  • Hotel Center ile Google Ads arasındaki hesap bağlantılarının yönetilmesi
  • Seçilen otel ayarlarının yönetimi
  • Markaların ve simgelerin yönetimi (kapalı beta)
  • Mülk Performans Raporu Görüntüleme Hizmeti aracılığıyla mülk performans verileri
  • Otel Görüntüleme Hizmeti aracılığıyla otel verileri
  • Katılım Raporu Görüntüleme Hizmeti aracılığıyla katılım raporu verileri
  • Fiyat Doğruluğu Görüntüleme Hizmeti aracılığıyla fiyat doğruluğu verileri
  • Fiyat Kapsamı Görüntüleme Hizmeti aracılığıyla fiyat kapsamı verileri
  • Fiyat Görüntüleme Hizmeti aracılığıyla seyahat planı ve fiyatlandırma verileri
  • Mutabakat Raporları Hizmeti aracılığıyla komisyon mutabakat raporlarının yönetimi (yalnızca konaklama başına ödeme komisyonu iş ortakları)

Uç noktalar

Travel Partner API uç noktalarına HTTPS çağrılarındaki REST uyumlu söz dizimi üzerinden erişilebilir. Tüm isteklerin temel URL'si şudur:

https://travelpartner.googleapis.com

Hizmet uç noktaları
Hesap Bağlantıları

Google Ads hesabı ile Hotel Center hesabı arasındaki bağlantıları yönetir.

POST /v3/accounts/account id/accountLinks
DELETE /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks
PATCH /v3/accounts/account id/accountLinks/account link id

Markalar

Marka yapılandırmasını değiştirin. (kapalı beta)

POST /v3/accounts/account id/brands
GET /v3/accounts/account id/brands
PATCH /v3/accounts/account id/brands/brand id

Oteller

Seçilen otel ayarlarını değiştirin.

POST /v3/accounts/account id/hotels:setLiveOnGoogle

Otel Görüntülemeleri

Otel görünümlerinin listesini veya bir özeti döndürür.

GET /v3/accounts/account id/hotelViews
GET /v3/accounts/account id/hotelViews:summarize

Simgeler

Simgeleri yönet. (kapalı beta)

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

Katılım Raporu Görüntülemeleri

Katılım raporu görünümü döndürür veya sorgu kullanarak görünüm verilerinin filtrelenmiş bir alt kümesini döndürür.

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

Fiyat Doğruluğu Görünümleri

Belirli bir fiyat doğruluğu görünümü, kullanılabilir doğruluk görünümleri veya özet döndürür.

GET /v3/accounts/account id/priceAccuracyViews/report date
GET /v3/accounts/account id/priceAccuracyViews
GET /v3/accounts/account id/priceAccuracyViews:summarize

Fiyat Kapsamı Görüntülemeleri

En son fiyat kapsamı görünümünü veya tüm kapsam geçmişini döndürür.

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

Fiyat Görüntüleme Sayısı

İstenen fiyat görünümünü ayrıntılı olarak döndürür.

GET /v3/accounts/account id/priceViews/partner hotel id

Mülk Performans Raporu Görüntülemeleri

Sorgu kullanarak mülk performans raporu görünümü döndürür.

GET /v3/accounts/account id/participationReportViews:query

Mutabakat Raporları

Komisyon mutabakat raporları oluşturur, doğrular ve alır (yalnızca Otel Reklamları).

POST /v3/accounts/account id/reconciliationReports
POST /v3/accounts/account id/reconciliationReports:validate
GET /v3/accounts/account id/reconciliationReports/datetime~filename
GET /v3/accounts/account id/reconciliationReports

Hesap kimliğinizi, Otel Reklamları Merkezi'ndaki Hesap sekmesinde yer alan Hesap Bilgileri görünümünde bulabilirsiniz.

Değişiklik günlüğü

Travel Partner API'nin 2.1 sürümündeki birçok hizmet, Google Ads API'ye taşınmıştır. Sonuç olarak Travel Partner API v3 yalnızca otele özgü hizmetleri tutar.

HotelViewService

  • HotelViewService.ListHotelViews (eski adıyla Hotels API)
    • https://www.googleapis.com/travelpartner/v2.1/4200042/hotels olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews olarak değiştirildi.
    • type istek parametresi kaldırıldı.
    • Yanıttaki manifestOnly alanı kaldırıldı.
    • Bazı alanlar yeniden adlandırıldı.
  • HotelViewService.SummarizeHotelViews (Puan Kartı API'sinde eski adı hotel_list_stats)
    • https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize olarak değiştirildi.
    • Bazı alanlar yeniden adlandırıldı.

ParticipationReportViewService (eski adıyla Scorecard API'de fırsatı_stats)

  • ParticipationReportService.QueryParticipationReport
    • https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query olarak değiştirildi.
    • Sorgu parametreleri eklendi.
    • Alanlar yeniden adlandırıldı ve yeniden yapılandırıldı.

PriceAccuracyViewService (eski adıyla price_accuracy report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews olarak değiştirildi.
    • Yeni API, önceki sürümün aksine otel görünümü kaynak adlarının bir listesini döndürür. Bu liste, rapor tarihlerinin listesini döndürür.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 olarak değiştirildi.
    • CSV çıkışı artık desteklenmiyor.
    • Bazı alanlar yeniden adlandırıldı.

Fiyat Kapsamı Görüntüleme Hizmeti

  • PriceAccuracyViewService.ListPriceCoverageViews (Puan Kartı API'sinde eski adı price_coverage_stats_history)
    • https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews olarak değiştirildi.
    • Bazı alanlar yeniden adlandırıldı.
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (Puan Kartı API'sinde eski adı price_coverage_stats)
    • https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest olarak değiştirildi.
    • Bazı alanlar yeniden adlandırıldı.

PriceViewService (eski adıyla Price API)

  • PriceViewService.GetPriceView
    • https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id olarak değiştirildi.
    • Bazı alanlar yeniden adlandırıldı.
    • Yanıttaki teklif bilgileri kaldırıldı.

ReconciliationReportService yöntemleri (eski adıyla Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports olarak değiştirildi.
  • ReconciliationReportService.GetReconciliationReport
    • https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename olarak değiştirildi.
  • ReconciliationReportService.CreateReconciliationReport
    • https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports olarak değiştirildi.
  • ReconciliationReportService.ValidateReconciliationReport
    • https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate olan API uç noktası https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate olarak değiştirildi.

Kullanımdan Kaldırma

Kullanımdan kaldırıldı
, API sürümünün beklendiği gibi çalışmaya devam edeceğini ancak yeni özellikler veya hata düzeltmeleriyle güncellenmeyebileceğini belirtir. Ayrıca, bir sürüm kullanımdan kaldırıldığında son kullanma tarihi belirlenir.
Kullanımdan kaldırıldı
, API'nin sürümünün kaldırıldığını ve artık kullanılamadığını belirtir. Kullanımdan kaldırma ve kullanımdan kaldırma arasındaki minimum süre 3 aydır.

Aşağıdaki tabloda, API sürümlerinin mevcut programıyla birlikte kullanımdan kaldırma ve kullanımdan kaldırmanın beklenen tarihleri gösterilmektedir:

Sürüm Kullanımdan Kaldırma Tarihi Gün Batımı Tarihi
sürüm 3.0 Yok Yok
sürüm 2.1 Eylül 2019 31 Mayıs 2020
2.0 sürümü (Bids API) Şubat 2018 Mayıs 2018
2.0 sürümü (diğer tüm API'ler) Eylül 2019 15 Şubat 2020
v1.2 Şubat 2018 Mayıs 2018
v1.1 Haziran 2016 Ekim 2016
sürüm 1.0 Nisan 2015 Ekim 2015

Kimlik doğrulama

Travel Partner API'ye erişmek için istemcilerin OAuth2 kimlik doğrulaması kullanarak kimlik doğrulaması yapması gerekir.

Travel Partner API'ye bağlanmak için OAuth kullanma hakkında örnek bir uygulama ve ek bilgiler için API Kimlik Doğrulaması konusuna bakın.