Usage

यह पेज, ट्रैवल पार्टनर एपीआई v3 का इस्तेमाल करके कुछ सैंपल कॉल दिखाता है.

ट्रैवल पार्टनर एपीआई एंडपॉइंट, एचटीटीपीएस कॉल के ज़रिए 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

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

हिस्सा लेने की रिपोर्ट देखने की सुविधा का इस्तेमाल करके, आप किसी खास खाते के लिए पार्टनरशिप की रिपोर्ट (पाएं, फ़िल्टर, और सेगमेंट) कर सकते हैं.

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

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

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

मिलान वाली रिपोर्ट

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

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

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

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

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

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

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

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

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