Release Notes

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

  • Hotel Center और Google Ads खातों के बीच लिंक मैनेज करना
  • चुनी गई होटल सेटिंग मैनेज करना
  • ब्रैंड और आइकॉन मैनेज करने की सुविधा (प्राइवेट बीटा)
  • प्रॉपर्टी की परफ़ॉर्मेंस का डेटा, Property Performance Report Views Service के ज़रिए
  • Hotel Views Service के ज़रिए होटल का डेटा
  • 'कितने दिन तक शामिल रहे' रिपोर्ट का डेटा, Participation Report Views Service के ज़रिए
  • Price Accuracy Views Service के ज़रिए, कीमत की सटीक जानकारी देने वाला डेटा
  • कीमत की जानकारी वाले व्यू की सेवा के ज़रिए, कीमत की जानकारी वाला डेटा
  • Price Views Service के ज़रिए यात्रा कार्यक्रम और किराये का डेटा
  • कमीशन के हिसाब-किताब की रिपोर्ट को मैनेज करना. इसके लिए, हिसाब-किताब की रिपोर्ट से जुड़ी सेवा का इस्तेमाल किया जाता है. यह सेवा सिर्फ़ उन पार्टनर के लिए है जो होटल में ठहरने पर कमीशन चुकाते हैं

एंडपॉइंट

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

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 में, खाता टैब के खाते की जानकारी व्यू में जाकर, अपना खाता आईडी देखा जा सकता है.

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

Travel Partner API v2.1 की कई सेवाओं को Google Ads API पर माइग्रेट कर दिया गया है. इसलिए, Travel Partner API v3 में सिर्फ़ होटल से जुड़ी सेवाएं उपलब्ध हैं.

HotelViewService

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

ParticipationReportViewService (इसे पहले Scorecard API में opportunity_stats कहा जाता था)

  • 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 (पहले Scorecard API में 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 (पहले Scorecard API में 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 (पहले इसे Prices 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 के तरीके (इन्हें पहले Reconciliation Reports API कहा जाता था)

  • 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 कर दिया गया है.

बंद की गई सेवाएं/सुविधाएं

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

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

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

पुष्टि करना

Travel Partner API को ऐक्सेस करने के लिए, क्लाइंट को OAuth2 ऑथेंटिकेशन का इस्तेमाल करके पुष्टि करनी होगी.

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