Release Notes

ট্র্যাভেল পার্টনার API-এর সংস্করণ 3 আপনাকে এতে প্রোগ্রাম্যাটিক অ্যাক্সেস দেয়:

  • হোটেল সেন্টার এবং Google বিজ্ঞাপনের মধ্যে অ্যাকাউন্ট লিঙ্ক পরিচালনা
  • নির্বাচিত হোটেল সেটিংস ব্যবস্থাপনা
  • ব্র্যান্ড এবং আইকনগুলির ব্যবস্থাপনা (বন্ধ বিটা)
  • প্রপার্টি পারফরম্যান্স রিপোর্ট ভিউ সার্ভিসের মাধ্যমে প্রপার্টি পারফরম্যান্স ডেটা
  • হোটেল ভিউ পরিষেবার মাধ্যমে হোটেল ডেটা
  • অংশগ্রহণ প্রতিবেদনের তথ্য সেবার মাধ্যমে
  • মূল্য নির্ভুলতা ভিউ পরিষেবার মাধ্যমে মূল্য নির্ভুলতা ডেটা
  • মূল্য কভারেজ ভিউ পরিষেবার মাধ্যমে মূল্য কভারেজ ডেটা
  • মূল্য দর্শন পরিষেবার মাধ্যমে ভ্রমণসূচী এবং মূল্যের ডেটা
  • রিকনসিলিয়েশন রিপোর্ট সার্ভিসের মাধ্যমে কমিশন রিকনসিলিয়েশন রিপোর্টের ব্যবস্থাপনা (শুধুমাত্র কমিশন পে-পার-স্টে পার্টনার)

শেষবিন্দু

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

https://travelpartner.googleapis.com

পরিষেবার শেষ পয়েন্ট
অ্যাকাউন্ট লিঙ্ক

একটি Google বিজ্ঞাপন অ্যাকাউন্ট এবং একটি হোটেল সেন্টার অ্যাকাউন্টের মধ্যে লিঙ্ক পরিচালনা করে।

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

পুনর্মিলন প্রতিবেদন

কমিশন পুনর্মিলন প্রতিবেদন তৈরি করে, যাচাই করে এবং পুনরুদ্ধার করে (শুধুমাত্র হোটেল বিজ্ঞাপন)।

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

আপনি হোটেল বিজ্ঞাপন কেন্দ্রে অ্যাকাউন্ট ট্যাবের অ্যাকাউন্ট তথ্য ভিউ-এর অধীনে আপনার অ্যাকাউন্ট আইডি দেখতে পারেন।

চেঞ্জলগ

Travel Partner API v2.1-এর অনেক পরিষেবা Google Ads API- এ স্থানান্তরিত হয়েছে। ফলস্বরূপ, ট্র্যাভেল পার্টনার API v3 শুধুমাত্র হোটেল নির্দিষ্ট পরিষেবা বজায় রাখে।

হোটেল ভিউ সার্ভিস

  • HotelViewService.ListHotelViews (পূর্বে হোটেল API)
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/hotels এ পরিবর্তিত হয়েছে।
    • type রিকোয়েস্ট প্যারামিটার সরানো হয়েছে।
    • ক্ষেত্রটি manifestOnly হয়েছে শুধুমাত্র প্রতিক্রিয়াতে।
    • কিছু ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।
  • HotelViewService.SummarizeHotelViews (পূর্বে স্কোরকার্ড API-এ hotel_list_stats )
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats এ পরিবর্তিত হয়েছে।
    • কিছু ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।

ParticipationReportViewService (পূর্বে স্কোরকার্ড API-এ সুযোগ_পরিসংখ্যান)

  • ParticipationReportService.QueryParticipationReport
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats এ পরিবর্তিত হয়েছে।
    • ক্যোয়ারী প্যারামিটার যোগ করা হয়েছে.
    • ক্ষেত্রগুলির নাম পরিবর্তন এবং পুনর্গঠন করা হয়েছে।

