Usage

इस पेज पर, Travel Partner API v3 का इस्तेमाल करके किए गए कुछ सैंपल कॉल दिए गए हैं.

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

https://travelpartner.googleapis.com/v3/accounts/account_id

अनुरोध और रिस्पॉन्स फ़ील्ड की पूरी सूची देखने के लिए, एपीआई रिसॉर्स कैटलॉग देखें.

प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट

प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट व्यू सर्विस की मदद से, किसी खाते के लिए प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट को क्वेरी किया जा सकता है. जैसे, रिपोर्ट को पाना, फ़िल्टर करना, और सेगमेंट करना.

प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट के लिए क्वेरी करना

यहां दिए गए उदाहरण में, खाते 12345678 में मौजूद सभी प्रॉपर्टी के लिए, प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट मिलती है. इसे 11 मई, 2022 की तारीख के हिसाब से फ़िल्टर किया गया है और पार्टनर होटल आईडी के हिसाब से ग्रुप किया गया है.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId

होटल

होटल व्यू सेवा, किसी खाते के लिए सभी होटलों की सूची या उनकी खास जानकारी देती है.

होटलों की सूची पाना

यहां दिए गए उदाहरण में, खाते 12345678 में मौजूद सभी होटलों की सूची वापस पाने का तरीका बताया गया है:

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

इस अनुरोध में, एक से ज़्यादा पेज वाले नतीजों पर जाने के लिए क्वेरी पैरामीटर स्वीकार किए जाते हैं:

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

प्रॉपर्टी की खास जानकारी पाना

इस उदाहरण में, 12345678 खाते की प्रॉपर्टी की खास जानकारी मिलती है:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize

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

Participation Report View Service की मदद से, किसी खाते के लिए भागीदारी की रिपोर्ट को क्वेरी किया जा सकता है. इसका मतलब है कि रिपोर्ट को पाया जा सकता है, फ़िल्टर किया जा सकता है, और सेगमेंट में बांटा जा सकता है.

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

यहां दिए गए उदाहरण में, खाते 12345678 की सभी प्रॉपर्टी के लिए, भागीदारी की रिपोर्ट मिलती है. साथ ही, 4/10/2020 की तारीख का इस्तेमाल करके रिपोर्ट को फ़िल्टर किया जाता है.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

कीमत की सटीक जानकारी

किराये के सटीक होने की जानकारी दिखाने वाली सेवा की मदद से, किसी खाते के लिए किराये के सटीक होने की जानकारी वाली रिपोर्ट और स्कोरकार्ड वापस पाए जा सकते हैं.

किराये के सटीक होने की जानकारी वाली रिपोर्ट पाना

यहां दिए गए उदाहरण में, 26/8/2019 को खाते 12345678 के लिए, किराये के सटीक होने की जानकारी वाली रिपोर्ट को वापस पाया गया है:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

जवाब में पेजिंग के लिए, सामान्य क्वेरी पैरामीटर के अलावा, मैच किए गए किराये या पिक्सल सिग्नल को नतीजों में शामिल करने के लिए कुछ और पैरामीटर भी उपलब्ध हैं.

इस उदाहरण में, 26/8/2019 की कीमत के सटीक होने की जानकारी वाली रिपोर्ट में, मैच किए गए किराये और पिक्सल सिग्नल शामिल हैं:

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

किराये के सटीक होने की जानकारी वाली उपलब्ध रिपोर्ट की सूची बनाना

उपलब्ध रिपोर्ट की सूची पाने के लिए, यह अनुरोध भेजें:

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

नतीजों को पेज के हिसाब से देखने के लिए, सामान्य क्वेरी पैरामीटर शामिल किए जा सकते हैं.

किराये के सटीक होने के आधार पर स्कोर पाना

किराये के सटीक होने के आधार पर स्कोरकार्ड पाने के लिए, summarize तरीके का इस्तेमाल करें:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

किराये का कवरेज

कीमत की जानकारी दिखाने की सुविधा, कीमत की जानकारी दिखाने की सुविधा से जुड़ी नई रिपोर्ट या पूरी जानकारी दिखाने की सुविधा से जुड़ा पूरा इतिहास दिखाती है.

किराये की कवरेज से जुड़े नए आंकड़े पाना

यहां दिए गए उदाहरण में, खाते 12345678 के लिए, कीमत कवरेज के हाल ही के आंकड़े दिखाए गए हैं:

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

किराये में अंतर होने पर मिलने वाले रिफ़ंड के इतिहास की जानकारी पाना

इस अनुरोध से, किसी खाते के लिए कीमत की पूरी कवरेज हिस्ट्री मिलती है:

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

कीमत

कीमत देखने की सेवा की मदद से, किसी प्रॉपर्टी के लिए कीमत की रिपोर्ट वापस पाई जा सकती है.

किसी प्रॉपर्टी के लिए किराये का डेटा पाना

खाता 12345678 से जुड़े किसी होटल (आईडी=101) के किराये की रिपोर्ट पाने के लिए, यह अनुरोध करें:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

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

मिलान रिपोर्ट सेवा की मदद से, रिपोर्ट की सूची देखी जा सकती है. साथ ही, किसी रिपोर्ट को डाउनलोड किया जा सकता है, उसकी पुष्टि की जा सकती है, और फिर उसे Google पर अपलोड किया जा सकता है.

मिलान रिपोर्ट की सूची पाना

यहां दिए गए उदाहरण में, 12345678 खाते के लिए रिपोर्ट की सूची पाने का तरीका बताया गया है:

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

नतीजों को सीमित करने के लिए, शुरू और खत्म होने की तारीख के क्वेरी पैरामीटर शामिल किए जा सकते हैं. हालांकि, ऐसा करना ज़रूरी नहीं है. उदाहरण के लिए, इस क्वेरी में रिपोर्ट को सिर्फ़ 15/6/2019 से 15/9/2019 के बीच की रिपोर्ट तक सीमित रखा गया है:

GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15

मिलान रिपोर्ट डाउनलोड करना

इस उदाहरण में, booking_report.csv रिपोर्ट (JSON रिस्पॉन्स के तौर पर) को वापस पाने का तरीका बताया गया है. इस रिपोर्ट को 2019-08-26T12:00:00 पर अपलोड किया गया था:

GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv

समाधान रिपोर्ट की पुष्टि करना

इस तरीके का इस्तेमाल करके, रिपोर्ट को अपलोड करने से पहले उसकी पुष्टि की जा सकती है. रिपोर्ट की पुष्टि करने से वह अपलोड नहीं होती.

रिकॉन्सिलिएशन रिपोर्ट को अनुरोध के मुख्य भाग में, contents फ़ील्ड की वैल्यू के तौर पर शामिल किया जाता है. मिलान की रिपोर्ट, मिलान की रिपोर्ट सेक्शन में बताए गए नियमों के मुताबिक होनी चाहिए.

यहां दिए गए उदाहरण में, खाता 12345678 के लिए रिपोर्ट की पुष्टि की गई है:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate

मिलान रिपोर्ट अपलोड करना

मिलान रिपोर्ट के मान्य होने की पुष्टि करने के बाद, उसे Google पर अपलोड किया जा सकता है. जैसे, इस उदाहरण में दिखाया गया है:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports