Usage

এই পৃষ্ঠাটি ট্রাভেল পার্টনার API v3 ব্যবহার করে কিছু নমুনা কল উপস্থাপন করে।

ট্রাভেল পার্টনার এপিআই এন্ডপয়েন্টগুলি HTTPS কলের মাধ্যমে REST-ful সিনট্যাক্স ব্যবহার করে। সমস্ত API অনুরোধের জন্য base_url হল:

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

অনুরোধ এবং প্রতিক্রিয়া ক্ষেত্রগুলির সম্পূর্ণ তালিকার জন্য, API সংস্থান ক্যাটালগ দেখুন

সম্পত্তি কর্মক্ষমতা রিপোর্ট

প্রপার্টি পারফরমেন্স রিপোর্ট ভিউ সার্ভিস একটি নির্দিষ্ট অ্যাকাউন্টের জন্য প্রোপার্টি পারফরম্যান্স রিপোর্ট কোয়েরি (পান, ফিল্টার এবং সেগমেন্ট) করার ক্ষমতা প্রদান করে।

একটি সম্পত্তি কর্মক্ষমতা রিপোর্ট জিজ্ঞাসা

নিম্নলিখিত উদাহরণে 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

মূল্য নির্ভুলতা

মূল্য নির্ভুলতা দর্শন পরিষেবা একটি নির্দিষ্ট অ্যাকাউন্টের জন্য মূল্য নির্ভুলতা প্রতিবেদন এবং স্কোরকার্ড পুনরুদ্ধারের অনুমতি দেয়।

একটি মূল্য নির্ভুলতা রিপোর্ট পাওয়া

নিম্নলিখিত উদাহরণটি 12345678 অ্যাকাউন্টের জন্য 8/26/2019 তারিখে মূল্য নির্ভুলতা রিপোর্ট পুনরুদ্ধার করে:

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

প্রতিক্রিয়ার মাধ্যমে পেজিং করার জন্য সাধারণ ক্যোয়ারী প্যারামিটার ছাড়াও, ফলাফলে মিলিত মূল্য বা পিক্সেল সংকেত অন্তর্ভুক্ত করার জন্য আরও কয়েকটি রয়েছে।

এই উদাহরণে, 8/26/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 এর অন্তর্গত একটি নির্দিষ্ট হোটেলের (ID= 101 ) মূল্যের প্রতিবেদন পেতে, এই অনুরোধটি জারি করুন:

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

পুনর্মিলন রিপোর্ট

রিকনসিলিয়েশন রিপোর্ট সার্ভিস

পুনর্মিলন প্রতিবেদনের একটি তালিকা পাওয়া

নিম্নলিখিত উদাহরণটি অ্যাকাউন্ট 12345678 এর জন্য প্রতিবেদনের একটি তালিকা পায়:

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

ফলাফল সীমিত করতে আপনি ঐচ্ছিক শুরু এবং শেষ তারিখের ক্যোয়ারী প্যারামিটার অন্তর্ভুক্ত করতে পারেন। উদাহরণস্বরূপ, এই ক্যোয়ারীটি শুধুমাত্র 6/15/2019 থেকে 9/15/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