PriceAccuracyViewService (পূর্বে price_accuracy report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy এ পরিবর্তিত হয়েছে।
    • নতুন API পূর্ববর্তী সংস্করণের বিপরীতে হোটেল ভিউ রিসোর্স নামের একটি তালিকা প্রদান করে, যা প্রতিবেদনের তারিখের একটি তালিকা প্রদান করে।
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 এ পরিবর্তিত হয়েছে।
    • CSV আউটপুট আর সমর্থিত নয়।
    • কিছু ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।

প্রাইসকভারেজভিউ সার্ভিস

  • PriceAccuracyViewService.ListPriceCoverageViews (পূর্বে স্কোরকার্ড API-এ price_coverage_stats_history )
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history এ পরিবর্তিত হয়েছে।
    • কিছু ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (পূর্বে স্কোরকার্ড API-এ price_coverage_stats )
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats এ পরিবর্তিত হয়েছে।
    • কিছু ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।

PriceViewService (পূর্বে Prices API)

  • PriceViewService.GetPriceView
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id এ পরিবর্তিত হয়েছে।
    • কিছু ক্ষেত্রের নাম পরিবর্তন করা হয়েছে।
    • প্রতিক্রিয়া থেকে বিড তথ্য সরানো হয়েছে.

ReconciliationReportService পদ্ধতি (পূর্বে Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports এ পরিবর্তিত হয়েছে।
  • ReconciliationReportService.GetReconciliationReport
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename এ পরিবর্তিত হয়েছে .
  • ReconciliationReportService.CreateReconciliationReport
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports এ পরিবর্তিত হয়েছে।
  • ReconciliationReportService.ValidateReconciliationReport
    • API এন্ডপয়েন্ট https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate থেকে https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate এ পরিবর্তিত হয়েছে।

অবচয়

অবচয়
নির্দেশ করে যে API-এর সংস্করণটি প্রত্যাশিতভাবে কাজ করতে থাকবে, কিন্তু নতুন বৈশিষ্ট্য বা বাগ ফিক্সের সাথে আপডেট নাও হতে পারে। উপরন্তু, যখন একটি সংস্করণ বাতিল করা হয়, একটি সূর্যাস্ত তারিখ নির্ধারণ করা হয়।
সূর্যাস্ত
নির্দেশ করে যে API এর সংস্করণটি সরানো হয়েছে এবং আর উপলব্ধ নেই৷ অবচয় এবং সূর্যাস্তের মধ্যে ন্যূনতম সময় 3 মাস।

নিম্নলিখিত সারণী API সংস্করণগুলির বর্তমান সময়সূচী, সেইসাথে প্রত্যাশিত অবচয় এবং সূর্যাস্তের তারিখগুলি দেখায়:

সংস্করণ অবচয় তারিখ সূর্যাস্তের তারিখ
v3.0 N/A N/A
v2.1 সেপ্টেম্বর 2019 31 মে, 2020
v2.0 (বিড API) ফেব্রুয়ারী 2018 মে 2018
v2.0 (অন্য সব API) সেপ্টেম্বর 2019 15 ফেব্রুয়ারি, 2020
v1.2 ফেব্রুয়ারী 2018 মে 2018
v1.1 জুন 2016 অক্টোবর 2016
v1.0 এপ্রিল 2015 অক্টোবর 2015

প্রমাণীকরণ

ট্রাভেল পার্টনার API অ্যাক্সেস করতে, ক্লায়েন্টদের অবশ্যই OAuth2 প্রমাণীকরণ ব্যবহার করে প্রমাণীকরণ করতে হবে।

একটি উদাহরণ অ্যাপ্লিকেশন এবং ভ্রমণ অংশীদার API-এর সাথে সংযোগ করতে OAuth ব্যবহার করার বিষয়ে অতিরিক্ত তথ্যের জন্য, API প্রমাণীকরণ দেখুন।