अनुरोध और रिस्पॉन्स के फ़ील्ड की पूरी सूची देखने के लिए, एपीआई रिसॉर्स कैटलॉग पर जाएं.
प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट
प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट देखने की सेवा का इस्तेमाल करके, किसी खाते के लिए प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट देखी जा सकती है. साथ ही, क्वेरी (पाएं, फ़िल्टर, और सेगमेंट) की जा सकती है.
प्रॉपर्टी की परफ़ॉर्मेंस रिपोर्ट की क्वेरी करना
इस उदाहरण में, 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 खाते की सभी प्रॉपर्टी के लिए हिस्सा लेने की रिपोर्ट मिलती है. साथ ही, 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
यहां दिए गए उदाहरण में, 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": "Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status\n\n111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
समाधान रिपोर्ट की पुष्टि करना
रिपोर्ट अपलोड करने से पहले, उसकी पुष्टि करने के लिए यह तरीका इस्तेमाल किया जा सकता है. रिपोर्ट की पुष्टि करने से वह अपलोड नहीं होती है.
समाधान रिपोर्ट को contents फ़ील्ड की वैल्यू के तौर पर, अनुरोध के मुख्य हिस्से में शामिल किया जाता है. समाधान रिपोर्ट को समाधान रिपोर्ट में बताए गए सिंटैक्स के मुताबिक होना चाहिए.
यह उदाहरण, 12345678 खाते की रिपोर्ट की पुष्टि करता है:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
सफल जवाब का नमूना
{
"successfulRecordCount": 3
}
समाधान रिपोर्ट अपलोड करना
समाधान रिपोर्ट के मान्य होने की पुष्टि करने के बाद, आप उसे इस उदाहरण की तरह Google पर अपलोड कर सकते हैं:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
सभी अधिकार सुरक्षित. Java, Oracle और/या इसके सहयोगियों का एक पंजीकृत ट्रेडमार्क है.
आखिरी बार 2022-08-23 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2022-08-23 (UTC) को अपडेट किया गया."],[[["The Travel Partner API uses REST-ful syntax for HTTPS calls to various endpoints, allowing access to data like property performance, hotel details, and price accuracy."],["You can query reports, like the Property Performance Report or the Participation Report, to gain insights into your hotel data using specific filters and aggregations."],["The API provides methods for retrieving hotel lists, summaries, price coverage information, and pricing data for individual properties within your account."],["Reconciliation Reports, specifically for Hotel Ads, can be listed, downloaded, validated, and uploaded through dedicated API endpoints."],["The base URL for all API requests is `https://travelpartner.googleapis.com/v3/accounts/account_id`, and detailed documentation for resources is available in the API resources catalog."]]],[]]