ব্যাচ ইনজেশন

আপনার ডেটা ফিডগুলি আপনাকে আপনার রেস্তোরাঁ, পরিষেবা এবং মেনু অর্ডারিং এন্ড-টু-এন্ডে উপলব্ধ করতে দেয়।

এই দস্তাবেজটি কভার করে যে কীভাবে আপনার স্যান্ডবক্স এবং প্রোডাকশন ইনভেন্টরি হোস্ট করবেন এবং এন্ড-টু-এন্ড অর্ডারে আপনার ইনভেন্টরি আপডেট করতে ব্যাচ ইনজেশন ব্যবহার করবেন।

ডেটা ফিড পরিবেশ

আপনার ইন্টিগ্রেশন ডেভেলপমেন্টের জন্য তিনটি ডেটা ফিড পরিবেশ উপলব্ধ রয়েছে:

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

হোস্টিং ডেটা ফিড

ব্যাচ ইনজেশনের মাধ্যমে আপনার স্যান্ডবক্স এবং প্রোডাকশন ডেটা ফিডগুলি প্রক্রিয়া করার জন্য এন্ড-টু-এন্ড অর্ডার করার জন্য, আপনাকে অবশ্যই আপনার ডেটা ফিড ফাইলগুলিকে একটি সাইটম্যাপ সহ Google ক্লাউড স্টোরেজ, Amazon S3 বা HTTPS-এ হোস্ট করতে হবে।

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

উদাহরণস্বরূপ, আপনি যদি হোস্টিং বিকল্প হিসাবে Google ক্লাউড স্টোরেজ ব্যবহার করেন, তাহলে আপনার কাছে নিম্নলিখিত পথ থাকবে:

  • স্যান্ডবক্স ফিড: gs://foorestaurant-google-feed-sandbox/
  • উৎপাদন ফিড: gs://foorestaurant-google-feed-prod/

আপনার ইনভেন্টরি হোস্ট করতে, নিম্নলিখিতগুলি করুন:

  1. আপনার ডেটা ফিড ফাইল তৈরি করুন.
  2. একটি হোস্টিং সমাধান চয়ন করুন.
  3. আপনার ডেটা ফিড হোস্ট করুন।
  4. আপনার ডেটা ফিড ফাইলগুলি নিয়মিত আপডেট করা হয় তা নিশ্চিত করুন। প্রোডাকশন ডেটা ফিড প্রতিদিন আপডেট করতে হবে।

কীভাবে একটি ইনভেন্টরি ফিড তৈরি করতে হয় তার বিশদ বিবরণের জন্য, Restaurant , Service এবং Menu সংস্থাগুলির জন্য ডকুমেন্টেশন দেখুন, সেইসাথে একটি ডেটা ফিড তৈরি করুন বিভাগটি দেখুন৷

ডেটা ফিড ফাইলের নির্দেশিকা

প্রতিটি ফাইল, যাতে একাধিক সত্তা থাকতে পারে, 200 MB এর বেশি হওয়া উচিত নয়৷ শীর্ষ-স্তরের সত্ত্বা Restaurant , Service এবং Menu , তাদের শিশু সত্তা সহ, একসাথে 4 MB এর বেশি হওয়া উচিত নয়৷

একটি হোস্টিং সমাধান চয়ন করুন

নিম্নলিখিত সারণীতে আপনার ডেটা ফিড হোস্ট করার বিকল্পগুলি এবং সেই হোস্টগুলি কীভাবে এন্ড-টু-এন্ড অর্ডার দিয়ে কাজ করে তা তালিকাভুক্ত করে:

আমাজন S3 গুগল ক্লাউড স্টোরেজ একটি সাইটম্যাপ সহ HTTPS
শংসাপত্র এবং অ্যাক্সেস

নিম্নলিখিত তথ্য দিয়ে Google প্রদান করুন:

  • অ্যাক্সেস কী আইডি
  • গোপন অ্যাক্সেস কী
  • আপনার উৎপাদন এবং স্যান্ডবক্স S3 ডিরেক্টরি এবং marker.txt ফাইলের পথ। পথটি অবশ্যই s3:// দিয়ে শুরু হবে।

S3 বালতিতে নিম্নলিখিত তথ্য থাকতে হবে:

  • আপনার জায় জন্য ফিড ফাইল.
  • marker.txt , যা আনার জন্য ব্যবহৃত একটি টাইমস্ট্যাম্প ধারণ করে।

