ফিডগুলি অ্যাকশন সেন্টারে আপনার ইনভেন্টরি ডেটা সরবরাহ করে। এই দৈনিক সিকিউর ফাইল ট্রান্সফার প্রোটোকল (SFTP) আপলোড সমস্ত বণিক, পরিষেবা এবং প্রাপ্যতা স্লট ডেটা আপডেট করে৷ ফিডগুলি নির্দিষ্ট করে যে আপনি কোন বণিকদের সমর্থন করেন, তাদের উপলব্ধতা এবং Google আপনার ইনভেন্টরি সঠিকভাবে প্রদর্শন করে কিনা তা নিশ্চিত করার জন্য প্রয়োজনীয় কোনো বিশেষ বৈশিষ্ট্য। ফিডগুলি SFTP ড্রপবক্সগুলিতে আপলোড করা হয় যা আপনি সেটআপে আপনার SSH কী প্রদান করার সময় কনফিগার করা হয়।
বুকিং সার্ভারে যাওয়ার আগে আপনাকে অবশ্যই নিম্নলিখিত ফিড প্রস্তুত কাজগুলি সম্পূর্ণ করতে হবে:
আপনি আপনার ফিডগুলি সফলভাবে আপলোড করার পরে কাজগুলি সম্পন্ন হিসাবে চিহ্নিত করা হবে এবং সবুজ হয়ে যাবে৷ প্রতিটি নির্দিষ্ট মাইলফলক কাজ সম্পূর্ণ করতে লিঙ্কড ডকুমেন্টেশন পর্যালোচনা করুন।
আপনার ডাইনিং রিজার্ভেশন এন্ড-টু-এন্ড ইন্টিগ্রেশনের সঠিক কার্যকারিতার জন্য, আপনাকে দৈনিক বণিক ফিড, পরিষেবা ফিড, এবং উপলব্ধতা ফিড আপলোডগুলি স্বয়ংক্রিয়ভাবে প্রদান করতে হবে। আপনার স্বয়ংক্রিয় ফিড অবকাঠামো অবশ্যই আপনার সম্পূর্ণ ইনভেন্টরি প্রদান করবে।
ফিডের ধরন
ডাইনিং রিজার্ভেশন এন্ড-টু-এন্ড ইন্টিগ্রেশনের জন্য নিম্নলিখিত ফিড এবং তাদের আপলোড ফ্রিকোয়েন্সি প্রয়োজন:
খাওয়ান | বর্ণনা | ফ্রিকোয়েন্সি | নমুনা |
---|---|---|---|
বণিক | আপনার বণিকদের বর্ণনা করে। | প্রতি 24 ঘন্টায় একবার | বণিক ফিড নমুনা |
সেবা | আপনার বণিকদের পরিষেবা বর্ণনা করুন। | প্রতি 24 ঘন্টায় একবার | সেবা ফিড নমুনা |
প্রাপ্যতা | আপনার বণিকদের পরিষেবার জন্য উপলব্ধ স্লটগুলি বর্ণনা করে৷ একটি সর্বনিম্ন 30 দিনের কভারেজ প্রদান করা আবশ্যক. কভারেজ 90 দিনের জন্য বাড়ানোর জন্য, অ্যাকশন সেন্টার যোগাযোগ ফর্মের মাধ্যমে Google সহায়তার সাথে যোগাযোগ করুন। | প্রতি 24 ঘন্টায় একবার | প্রাপ্যতা ফিড নমুনা |
ফিড ফর্ম্যাটগুলি প্রোটোকল বাফার 3 সিনট্যাক্সের সাথে বর্ণনা করা হয়েছে, তবে আপনি সংশ্লিষ্ট JSON ফর্ম্যাট অনুযায়ী আপনার ফিডগুলি আপলোড করতে পারেন৷ JSON ফর্ম্যাটের জন্য ফিডের নমুনাগুলি পড়ুন। আমরা আপনাকে JSON ফর্ম্যাটে ফিড আপলোড করার পরামর্শ দিই।
নামকরণ প্রথা এবং মেটাডেটা
ফাইলের নাম
আপনি যদি শার্ডিং ব্যবহার করেন, আপনি যে ফিডগুলি আপলোড করেন সেগুলির অনন্য নাম থাকতে হবে যা ফিডের ধরন এবং গণনা নির্দিষ্ট করে৷ ফিড তৈরির জন্য একটি টাইমস্ট্যাম্প আপনার ফিড ফাইলের নামকরণের অনন্য প্রয়োজনীয়তা পূরণ করে।
গঠন : {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
উদাহরণ : availability_feed_1574117613_001_of_002.json.gz
আইডি সংজ্ঞায়িত করুন
যখন আপনি আপনার বণিকদের জন্য আইডি বা অন্যান্য বৈশিষ্ট্যগুলির জন্য আইডি সংজ্ঞায়িত করেন যেগুলির জন্য একটি আইডি প্রয়োজন, আমরা দৃঢ়ভাবে UID বা UUID ব্যবহার করার পরামর্শ দিই। যতক্ষণ না আপনার প্ল্যাটফর্ম জুড়ে আইডিগুলি আলাদা থাকে ততক্ষণ আপনি আপনার নিজস্ব আলফানিউমেরিক সমাধান সরবরাহ করতে পারেন।
মেটাডেটা
যখন আপনি ফিড তৈরি করেন, generation_timestamp
অবশ্যই সেই সময়টিকে প্রতিফলিত করবে যখন ডেটাবেস থেকে ডেটা টানা হয়েছিল। ফিড জুড়ে এই মানের পুনঃব্যবহারের ফলে প্রক্রিয়াকরণের ত্রুটি হতে পারে।
ননস মান, এলোমেলো বা পুনরাবৃত্তি না হওয়া সংখ্যাগুলি ফিডের ধরন জুড়ে অনন্য হতে হবে এবং পুনরায় ব্যবহার করা যাবে না। নির্দিষ্ট শার্ড ফিডের সমস্ত ফাইলের জন্য মান অবশ্যই মিলবে৷
ফিড ফাইলের আকার
ভাগ করা ফিড ফাইল
আপনার ইনভেন্টরির উপর ভিত্তি করে, ফিডগুলিকে একাধিক ফাইলে ভাগ করা বা ভাঙার প্রয়োজন হতে পারে। আপনার ফিডগুলিকে নিম্নলিখিত শর্তে শার্ডিংয়ের প্রয়োজন হতে পারে:
- সংকুচিত gzip ফিড একটি ফাইলের জন্য 200 MB ছাড়িয়ে যায়।
- উদাহরণ : জেনারেট করা উপলব্ধতা ফিড হল 1 জিবি। এটি অবশ্যই পাঁচটি বা তার বেশি পৃথক শার্ডে ভাগ করা উচিত।
- অংশীদার ইনভেন্টরি সিস্টেম বা অঞ্চল জুড়ে বিতরণ করা হয় যার ফলে ইনভেন্টরি সমন্বয় করতে অসুবিধা হয়।
- উদাহরণ : অংশীদারের ইউএস এবং ইইউ ইনভেন্টরি রয়েছে যা আলাদা সিস্টেমে থাকে। ফিড দুটি শার্ড দিয়ে তৈরি হতে পারে। একই নন্স এবং
generation_timestamp
সহ একটি মার্কিন যুক্তরাষ্ট্রের জন্য এবং একটি ইউরোপীয় ইউনিয়নের জন্য৷
- উদাহরণ : অংশীদারের ইউএস এবং ইইউ ইনভেন্টরি রয়েছে যা আলাদা সিস্টেমে থাকে। ফিড দুটি শার্ড দিয়ে তৈরি হতে পারে। একই নন্স এবং
আরও তথ্যের জন্য, শার্ড ফিড ফাইল টিউটোরিয়াল এবং সেরা অনুশীলন দেখুন।
একটি ফিড শার্ড নামে একাধিক ফাইল গঠন করতে পারে। ফিডের আকার নির্ধারণ করতে, নিম্নলিখিত নির্দেশিকাগুলি ব্যবহার করুন:
- প্রস্তাবিত ফিড ভাগ করা:
- মার্চেন্ট ফিড : এক শার্ড।
- সার্ভিস ফিড : এক শার্ড।
- প্রাপ্যতা ফিড : কম 20 shards. আপনার যদি একটি ব্যবসায়িক ন্যায্যতা থাকে যার জন্য নির্দিষ্ট পরিমাণের বেশি প্রয়োজন হয়, তাহলে আরও নির্দেশের জন্য সহায়তার সাথে যোগাযোগ করুন ।
- ফিড ফাইলের আকার এবং ভাগ করা:
- সংকোচনের পরে শার্ড ফাইলের আকার 200 MB এর কম রাখুন। প্রয়োজনে একাধিক শার্ড ব্যবহার করুন।
- এক শার্ডে পাঠানো পৃথক রেকর্ড ভবিষ্যতে ফিডে একই শার্ডে পাঠানোর প্রয়োজন নেই।
- আরও ভালো পারফরম্যান্সের জন্য, সমস্ত শার্ড ফাইলকে আকারে সমান করতে শার্ডগুলির মধ্যে সমানভাবে ডেটা ভাগ করুন।
- প্রয়োজনে, প্রতিটি পৃথক ফিড শার্ডের জন্য প্লেইন টেক্সট JSON ফিডগুলি সংকুচিত করতে gzip ব্যবহার করুন।
ফিড ফাইল কম্প্রেস
যেকোনো JSON বা PB3 ফাইল আপলোড করার আগে gzip দিয়ে কম্প্রেস করা যেতে পারে। এটি দৈনিক ফিডের বাইটের আকার উল্লেখযোগ্যভাবে কমাতে পারে।
প্রতিটি শার্ড ফাইল অবশ্যই gzip'd এবং আপলোড করা উচিত যেমন gzip*.json। সংকুচিত ফিড শার্ডগুলি অবশ্যই .json.gz বা .pb3.gz-এ শেষ হতে হবে।
আপনার SFTP ড্রপবক্সে ফিডগুলি আপলোড করুন৷
আপনি বণিক , পরিষেবা , এবং উপলব্ধতা ফিডগুলি তৈরি করার পরে, আপনি SFTP ড্রপবক্সের মাধ্যমে আপনার ফিডগুলি স্যান্ডবক্স বা উত্পাদন পরিবেশে আপলোড করতে পারেন৷ আপনি যখন সেটআপে আপনার SSH কী প্রদান করেন তখন SFTP ড্রপবক্স কনফিগার করা হয়। Google SFTP সার্ভার 19321 পোর্টে sftp://partnerupload.google.com
এ উপলব্ধ।
SFTP ড্রপবক্সে আপলোড করার সাথে সাথে Google ফিড ফাইলগুলি পর্যালোচনা করে এবং যাচাই করে৷ যদি ফিডটি একাধিক ফাইল জুড়ে শার্ড করা হয়, আপনি শেষ ফাইল আপলোড করার পরে সেগুলি প্রক্রিয়া করা হয়। আপনার ফিডে ত্রুটি থাকলে, ফিড ত্রুটি কোড সহ আপনাকে একটি ইমেল পাঠানো হবে৷ ত্রুটিগুলি সংজ্ঞায়িত বণিক, পরিষেবা বা প্রাপ্যতা গ্রহণ করা থেকে বাধা দেয়৷ ফিডগুলি যাচাই করার পরে, ফ্রন্টএন্ডে ফিডগুলি উপস্থিত হওয়া পর্যন্ত এটি 24 ঘন্টা পর্যন্ত সময় নিতে পারে৷