Release Notes

Travel Partner API के तीसरे वर्शन में, आपको प्रोग्राम के हिसाब से, इन सुविधाओं के लिए ऐक्सेस मिलता है:

  • Hotel Center और Google Ads के बीच खाते के लिंक को मैनेज करना
  • चुनी गई होटल सेटिंग को मैनेज करना
  • ब्रैंड और आइकॉन (बंद बीटा वर्शन) का मैनेजमेंट
  • प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट से जुड़ी प्रॉपर्टी के ज़रिए प्रॉपर्टी की परफ़ॉर्मेंस का डेटा
  • होटल व्यू सेवा के ज़रिए होटल डेटा
  • हिस्सा लेने की रिपोर्ट से जुड़ी व्यू रिपोर्ट की मदद से, मीटिंग में हिस्सा लेने से जुड़ी रिपोर्ट का डेटा
  • कीमत की सटीक जानकारी वाले व्यू की सेवा का इस्तेमाल करके, किराये की सटीक जानकारी देने वाला डेटा
  • कीमत कवरेज व्यू सेवा के ज़रिए कीमत कवरेज का डेटा
  • कीमत व्यू सेवा के ज़रिए यात्रा की योजना और कीमत तय करने का डेटा
  • मिलान वाली रिपोर्ट से जुड़ी मिलान रिपोर्ट को मैनेज करने की रिपोर्ट (सिर्फ़ कमीशन (होटल में ठहरने पर पैसे चुकाने वाले पार्टनर) के लिए)

एंडपॉइंट

एचटीटीपीएस पार्टनर से, REST के सिंटैक्स के ज़रिए ट्रैवल पार्टनर एपीआई के एंडपॉइंट ऐक्सेस किए जा सकते हैं. सभी अनुरोधों के लिए बेस यूआरएल यह है:

https://travelpartner.googleapis.com

सेवा एंडपॉइंट
खाते के लिंक

Google Ads खाते और Hotel Center खाते के बीच लिंक मैनेज करता है.

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

ब्रैंड

ब्रैंड कॉन्फ़िगरेशन में बदलाव करें. (बंद बीटा वर्शन)

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

होटल

चुनी गई होटल सेटिंग में बदलाव करें.

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

होटल व्यू

होटल व्यू की सूची या खास जानकारी दिखाता है.

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

आइकॉन

आइकॉन मैनेज करें. (बंद बीटा वर्शन)

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

मीटिंग में हिस्सा लेने से जुड़ी रिपोर्ट के व्यू

क्वेरी का इस्तेमाल करके, हिस्सा लेने वाले रिपोर्ट व्यू को दिखाता है. साथ ही, व्यू का फ़िल्टर किया गया सबसेट दिखाता है.

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

सटीक किराया व्यू

किराये की सटीक जानकारी वाला व्यू, उपलब्ध सटीक व्यू या खास जानकारी दिखाता है.

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

कीमत कवरेज व्यू

ताज़ा कीमत कवरेज व्यू या पूरा कवरेज इतिहास दिखाता है.

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

कीमत वाले व्यू

मांगी गई कीमत व्यू की पूरी जानकारी देता है.

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

प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट को देखे जाने की संख्या

क्वेरी का इस्तेमाल करके प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट का व्यू दिखाता है.

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

समाधान रिपोर्ट

कमीशन मिलान की रिपोर्ट बनाता है, उसकी पुष्टि करता है, और उसे फिर से हासिल करता है (सिर्फ़ Hotel Ads के लिए).

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

आप अपना खाता आईडी देखने के लिए, Hotel Ads Center में खाता टैब के खाता जानकारी व्यू पर जाएं.

बदलावों का लॉग

ट्रैवल पार्टनर एपीआई के 2.1 वर्शन की कई सेवाओं को Google Ads API पर माइग्रेट कर दिया गया है. इस वजह से, यात्रा पार्टनर एपीआई v3 में सिर्फ़ होटल की खास सेवाएं दी जाती हैं.

HotelViewService

  • HotelViewService.ListHotelViews (पहले इसका नाम Hotel API था)
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/hotels से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews किया गया है.
    • type अनुरोध का पैरामीटर हटाया गया.
    • जवाब में manifestOnly फ़ील्ड को हटा दिया गया.
    • कुछ फ़ील्ड के नाम बदले गए हैं.
  • HotelViewService.SummarizeHotelViews (पहले स्कोरकार्ड एपीआई में hotel_list_stats था)
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize किया गया है.
    • कुछ फ़ील्ड के नाम बदले गए हैं.