উদাহরণ marker.txt ফাইল: 2018-12-03T08:30:42.694Z

আপনার প্রোডাকশন এবং স্যান্ডবক্স বাকেট ডিরেক্টরি এবং marker.txt ফাইলের পাথ Google-কে প্রদান করুন। পাথগুলি অবশ্যই gs:// দিয়ে শুরু হবে।

আপনার Google ক্লাউড স্টোরেজ বাকেটের পাঠক হিসাবে আপনার Google পরামর্শদাতার দেওয়া পরিষেবা অ্যাকাউন্ট যোগ করুন।

Google ক্লাউড স্টোরেজ (GCS) এর অ্যাক্সেস কীভাবে নিয়ন্ত্রণ করবেন সে সম্পর্কে আরও তথ্যের জন্য, Google ক্লাউড প্ল্যাটফর্ম কনসোল দেখুন: বালতি অনুমতি সেট করা।

GCS বালতিতে নিম্নলিখিত তথ্য থাকতে হবে:

  • আপনার জায় জন্য ফিড ফাইল.
  • marker.txt , যা আনার জন্য ব্যবহৃত একটি টাইমস্ট্যাম্প ধারণ করে।

উদাহরণ marker.txt ফাইল: 2018-12-03T08:30:42.694Z

নিম্নলিখিত তথ্য দিয়ে Google প্রদান করুন:

  • আপনার মৌলিক প্রমাণীকরণের শংসাপত্র।
  • আপনার প্রোডাকশনের পথ এবং স্যান্ডবক্স সাইটম্যাপ পাথ। পথটি অবশ্যই https:// দিয়ে শুরু হবে।
  • প্রোটোকল: আপনাকে অবশ্যই আপনার ফিড ফাইলগুলি HTTPS এর মাধ্যমে উপলব্ধ করতে হবে, HTTP নয়।
  • নিরাপত্তা: Google দৃঢ়ভাবে সুপারিশ করে যে আপনি আপনার হোস্ট করা ফিড ফাইলগুলিকে মৌলিক প্রমাণীকরণের মাধ্যমে সুরক্ষিত রাখুন।
গুগল কিভাবে জানে কোন ফাইল আনতে হবে বালতিতে থাকা সমস্ত ফাইলের ডিরেক্টরি তালিকা। বালতিতে থাকা সমস্ত ফাইলের ডিরেক্টরি তালিকা। সাইটম্যাপে তালিকাভুক্ত ফাইলের স্বতন্ত্র ইউআরএল।
Google কিভাবে জানে যে ফাইলগুলি আনার জন্য প্রস্তুত৷ আপনি আপনার ডেটা ফিড তৈরি করা শেষ করার পরে, সর্বশেষ টাইমস্ট্যাম্প সহ marker.txt ফাইলটি আপডেট করুন৷ আপনি আপনার ডেটা ফিড তৈরি করা শেষ করার পরে, সর্বশেষ টাইমস্ট্যাম্প সহ marker.txt ফাইলটি আপডেট করুন৷ আপনি আপনার ডেটা ফিড তৈরি করা শেষ করার পরে, সর্বশেষ টাইমস্ট্যাম্প সহ আপনার sitemap.xml এর last-modified প্রতিক্রিয়া শিরোনামটি আপডেট করুন।
ফাইলের সীমা

ফাইলের সর্বাধিক সংখ্যা: 100,000।

আপনার Amazon S3 বালতিতে মোট 100,000টিরও কম ফাইল থাকতে হবে।

ফাইলের সর্বাধিক সংখ্যা: 100,000।

আপনার Google ক্লাউড স্টোরেজ বালতিতে মোট 100,000টিরও কম ফাইল থাকতে হবে৷

ফাইলের সর্বাধিক সংখ্যা: 100,000।

আপনার সাইটম্যাপের XML ফাইলের মধ্যে ফাইল পাথের সংখ্যা অবশ্যই 100,000 এর কম হতে হবে।

ব্যাচ ইনজেশনের জন্য আপনার ডেটা ফিড সংযুক্ত করুন

