এই ডকুমেন্টে Gmail API ব্যবহার করে কীভাবে খসড়া ইমেল তৈরি, আপডেট এবং পাঠানো যায় তা ব্যাখ্যা করা হয়েছে।
ইমেল ড্রাফ্টগুলি এমন অপ্রেরিত বার্তাগুলিকে প্রতিনিধিত্ব করে যেখানে DRAFT সিস্টেম লেবেল প্রয়োগ করা হয়। ড্রাফ্টের মধ্যে থাকা বার্তাটি একবার তৈরি করার পরে সম্পাদনা করা যাবে না, তবে এটি প্রতিস্থাপন করা যেতে পারে। এই অর্থে, drafts রিসোর্স হল একটি ধারক যা একটি স্থিতিশীল আইডি প্রদান করে কারণ অন্তর্নিহিত বার্তা আইডিগুলি প্রতিবার বার্তা প্রতিস্থাপনের সময় পরিবর্তিত হয়।
একটি খসড়ার ভিতরে থাকা messages রিসোর্স অন্যান্য বার্তাগুলির মতোই আচরণ করে, নিম্নলিখিত পার্থক্যগুলি ছাড়া:
- খসড়া বার্তাগুলিতে
DRAFTসিস্টেম লেবেল ছাড়া অন্য কোনও লেবেল থাকতে পারে না। - যখন খসড়াটি পাঠানো হয়, তখন খসড়াটি স্বয়ংক্রিয়ভাবে মুছে ফেলা হয় এবং
SENTসিস্টেম লেবেল ব্যবহার করে একটি আপডেটেড আইডি সহ একটি নতুন বার্তা তৈরি করা হয়। এই বার্তাটিdrafts.sendপদ্ধতির প্রতিক্রিয়ায় ফেরত পাঠানো হয়।
খসড়া তৈরি করুন
আপনার অ্যাপটি drafts.create পদ্ধতি ব্যবহার করে খসড়া তৈরি করতে পারে। খসড়া তৈরি করতে:
- RFC 2822 মেনে চলে এমন একটি MIME বার্তা তৈরি করুন।
- বার্তাটিকে একটি base64URL এনকোডেড স্ট্রিংয়ে রূপান্তর করুন।
-
drafts.createপদ্ধতিটি কল করুন,messages.rawক্ষেত্রের মান এনকোডেড স্ট্রিংয়ে সেট করুন।
নিম্নলিখিত কোড নমুনাগুলি প্রক্রিয়াটি প্রদর্শন করে:
জাভা
পাইথন
সিআরএল
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- ACCESS_TOKEN : অ্যাক্সেস টোকেন যা API-তে অ্যাক্সেস দেয়।
- MESSAGE : RFC 2822 ফর্ম্যাট করা MIME বার্তা, base64URL হিসাবে এনকোড করা।
খসড়া আপডেট করুন
একটি খসড়া তৈরির মতোই, একটি খসড়া আপডেট করার জন্য আপনাকে আপনার অনুরোধের মূল অংশে একটি drafts সংস্থান সরবরাহ করতে হবে এবং messages.raw ক্ষেত্রটি MIME বার্তা ধারণকারী একটি base64URL এনকোডেড স্ট্রিংয়ে সেট করতে হবে। যেহেতু বার্তাগুলি আপডেট করা যায় না, খসড়ায় থাকা বার্তাটি ধ্বংস হয়ে যায় এবং আপডেট অনুরোধে সরবরাহ করা নতুন MIME বার্তা দ্বারা প্রতিস্থাপিত হয়।
আপনি drafts.get পদ্ধতিতে কল করে format=raw কোয়েরি প্যারামিটার ব্যবহার করে খসড়াটিতে থাকা বর্তমান MIME বার্তাটি পুনরুদ্ধার করতে পারেন।
আরও তথ্যের জন্য, drafts.update পদ্ধতিটি দেখুন।
খসড়া পাঠান
খসড়া পাঠানোর সময়, আপনি এটি যেমন আছে তেমন পাঠাতে পারেন, অথবা আপনি পাঠানোর অনুরোধে আপডেট প্রদান করতে পারেন।
পাঠানোর সময় খসড়া আপডেট করার জন্য, drafts.send পদ্ধতির অনুরোধ বডিতে একটি drafts রিসোর্স সরবরাহ করুন। drafts রিসোর্সে, আপনাকে পাঠানোর জন্য খসড়ার ড্রাফ্ট id নির্দিষ্ট করতে হবে এবং messages.raw ফিল্ডটিকে base64URL স্ট্রিং হিসাবে এনকোড করা নতুন MIME বার্তায় সেট করতে হবে।
জিমেইল বার্তা পাঠানোর তথ্যের জন্য, বার্তা পাঠান দেখুন।