Release Notes

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

  • Hotel Center ile Google Ads arasındaki hesap bağlantılarının yönetimi
  • Seçilen otel ayarlarının yönetimi
  • Markaların ve simgelerin yönetimi (kapalı beta)
  • Mülk Performansı Raporu Görünümleri Hizmeti aracılığıyla mülk performansı verileri
  • Otel Görünümleri 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ünümleri Hizmeti aracılığıyla fiyat kapsamı verileri
  • Fiyat Görünümleri 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ından RESTful söz dizimiyle 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üntülemelerinin listesini veya bir özeti döndürür.

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

Simgeler

Simgeleri yönetebilirsiniz. (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ün 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üntülemeleri

Belirli bir fiyat doğruluğu görünümünü, kullanılabilir doğruluk görünümlerini veya bir özeti 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 kapsamın tamamının 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ü tüm ayrıntılarıyla döndürür.

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

Tesis Performansı Raporu Görünümleri

Bir 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 Hotel Reklamları Merkezi'ndeki Hesap sekmesinin Hesap Bilgileri görünümünde bulabilirsiniz.

Değişiklik günlüğü

Travel Partner API v2.1'deki birçok hizmet Google Ads API'ye taşındı. Bu nedenle, Travel Partner API v3 yalnızca otele özgü hizmetleri korur.

HotelViewService

  • HotelViewService.ListHotelViews (eski adıyla Hotels API)
    • API uç noktası https://www.googleapis.com/travelpartner/v2.1/4200042/hotels iken https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews olarak değiştirildi.
    • type istek parametresi kaldırıldı.
    • Yanıtındaki manifestOnly alanı kaldırıldı.
    • Bazı alanlar yeniden adlandırıldı.
  • HotelViewService.SummarizeHotelViews (eski adıyla Scorecard API'de hotel_list_stats)
    • API uç noktası https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats iken 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'deki opportunity_stats)

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

PriceAccuracyViewService (eski adıyla price_accuracy rapor API'si)

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

PriceCoverageViewService

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

PriceViewService (eski adıyla Prices API)

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

ReconciliationReportService yöntemleri (eski adıyla Mutabakat Raporları API'si)

  • ReconciliationReportService.ListReconciliationReports
    • API uç noktası https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports iken https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports olarak değiştirildi.
  • ReconciliationReportService.GetReconciliationReport
    • API uç noktası https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename iken https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename olarak değiştirildi.
  • ReconciliationReportService.CreateReconciliationReport
    • API uç noktası https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports iken https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports olarak değiştirildi.
  • ReconciliationReportService.ValidateReconciliationReport
    • API uç noktası https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate iken 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 gösterir. Ayrıca, bir sürümün desteği sonlandırıldığında kullanımdan kaldırma tarihi belirlenir.
Kullanımdan kaldırıldı (Sunsetted)
, API sürümünün kaldırıldığını ve artık kullanılamadığını gösterir. Desteğin sonlandırılması ile kullanımdan kaldırılması arasındaki minimum süre 3 aydır.

Aşağıdaki tabloda API sürümlerinin mevcut programı ile beklenen kullanımdan kaldırma ve kullanımdan kaldırılma tarihleri gösterilmektedir:

Sürüm Desteği sonlandırma tarihi Kullanımdan Kaldırma Tarihi
v3.0 Yok Yok
v2.1 Eylül 2019 31 Mayıs 2020
v2.0 (Bids API) Şubat 2018 Mayıs 2018
v2.0 (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
v1.0 Nisan 2015 Ekim 2015

Kimlik doğrulama

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

Örnek bir uygulama ve Travel Partner API'ye bağlanmak için OAuth'u kullanma hakkında ek bilgi için API Kimlik Doğrulaması başlıklı makaleyi inceleyin.