এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Docs API ব্যবহার করে একটি মেল মার্জ করতে হয়।
ভূমিকা
একটি মেল মার্জ একটি স্প্রেডশিটের সারি বা অন্য কোনও ডেটা উৎস থেকে মান গ্রহণ করে এবং সেগুলিকে একটি টেমপ্লেট ডকুমেন্টে সন্নিবেশ করায়। এটি আপনাকে একটি একক প্রাথমিক ডকুমেন্ট (টেমপ্লেট) তৈরি করতে দেয় যেখান থেকে আপনি অনেকগুলি অনুরূপ ডকুমেন্ট তৈরি করতে পারেন, প্রতিটি ডেটা মার্জ করার সাথে সাথে কাস্টমাইজ করা হয়। ফলাফলটি অগত্যা মেল বা ফর্ম চিঠির জন্য ব্যবহৃত হয় না, তবে যেকোনো উদ্দেশ্যে হতে পারে, যেমন গ্রাহক ইনভয়েসের একটি ব্যাচ তৈরি করা।
স্প্রেডশিট এবং ওয়ার্ড প্রসেসরের আগমনের অনেক দিন ধরেই মেইল মার্জ চালু আছে এবং বর্তমানে এটি অনেক ব্যবসায়িক কর্মপ্রবাহের অংশ। নিয়ম হলো প্রতি সারিতে একটি রেকর্ড হিসেবে ডেটা সংগঠিত করা, কলামগুলি ডেটার ক্ষেত্রগুলিকে প্রতিনিধিত্ব করে, যেমনটি নিম্নলিখিত টেবিলে দেখানো হয়েছে:
| নাম | জানুন | জোন | |
|---|---|---|---|
| ১ | UrbanPq সম্পর্কে | ১২৩ প্রথম স্ট্রিট। | পশ্চিম |
| ২ | পাওক্সানা | ৪৫৬ দ্বিতীয় স্ট্রিট। | দক্ষিণ |
এই পৃষ্ঠার নমুনা অ্যাপটি দেখায় যে কীভাবে আপনি Google Docs, Sheets এবং Drive API ব্যবহার করে মেল মার্জ কীভাবে সম্পাদিত হয় তার বিশদ বিবরণ সারাংশ করতে পারেন, যা ব্যবহারকারীদের বাস্তবায়নের উদ্বেগ থেকে রক্ষা করে। এই Python নমুনা সম্পর্কে আরও তথ্য নমুনার GitHub রেপোতে পাওয়া যাবে।
নমুনা আবেদন
এই নমুনা অ্যাপটি আপনার প্রাথমিক টেমপ্লেটটি কপি করে এবং তারপর আপনার নির্ধারিত ডেটা উৎস থেকে ভেরিয়েবলগুলিকে প্রতিটি কপিতে মার্জ করে। এই নমুনা অ্যাপটি ব্যবহার করে দেখতে, প্রথমে আপনার টেমপ্লেটটি সেট আপ করুন:
- একটি ডক্স ফাইল তৈরি করুন । আপনি যে টেমপ্লেটটি ব্যবহার করতে চান তা নির্বাচন করুন।
- নতুন ফাইলের ডকুমেন্ট আইডিটি লক্ষ্য করুন। আরও তথ্যের জন্য, ডকুমেন্ট আইডি দেখুন।
-
DOCS_FILE_IDভেরিয়েবলটিকে ডকুমেন্ট আইডিতে সেট করুন। - যোগাযোগের তথ্য টেমপ্লেট প্লেসহোল্ডার ভেরিয়েবল দিয়ে প্রতিস্থাপন করুন যা অ্যাপটি নির্বাচিত ডেটার সাথে মার্জ করবে।
এখানে একটি নমুনা লেটার টেমপ্লেট দেওয়া হল যেখানে প্লেসহোল্ডার ব্যবহার করা যাবে এবং প্লেইন টেক্সট বা শিটের মতো উৎস থেকে আসল ডেটার সাথে মার্জ করা যাবে। টেমপ্লেটটি দেখতে কেমন হবে তা এখানে দেওয়া হল:

এরপর, SOURCE ভেরিয়েবল ব্যবহার করে আপনার ডেটা সোর্স হিসেবে প্লেইন টেক্সট অথবা Sheets বেছে নিন। নমুনাটি ডিফল্টভাবে প্লেইন টেক্সট হিসেবে কাজ করে, অর্থাৎ নমুনা ডেটা TEXT_SOURCE_DATA ভেরিয়েবল ব্যবহার করে। Sheets থেকে ডেটা সোর্স করতে, SOURCE ভেরিয়েবলটিকে 'sheets' এ আপডেট করুন এবং SHEETS_FILE_ID ভেরিয়েবল সেট করে আমাদের স্যাম্পল শিটে (অথবা আপনার নিজস্ব) নির্দেশ করুন।
শীটটি দেখতে কেমন তা এখানে দেওয়া হল যাতে আপনি ফর্ম্যাটটি দেখতে পারেন:

আমাদের নমুনা ডেটা দিয়ে অ্যাপটি চেষ্টা করুন, তারপর এটি আপনার ডেটা এবং ব্যবহারের ক্ষেত্রে অভিযোজিত করুন। কমান্ড-লাইন অ্যাপ্লিকেশনটি এভাবে কাজ করে:
- সেটআপ
- ডেটা উৎস থেকে ডেটা আনুন
- প্রতিটি সারির ডেটা লুপ করুন
- টেমপ্লেটের একটি কপি তৈরি করুন
- কপিটি ডেটার সাথে মার্জ করুন
- নতুন মার্জ করা ডকুমেন্টের আউটপুট লিঙ্ক
নতুন মার্জ করা সমস্ত অক্ষর ব্যবহারকারীর মাই ড্রাইভেও দেখা যাবে। মার্জ করা অক্ষরের একটি উদাহরণ দেখতে এরকম:

সোর্স কোড
পাইথন
আরও তথ্যের জন্য, নমুনা অ্যাপের GitHub রেপোতে README ফাইল এবং সম্পূর্ণ অ্যাপ্লিকেশন সোর্স কোড দেখুন।