ইন্টিগ্রেশন ওভারভিউ

স্থানীয় পরিষেবা বিজ্ঞাপন (LSA) Google.com-এ তাদের তালিকা (বা প্রদানকারীদের) প্রকাশ করতে সমষ্টিকারীদের সাথে অংশীদারিত্ব করতে। এই নির্দেশিকায়, আমরা বর্ণনা করি যে কীভাবে অ্যাগ্রিগেটররা তাদের প্রদানকারীদের সম্পর্কে LSA স্ট্রাকচার্ড ডেটা প্রদান করতে পারে। বিশেষ করে, আমরা এপিআই এন্ডপয়েন্ট এগ্রিগেটরদের সেট ডকুমেন্ট করি LSA এর সাথে একীভূত করার জন্য বাস্তবায়ন করতে হবে।

শব্দকোষ

এগ্রিগেটর (বা অংশীদার) : এগুলি এমন অংশীদার যারা একত্রিত প্রদানকারী যাদেরকে তারা পরিষেবা প্রদান করে এবং যাদের ডেটা LSA কে প্রদান করা হতে পারে।

3P প্রদানকারী (বা তালিকা) : এগুলি হল স্বতন্ত্র ছোট ব্যবসা (যেমন, জো'স প্লাম্বিং) যাদের এগ্রিগেটরদের সাথে ব্যবসায়িক সম্পর্ক থাকতে পারে। এগ্রিগেটররা স্থানীয় পরিষেবাগুলিকে এই ব্যবসাগুলি সম্পর্কে তথ্য প্রদান করে।

ওভারভিউ

অ্যাগ্রিগেটররা ফিড ব্যবহার করে স্থানীয় পরিষেবাগুলিকে তাদের প্রদানকারীদের (ব্যবসা) সম্পর্কে ডেটা সরবরাহ করবে। প্রতিটি ফিডে একাধিক প্রদানকারীর তথ্য থাকে। একটি ফিডের মধ্যে, একটি একক প্রদানকারীর তথ্য একটি ফিড আইটেম দ্বারা এনক্যাপসুলেট করা হয়। প্রতিটি ফিড একটি ফিড টাইমস্ট্যাম্পও নির্দিষ্ট করে যা ফিডের সতেজতা নির্দেশ করে। প্রতিটি ফিড একটি ফিডের ধরনও নির্দিষ্ট করে: এটি প্রদানকারীর প্রোফাইল বা প্রদানকারীর পর্যালোচনা সম্পর্কে নীচে বর্ণিত ডেটা হতে পারে।

ফিডের ধরন

প্রাথমিক একীকরণের জন্য, প্রতিটি ফিড নিম্নলিখিত ধরণের ফিডগুলির মধ্যে একটি হতে পারে:

• প্রোফাইল ফিড: এই ফিড প্রদানকারীর প্রোফাইল সম্পর্কে তথ্য প্রদান করে। প্রতিটি ফিড আইটেম একটি নির্দিষ্ট প্রদানকারী সম্পর্কে প্রোফাইল তথ্য encapsulates. এর মধ্যে রয়েছে একটি অনন্য ব্যবসা আইডি, ব্যবসার নাম, পরিবেশন করার অবস্থান, অফার করা পরিষেবা, কাজের সময় ইত্যাদি।

• পর্যালোচনা ফিড: এই ফিড প্রদানকারী পর্যালোচনা সম্পর্কে তথ্য প্রদান করে। প্রতিটি ফিড আইটেম একটি নির্দিষ্ট প্রদানকারীর বিশদ ভোক্তা পর্যালোচনার একটি তালিকা অন্তর্ভুক্ত করে। প্রতিটি ভোক্তার পর্যালোচনাতে ভোক্তার নাম, রেটিং (1 - 5), পর্যালোচনা পাঠ্য, পর্যালোচনা টাইমস্ট্যাম্প ইত্যাদি থাকে।

প্রোফাইল ফিড এবং পর্যালোচনা ফিডে নির্দিষ্ট ক্ষেত্র এবং তাদের শব্দার্থবিদ্যা সম্পর্কে আরও বিশদ বিবরণ।

ফিড ইনজেশন

ফিড ডেটা JSON হিসাবে ক্রমিক করা হয়। ডেটা জমা দিতে, LSA শুধুমাত্র একটি টান মেকানিজম সমর্থন করবে। একটি পুশ মেকানিজমকে সমর্থন করার জন্য ভবিষ্যত পরিকল্পনা রয়েছে।

টান মেকানিজম

পুল মেকানিজমের মধ্যে, অ্যাগ্রিগেটররা পূর্বনির্ধারিত REST এন্ডপয়েন্টের (URL) একটি সেট সমর্থন করে যা JSON অবজেক্ট পাঠায় এবং গ্রহণ করে। এটি একটি ওয়েব সার্ভারে এক বা একাধিক ফাইল হোস্ট করার অনুরূপ। এলএসএ ডেটা আনার জন্য এই ইউআরএলগুলিতে পর্যায়ক্রমে HTTP GET অনুরোধ জারি করবে। পূর্বনির্ধারিত ইউআরএল সম্পর্কে বিশদ বিবরণ API এন্ডপয়েন্টের পরবর্তী বিভাগে পাওয়া যাবে।

পুশ মেকানিজম

পুশ পদ্ধতিতে, এলএসএ এগ্রিগেটরদের কল করার এবং ডেটা সরবরাহ করার জন্য একটি শেষ পয়েন্ট প্রদান করবে। শব্দার্থগতভাবে, এটি একটি টানের মতোই, কিন্তু যে ক্ষেত্রে সমষ্টিকারীরা স্থানীয় পরিষেবাগুলিতে নির্দিষ্ট ডেটা পুশ করতে চান সেক্ষেত্রে নমনীয়তা প্রদান করে। প্রোটোকলে বর্ণিত সমস্ত শব্দার্থবিদ্যা, নিয়ম বা সীমাবদ্ধতা একই পদ্ধতিতে পুশ এবং টান উভয় ক্ষেত্রেই প্রযোজ্য।

এপিআই শেষ পয়েন্ট

নিম্নলিখিত এন্ডপয়েন্টগুলি অ্যাগ্রিগেটরদের দ্বারা সমর্থিত হওয়া উচিত: একটি প্রোফাইল ফিডের জন্য এবং একটি পর্যালোচনা ফিডের জন্য৷

প্রস্তাবিত এন্ডপয়েন্ট পাথ

আমরা সুপারিশ করি যে শেষ পয়েন্টগুলিতে নীচের মত সংস্করণ তথ্য রয়েছে। আমরা v1 দিয়ে শুরু করি।

শেষবিন্দু	পথ
প্রোফাইল ফিড	/feeds/{version}/profile
ফিড পর্যালোচনা করুন	/feeds/{version}/review

শেষবিন্দু পরম

পরম	বর্ণনা
maxresults	এটি একটি পৃষ্ঠায় কতগুলি ফিড আইটেম অনুরোধ করা যেতে পারে তার সীমা।
nextpagetoken	ফলাফলের পরবর্তী পৃষ্ঠা পেতে পেজিনেশন টোকেন

এন্ডপয়েন্ট প্রমাণীকরণ

প্রমাণীকরণ HTTP মৌলিক অ্যাক্সেস প্রমাণীকরণ ব্যবহার করে: প্রমাণীকরণের জন্য base64-এনকোডেড ব্যবহারকারীর নাম এবং পাসওয়ার্ড। নীচে একটি উদাহরণ.

• username "অনুমোদন" (দৃষ্টান্তমূলক উদ্দেশ্যে)
• password J9adfdsafc3RfMjpVU1yif5XMw” (দৃষ্টান্তমূলক উদ্দেশ্যে)

পুশের জন্য SFTP ড্রপবক্স

ড্রপবক্স পাথ: partnerupload.google.com:19321

সতর্কতা: এই SFTP ড্রপ বক্সে লোড করা ফাইলগুলি 24 ঘন্টা পরে স্বয়ংক্রিয়ভাবে মুছে ফেলা হয়।

এন্ডপয়েন্ট প্রমাণীকরণ

• পাবলিক/প্রাইভেট কী জোড়া (প্রস্তাবিত)

  • কী জোড়া তৈরি করতে এখানে টিউটোরিয়াল ব্যবহার করুন।
  • LSA সর্বজনীন কী পাঠান এবং প্রমাণীকরণের জন্য ব্যক্তিগত কী রাখুন
  • LSA একটি ইউজারনেম তৈরি করতে এবং এগ্রিগেটরে ফেরত পাঠাতে পাবলিক কী ব্যবহার করবে

• পাসওয়ার্ড প্রমাণীকরণ

  • LSA ব্যবহারকারীর নাম এবং পাসওয়ার্ড তৈরি করবে এবং এগ্রিগেটরকে ফেরত পাঠাবে

SFTP কমান্ড দ্রুত রেফারেন্স

1. লগ ইন করুন৷ লগ ইন করতে এই কমান্ডটি ব্যবহার করুন৷ (ত্যাগ করুন -i যদি আপনি একটি ব্যক্তিগত কী ব্যবহার না করেন)।

   sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com

2. ফাইল কপি করুন। রিমোট সিস্টেমে ফাইলটি কপি করুন। ফাইলটি খুঁজতে আপনি আপনার স্থানীয় সিস্টেমে lls/lcd থেকে ls/cd ব্যবহার করতে পারেন। তারপর ফাইলটি এর মাধ্যমে অনুলিপি করুন:

   put <path_to_local_file>

3. যাচাই করুন। SFTP ডিরেক্টরিতে ফোল্ডার এবং ফাইলগুলির একটি তালিকা দেখতে ls ব্যবহার করুন এবং যাচাই করুন যে আপনার ফাইলটি দূরবর্তী সিস্টেমে অনুলিপি করা হয়েছে

ফিড বিভাগ

যেমন আগে উল্লেখ করা হয়েছে, প্রতিটি ফিড একটি ফাইলের সাথে সাদৃশ্যপূর্ণ এবং বিভিন্ন ফিড আইটেম নিয়ে গঠিত। প্রতিটি ফিড আইটেম একটি নির্দিষ্ট প্রদানকারীর (অনন্য ব্যবসা আইডি) সম্পর্কে ডেটা এনক্যাপসুলেট করে। প্রতিটি ফিডে একটি টাইমস্ট্যাম্পও থাকে যা এই ফিডের সতেজতা নির্দেশ করে। ফিড বিভাগ নির্দিষ্ট করে কিভাবে LSA একটি প্রদত্ত ফিডকে ব্যাখ্যা করে। নিচে বর্ণিত ফিডের দুটি বিভাগ রয়েছে।

স্ন্যাপশট ফিডে একটি নির্দিষ্ট টাইমস্ট্যাম্পে প্রদানকারীদের (একটি সমষ্টিকারীর অধীনে) একটি সম্পূর্ণ তালিকা রয়েছে। এই স্ন্যাপশট ফিড প্রক্রিয়া করার পরে, নিম্নলিখিত শব্দার্থ প্রযোজ্য:

• ফিডে উপস্থিত যেকোনো প্রদানকারীর জন্য, সিস্টেম LSA ডাটাবেসে এই প্রদানকারীর জন্য ডেটা আপডেট করবে (উদাহরণস্বরূপ, প্রথমবার সম্মুখীন হলে একটি নতুন প্রদানকারী তৈরি করুন, অথবা প্রদানকারীর ডেটা যদি আগের ফিডে প্রক্রিয়া করা হয়)।

• বর্তমানে এলএসএ ডাটাবেসে উপস্থিত অ্যাগ্রিগেটরের অধীনে যে কোনো প্রদানকারীর জন্য, কিন্তু ফিডে অনুপস্থিত, প্রদানকারীকে মুছে ফেলা হবে।

আপডেট (বা বর্ধিত) ফিডে একটি নির্দিষ্ট টাইমস্ট্যাম্পে প্রদানকারীদের (একটি সমষ্টির অধীনে) একটি আংশিক তালিকা রয়েছে। একটি বর্ধিত ফিড প্রক্রিয়া করার পরে, নিম্নলিখিত শব্দার্থ প্রযোজ্য হবে:

• ফিডে উপস্থিত যেকোনো প্রদানকারীর জন্য, সিস্টেমটি এই প্রদানকারীর জন্য ডেটা LSA ডাটাবেসে আপডেট করবে যদি প্রদানকারীটি আগের স্ন্যাপশট ফিডে তৈরি করা হয়। (উদাহরণস্বরূপ যদি কোন প্রদানকারী প্রথমবার সম্মুখীন হয়, তাহলে এটি একটি নো-অপ হবে)

• LSA ডাটাবেসে বর্তমানে উপস্থিত যেকোন প্রদানকারীর জন্য, কিন্তু ফিডে অনুপস্থিত, এটি একটি নো-অপ (অর্থাৎ, এই প্রদানকারীতে কোন পরিবর্তন হবে না)।

প্রোফাইল বনাম রিভিউ ফিডের জন্য শব্দার্থবিদ্যা সামান্য সংক্ষিপ্ত। প্রক্রিয়াকরণের বিবরণের জন্য পৃথক ফিড শব্দার্থবিদ্যা দেখুন।

প্রোফাইল ফিড: * পুল-ভিত্তিক স্ন্যাপশট ফিড * পুশ-ভিত্তিক স্ন্যাপশট ফিড * পুশ-ভিত্তিক আপডেট ফিড পর্যালোচনা ফিড: * পুল-ভিত্তিক স্ন্যাপশট ফিড * পুশ-ভিত্তিক স্ন্যাপশট ফিড

এর জন্য আলাদা প্রোফাইল ফিড প্রয়োজন:

1. Google গ্যারান্টি বা Google স্ক্রিন করা ব্যাজের জন্য যোগ্য বলে মনে করা হয় এমন প্রদানকারীরা।

2. প্রদানকারীরা যারা ব্যাজের জন্য যোগ্য নয়।

উদাহরণ

স্ন্যাপশট ফিড

মনে রাখবেন যে একটি স্ন্যাপশট ফিডে প্রদানকারীদের একটি সম্পূর্ণ তালিকা থাকবে। উদাহরণস্বরূপ, যদি একজন অ্যাগ্রিগেটর চান যে 100টি প্রদানকারীকে LSA-তে অন্তর্ভুক্ত করা হোক, স্ন্যাপশট ফিডে 100টি প্রদানকারীর জন্য সর্বশেষ অবস্থা থাকা উচিত।

কিভাবে এই কাজ করে

প্রোফাইল ফিডের স্ন্যাপশট বিভাগ কীভাবে কাজ করে তা দেখানোর একটি সহজ উদাহরণ নিচে দেওয়া হল।

• স্ন্যাপশট 1-এ প্রো 1, প্রো 2 রয়েছে
• স্ন্যাপশট 2-এ প্রো 1, প্রো 3 রয়েছে

স্ন্যাপশট 1 প্রক্রিয়াকরণের পরে, LSA ডাটাবেসে প্রো 1 এবং প্রো 2 থাকবে। স্ন্যাপশট 2 প্রক্রিয়াকরণের সময়, LSA প্রো 1 আপডেট করবে, প্রো 3 তৈরি করবে এবং প্রো 2 মুছে ফেলবে। অর্থাৎ, স্ন্যাপশট 2 প্রক্রিয়াকরণের পরে, LSA ডাটাবেসে প্রো 1 এবং প্রো 3 থাকবে।

আপডেট (বর্ধিত) ফিড

মনে রাখবেন যে একটি আপডেট ফিডে অ্যাগ্রিগেটরের অধীনে সরবরাহকারীদের একটি আংশিক তালিকা রয়েছে। উদাহরণস্বরূপ, যদি একজন অ্যাগ্রিগেটর শুধুমাত্র 5টি আপডেট করতে চায় যার আগে 100টি প্রদানকারী প্রদান করা হয়েছে, আপডেট ফিডে শুধুমাত্র এই 5টি প্রদানকারীর জন্য সর্বশেষ অবস্থা থাকতে হবে।

কিভাবে এই কাজ করে

"প্রোফাইল ফিড" এর আপডেট বিভাগ কীভাবে কাজ করে তা দেখানোর একটি সহজ উদাহরণ নীচে দেওয়া হল।

• আপডেট 1: প্রো 1, প্রো 2
• আপডেট 2: প্রো 1, প্রো 3

আপডেট 1 প্রক্রিয়াকরণের পরে, LSA ডাটাবেসে প্রো 1 এবং প্রো 2 থাকবে। আপডেট 2 প্রক্রিয়াকরণের সময়, LSA প্রো 1 আপডেট করবে এবং প্রো 3 তৈরি করবে। মনে রাখবেন যে প্রো 2 অস্পর্শিত। অর্থাৎ, আপডেট 2 এর প্রক্রিয়াকরণের পরে, LSA ডাটাবেসে Pro1, Pro2 এবং Pro 3 থাকবে।

স্ন্যাপশট এবং টান এর প্রভাব

স্ন্যাপশট ফিড + পুল মেকানিজম নিম্নলিখিত সীমাবদ্ধতাগুলিকে বোঝায়:

• প্রদানকারীদের যোগ করতে বা মুছতে, প্রোফাইলের তথ্য আপডেট করতে, বিজ্ঞাপন পজ করতে বা বাজেট পরিবর্তন করতে অংশীদারদের কয়েক ঘণ্টার বিলম্ব হতে পারে। বিলম্ব সরাসরি টান অনুরোধের ফ্রিকোয়েন্সি সম্পর্কিত।
• জরুরী ডেটা আপডেটের জন্য, আমাদের ম্যানুয়ালি একটি ওয়ান-অফ/অ্যাডহক টান সমর্থন করতে হতে পারে।

ইনক্রিমেন্টাল এবং পুশ সমর্থনের প্রভাব

আপডেট ফিড খোলা + পুশ প্রক্রিয়া নিম্নলিখিত উন্নতিগুলি বোঝায়:

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

প্রস্তাবিত একীকরণ পদ্ধতি

অংশীদারদের পর্যায়ক্রমিক স্ন্যাপশট ফিড থাকা প্রয়োজন, তা পুশ বা টানের মাধ্যমেই হোক। এটি LSA-কে মিস আপডেটের ক্ষেত্রে রোলব্যাক এবং সিস্টেম-পুনরুদ্ধারের মতো জরুরী পরিস্থিতিগুলি পরিচালনা করার অনুমতি দেয়।

• পুশ মেকানিজমের সাহায্যে, অংশীদারদের প্রতি 2 ঘন্টায় স্ন্যাপশট প্রোফাইল ফিডগুলি পুশ করা উচিত এবং বেসলাইন ডেটা সতেজতা নিশ্চিত করতে প্রতি 6 ঘন্টায় ফিডগুলি পর্যালোচনা করা উচিত৷
• পুল মেকানিজমের সাহায্যে, LSA প্রতি 2 ঘণ্টায় স্ন্যাপশট প্রোফাইল ফিডগুলি টেনে আনবে এবং বেসলাইন ডেটা সতেজতা নিশ্চিত করতে প্রতি 6 ঘণ্টায় ফিড পর্যালোচনা করবে।
• স্ন্যাপশট ফিড সরবরাহ করার জন্য অংশীদারদের শুধুমাত্র একটি প্রক্রিয়া (হয় পুশ বা টান) প্রয়োজন, কিন্তু উভয় নয়।

ঐচ্ছিকভাবে, অংশীদার যারা ডেটা সতেজতা উন্নত করতে চান তারা পুশের মাধ্যমে আপডেট ফিড পাঠাতে পারেন। LSA আপডেট ফিড টানবে না।

• আপডেট ফিডগুলি পরবর্তী স্ন্যাপশটের জন্য অপেক্ষা না করে শেষ স্ন্যাপশট থেকে পরিবর্তিত আইটেমগুলি প্রচার করতে ব্যবহৃত হয়।
• LSA সরবরাহকারীদের দুটি ধাক্কার মধ্যে 5 মিনিটের বেশি ব্যবধান রাখার পরামর্শ দেয়।
• এটি একটি আপডেট ফিডে যুক্তিসঙ্গতভাবে ফিড আইটেম বান্ডিল করার সুপারিশ করা হয়। 5টি প্রদানকারীকে আপডেট করার জন্য, LSA প্রদানকারীদের প্রতি 1টি ফিডআইটেম সহ 5টি আপডেট ফিড পুশ করার পরিবর্তে 5টি ফিডআইটেম সহ 1টি আপডেট ফিড পুশ করতে পছন্দ করে৷
• LSA শুধুমাত্র প্রোফাইল ফিডের জন্য ইনক্রিমেন্টাল ফিড সমর্থন করে, রিভিউ ফিডের জন্য নয়।

ডেটা সামঞ্জস্যের নিশ্চয়তা দিতে LSA মেটাডেটাতে feedTimestampMicros ফিল্ডকে সম্মান করবে। পুরানো টাইমস্ট্যাম্প সহ একটি ফিড আইটেম বাদ দেওয়া হবে যদি একই প্রো আপডেট করে এমন একটি নতুন আইটেম ইনজেস্ট করা হয় তবে অচলতা এড়াতে। স্ন্যাপশট এবং আপডেট ফিড উভয় ক্ষেত্রে feedTimestampMicros ব্যবহার করে সঠিকভাবে ডেটা সতেজতা প্রতিফলিত করা অংশীদারের দায়িত্ব।

অংশীদারদের প্রতি সরবরাহকারীর লিড এবং চার্জ সম্পর্কে তথ্য পেতে রিপোর্টিং API ব্যবহার করা উচিত।