আপনি আপনার ফিডগুলি হোস্ট করার পরে, আপনাকে সেগুলিকে অ্যাকশন সেন্টারে আপনার প্রকল্পের সাথে সংযুক্ত করতে হবে৷ প্রোডাকশন ফিডের প্রাথমিক কনফিগারেশন অনবোর্ডিং টাস্ক পৃষ্ঠায় করা হয়। পরবর্তীতে উত্পাদন এবং স্যান্ডবক্স ফিড কনফিগারেশন কনফিগারেশন > ফিড পৃষ্ঠা থেকে যে কোনো সময়ে প্রশাসনিক ভূমিকা সহ যেকোনো পোর্টাল ব্যবহারকারীদের দ্বারা আপডেট করা যেতে পারে। স্যান্ডবক্স পরিবেশ উন্নয়ন এবং পরীক্ষার উদ্দেশ্যে ব্যবহার করা হয়, যখন উৎপাদন ফিড ব্যবহারকারীদের কাছে প্রদর্শিত হয়।

আপনি যদি Amazon S3 দিয়ে আপনার ডেটা ফিড হোস্ট করেন

  1. অ্যাকশন সেন্টারে , কনফিগারেশন > ফিড- এ যান।

  2. সম্পাদনা ক্লিক করুন এবং আপডেট ফিড ফর্মটি পূরণ করুন:

    • ফিড ডেলিভারি পদ্ধতি: Amazon S3 এ সেট করুন।
    • মার্কার ফাইল: marker.txt ফাইলের URL প্রদান করুন।
    • ডেটা ফাইল: S3 বালতিতে URL প্রদান করুন যাতে ডেটা ফিড থাকে।
    • অ্যাক্সেস আইডি: S3 রিসোর্স থেকে পড়ার অনুমতি সহ IAM অ্যাক্সেস কী আইডি লিখুন।
    • অ্যাক্সেস কী: S3 রিসোর্স থেকে পড়ার অনুমতি সহ IAM গোপন অ্যাক্সেস কী লিখুন।
  3. জমা দিন ক্লিক করুন.
  4. এক থেকে দুই ঘন্টা পরে, ব্যাচ ইনজেশন আপনার ফিড ফাইলগুলিকে নিয়ে আসে কিনা তা পরীক্ষা করুন।

আপনি যদি Google ক্লাউড স্টোরেজের সাথে আপনার ডেটা ফিড হোস্ট করেন

  1. অ্যাকশন সেন্টারে , কনফিগারেশন > ফিড- এ যান।

  2. সম্পাদনা ক্লিক করুন এবং আপডেট ফিড ফর্মটি পূরণ করুন:

    • ফিড বিতরণ পদ্ধতি: Google ক্লাউড স্টোরেজ সেট করুন।
    • মার্কার ফাইল: marker.txt ফাইলের URL প্রদান করুন।
    • ডেটা ফাইল: GCS বালতিতে URL প্রদান করুন যাতে ডেটা ফিড থাকে।
  3. জমা দিন ক্লিক করুন.
  4. আপনার GCS বাকেট অ্যাক্সেস করার জন্য একটি পরিষেবা অ্যাকাউন্ট তৈরি করা হয়েছে। অনবোর্ডিং কাজগুলি সম্পূর্ণ হওয়ার পরে অ্যাকাউন্টের নামটি কনফিগারেশন > ফিডে পাওয়া যাবে। এই পরিষেবা অ্যাকাউন্টের "স্টোরেজ লিগ্যাসি অবজেক্ট রিডার" ভূমিকা প্রয়োজন৷ এই ভূমিকাটি Google ক্লাউড কনসোলের IAM পৃষ্ঠায় পরিষেবা অ্যাকাউন্টে দেওয়া যেতে পারে।
  5. এক থেকে দুই ঘন্টা পরে, ব্যাচ ইনজেশন আপনার ফিড ফাইলগুলিকে নিয়ে আসে কিনা তা পরীক্ষা করুন।

আপনি যদি HTTPS দিয়ে আপনার ডেটা ফিড হোস্ট করেন

  1. অ্যাকশন সেন্টারে , কনফিগারেশন > ফিড- এ যান।

  2. সম্পাদনা ক্লিক করুন এবং আপডেট ফিড ফর্মটি পূরণ করুন:

    • ফিড বিতরণ পদ্ধতি: HTTPS এ সেট করুন।
    • সাইটম্যাপ ফাইল: sitemap.xml ফাইলের URL প্রদান করুন।
    • ব্যবহারকারীর নাম: HTTPS সার্ভার অ্যাক্সেস করতে ব্যবহারকারীর নাম শংসাপত্র লিখুন।
    • পাসওয়ার্ড: HTTPS সার্ভার অ্যাক্সেস করতে পাসওয়ার্ড লিখুন।
  3. জমা দিন ক্লিক করুন.
  4. এক থেকে দুই ঘন্টা পরে, ব্যাচ ইনজেশন আপনার ফিড ফাইলগুলিকে নিয়ে আসে কিনা তা পরীক্ষা করুন।