Interact ReportViewService (जिसे पहले स्कोरकार्ड एपीआई में अवसर के तौर पर इस्तेमाल किया जाता था)

  • ParticipationReportService.QueryParticipationReport
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query किया गया है.
    • क्वेरी पैरामीटर जोड़ दिए गए हैं.
    • फ़ील्ड का नाम बदला गया है और इन्हें नए तरीके से बनाया गया है.

PriceAccuracyViewService (पुराना नाम price_accuracy Report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews किया गया है.
    • नया एपीआई, पिछले वर्शन के बजाय होटल व्यू रिसॉर्स के नामों की सूची दिखाता है. इसमें रिपोर्ट की तारीखों की सूची दिखती है.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 किया गया है.
    • CSV आउटपुट अब काम नहीं करता है.
    • कुछ फ़ील्ड के नाम बदले गए हैं.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (पहले स्कोरकार्ड एपीआई में price_coverage_stats_history था)
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews किया गया है.
    • कुछ फ़ील्ड के नाम बदले गए हैं.
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (पहले स्कोरकार्ड एपीआई में price_coverage_stats था)
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest किया गया है.
    • कुछ फ़ील्ड के नाम बदले गए हैं.

PriceViewService (पुराना नाम API)

  • PriceViewService.GetPriceView
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id किया गया है.
    • कुछ फ़ील्ड के नाम बदले गए हैं.
    • जवाब से बोलियों की जानकारी हटा दी गई.

मिलान वाली रिपोर्ट सेवा के तरीके (पहले इसे समाधान रिपोर्ट एपीआई कहा जाता था)

  • ReconciliationReportService.ListReconciliationReports
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports किया गया है.
  • ReconciliationReportService.GetReconciliationReport
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename किया गया है.
  • ReconciliationReportService.CreateReconciliationReport
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports किया गया है.
  • ReconciliationReportService.ValidateReconciliationReport
    • एपीआई एंडपॉइंट को https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate से बदलकर https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate किया गया है.

बंद होना

इसका इस्तेमाल अब नहीं किया जाता
यह बताता है कि एपीआई का वर्शन उम्मीद के मुताबिक काम करता रहेगा, लेकिन हो सकता है कि इसे नई सुविधाओं या गड़बड़ी ठीक किए जाने की जानकारी के साथ अपडेट न किया जा सके. इसके अलावा, जब किसी वर्शन को बंद किया जाता है, तो सूर्यास्त की तारीख तय की जाती है.
सेट नहीं है
यह बताता है कि एपीआई का वर्शन हटा दिया गया है और अब उपलब्ध नहीं है. इस सुविधा को बंद करने और, इसे बंद करने के बीच कम से कम तीन महीने का समय होता है.

इस टेबल में, एपीआई वर्शन के मौजूदा शेड्यूल के साथ-साथ, हटाए जाने और सूरज डूबने के अनुमानित तारीख की जानकारी दी गई है.

वर्शन रोक लगाए जाने की तारीख सूर्यास्त की तारीख
वर्शन 3.0 लागू नहीं लागू नहीं
v2 1 सितंबर 2019 31 मई, 2020
वर्शन 2.0 (बिड एपीआई) फ़रवरी 2018 मई 2018
v2.0 (अन्य सभी एपीआई) सितंबर 2019 15 फ़रवरी, 2020
v1.2 फ़रवरी 2018 मई 2018
वर्शन 1.1 जून 2016 अक्टूबर 2016
वर्शन 1.0 अप्रैल 2015 अक्टूबर 2015

पुष्टि करना

ट्रैवल पार्टनर एपीआई ऐक्सेस करने के लिए, क्लाइंट को OAuth2 पुष्टि का इस्तेमाल करके पुष्टि करनी होगी.

उदाहरण के तौर पर, ट्रैवल पार्टनर एपीआई से कनेक्ट करने के लिए OAuth इस्तेमाल करने के बारे में ज़्यादा जानकारी और ऐप्लिकेशन के बारे में ज़्यादा जानकारी के लिए, एपीआई पुष्टि देखें.