উদাহরণ পাথ

নিম্নলিখিত টেবিলে প্রতিটি হোস্টিং বিকল্পের জন্য উদাহরণ পাথ রয়েছে:

আমাজন S3 গুগল ক্লাউড স্টোরেজ একটি সাইটম্যাপ সহ HTTPS
পথ s3://foorestaurant-google-feed-sandbox/ gs://foorestaurant-google-feed-sandbox/ https://sandbox-foorestaurant.com/sitemap.xml
মার্কার ফাইল s3://foorestaurant-google-feed-sandbox/marker.txt gs://foorestaurant-google-feed-sandbox/marker.txt প্রযোজ্য নয়

HTTPS হোস্টিংয়ের জন্য সাইটম্যাপ

আপনি সাইটম্যাপ সংজ্ঞায়িত করার সময় নিম্নলিখিত নির্দেশিকা ব্যবহার করুন:

  • আপনার সাইটম্যাপের লিঙ্কগুলি অবশ্যই ফাইলগুলির দিকে নির্দেশ করবে৷
  • যদি আপনার সাইটম্যাপে আপনার নিজের ডোমেন নামের পরিবর্তে একটি ক্লাউড প্রদানকারীর উল্লেখ থাকে, তাহলে নিশ্চিত করুন যে https://www.yourcloudprovider.com/your_id এর মতো ইউআরএলের শুরু আপনার ব্যাচের কাজের জন্য স্থিতিশীল এবং অনন্য।
  • আংশিক সাইটম্যাপ আপলোড না করার বিষয়ে সতর্ক থাকুন (যেমন আংশিক ডেটা আপলোডের ক্ষেত্রে)। এটি করার ফলে Google শুধুমাত্র সাইটম্যাপের ফাইলগুলিকে ইনজেস্ট করে, যার ফলে আপনার ইনভেন্টরি লেভেল কমে যাবে এবং এর ফলে আপনার ফিড ইনজেশন ব্লক হয়ে যেতে পারে।
  • সাইটম্যাপে উল্লেখ করা ফাইলগুলির পাথগুলি যাতে পরিবর্তন না হয় তা নিশ্চিত করুন৷ যেমন, আজ আপনার সাইটম্যাপের রেফারেন্স https://www.yourcloudprovider.com/your_id/10000.json নেই তবে আগামীকাল https://www.yourcloudprovider.com/your_id/20000.json রেফারেন্স করুন।
উদাহরণ সাইটম্যাপ

এখানে একটি উদাহরণ sitemap.xml ফাইল যা ডেটা ফিড ফাইলগুলি পরিবেশন করে:

উদাহরণ 1: ব্যবসায়ীদের দ্বারা গোষ্ঠীবদ্ধ সত্তা (প্রস্তাবিত)।

এক্সএমএল

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

উদাহরণ 2: ধরনের দ্বারা গোষ্ঠীবদ্ধ সত্তা।

এক্সএমএল

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

আপনার ডেটা ফিড আপডেট করুন

আপনার ডেটা ফিডগুলি সংযুক্ত হওয়ার পরে, Google প্রতি ঘন্টায় একবার আপডেটগুলির জন্য পরীক্ষা করে, কিন্তু আমরা শুধুমাত্র তখনই সমস্ত ডেটা ফিড গ্রহণ করি যখন marker.txt বা sitemap.xml ফাইলগুলি সংশোধন করা হয়৷ আমরা আশা করি যে আপনি দিনে একবার আপনার ডেটা ফিডগুলি আপডেট করবেন যাতে বাসি ইনভেন্টরি রোধ করা যায়।

ডেটা ফিডগুলি সংশোধন করা হয়েছে এবং ব্যাচ ইনজেশনের জন্য প্রস্তুত তা নির্দিষ্ট করতে, marker.txt ফাইলের last-modified অবজেক্ট মেটাডেটা ক্ষেত্র (GCP এবং S3-এর জন্য) বা sitemap.xml ফাইলের last-modified প্রতিক্রিয়া শিরোনাম আপডেট করুন। ডেটা ফিড কতটা তাজা তা নির্ধারণ করতে Google এই মানগুলি ব্যবহার করে।

যেহেতু ব্যাচ ফিড খাওয়া হচ্ছে,

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

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

পূর্ববর্তী
আপনার ডেটা ফিড পরীক্ষা করুন