Mail Admin Quarantine API এক নজরে

Mail Admin Quarantine API-এর মাধ্যমে Google Workspace অ্যাডমিনিস্ট্রেটররা প্রোগ্রাম্যাটিকভাবে ইমেল মেসেজ ম্যানেজ করতে পারেন যা Gmail অ্যাডমিন কোয়ারেন্টাইনে হোল্ড করে রাখে। Google Admin কনসোলে আপনার কনফিগার করা মেনে চলা, ডেটা লস প্রিভেনশন (DLP) বা সুরক্ষা সংক্রান্ত নিয়মের সাথে মেসেজ মিলে গেলে, সেটি কোয়ারেন্টাইনে পাঠানো হয়।

নিরাপত্তা ও সম্মতি সংক্রান্ত অটোমেশন তৈরি করতে API ব্যবহার করুন, যেমন:

  • ট্রায়াজের জন্য SIEM বা SOAR প্ল্যাটফর্মে কোয়ারেন্টাইন করা মেসেজ ফিরিয়ে আনা।
  • কোনও মেসেজ কীভাবে ম্যানেজ করা হবে সেই বিষয়ে সিদ্ধান্ত নেওয়ার আগে মেসেজের হেডার, বডি স্নিপেট ও অ্যাটাচমেন্ট পর্যালোচনা করা।
  • নিরাপদ মেসেজ রিলিজ করা এবং অনিরাপদ মেসেজ প্রত্যাখ্যান করা, আলাদাভাবে বা সর্বাধিক ৫০০টি মেসেজের ব্যাচে।

মূল রিসোর্স

অ্যাডমিন কোয়ারেন্টাইন API কোনও গ্রাহকের অধীনে নিম্নলিখিত রিসোর্স প্রকাশ করে:

রিসোর্স রিসোর্সের নাম বিবরণ
গ্রাহক customers/CUSTOMER_ID আপনার Google Workspace অ্যাকাউন্ট। আরও তথ্যের জন্য, আপনার কাস্টমার আইডি খুঁজুন লিঙ্কে দেখুন।
customers.quarantinedMessages customers/CUSTOMER_ID/quarantinedMessages/MESSAGE_OWNER:MESSAGE_ID কোয়ারেন্টাইনে রাখা ইমেল মেসেজ। MESSAGE_OWNER হল মেলবক্সের মালিকের ইমেল আইডি এবং MESSAGE_ID হল অপরিবর্তনীয় Gmail মেসেজ আইডি।
customers.quarantines customers/CUSTOMER_ID/quarantines/QUARANTINE_ID অ্যাডমিন কনসোলে আপনার কনফিগার করা কোয়ারেন্টাইন।
customers.operations customers/CUSTOMER_ID/operations/OPERATION_ID একটি দীর্ঘ-চলমান অপারেশন যা একটি ব্যাচ রিলিজ বা ব্যাচ অস্বীকার অনুরোধ ট্র্যাক করে।

QuarantinedMessage-এ নিম্নলিখিতগুলির মধ্যে একটি State অবজেক্ট থাকে:

রাজ্য বিবরণ
PENDING_TRIAGE মেসেজটি কোয়ারেন্টাইনে রাখা হয়েছে এবং অ্যাডমিনিস্ট্রেটরের সিদ্ধান্তের জন্য অপেক্ষা করা হচ্ছে।
RELEASED অ্যাডমিনিস্ট্রেটর মেসেজটি রিলিজ করেছেন এবং Gmail সেটি ডেলিভার করেছে।
DENIED অ্যাডমিনিস্ট্রেটর মেসেজটি বাতিল করেছেন এবং Gmail সেটি বাদ দিয়েছে।

পদ্ধতি

সব অনুরোধের টার্গেট https://mailadminquarantine.googleapis.com/v1।

পদ্ধতি HTTP অনুরোধ বিবরণ
customers.quarantinedMessages.list GET /customers/*/quarantinedMessages গত ৩০ দিনের কোয়ারেন্টাইন করা মেসেজের তালিকা দেখায়।
customers.quarantinedMessages.search POST /customers/*/quarantinedMessages:search ফিল্টার বা Gmail সার্চ কোয়েরি ব্যবহার করে কোয়ারেন্টাইন করা মেসেজ সার্চ করে।
customers.quarantinedMessages.get GET /customers/*/quarantinedMessages/* মেটাডেটা, পার্স করা কন্টেন্ট বা কাঁচা RFC 2822 মেসেজ পায়।
customers.quarantinedMessages.release POST /customers/*/quarantinedMessages/*:release ডেলিভারির জন্য একটি মেসেজ রিলিজ করে।
customers.quarantinedMessages.deny POST /customers/*/quarantinedMessages/*:deny একটি মেসেজ প্রত্যাখ্যান করে।
customers.quarantinedMessages.batchRelease POST /customers/*/quarantinedMessages:batchRelease অ্যাসিঙ্ক্রোনাসভাবে সর্বাধিক ৫০০টি মেসেজ রিলিজ করে।
customers.quarantinedMessages.batchDeny POST /customers/*/quarantinedMessages:batchDeny অ্যাসিঙ্ক্রোনাসভাবে সর্বাধিক ৫০০টি মেসেজ প্রত্যাখ্যান করে।
customers.operations.get GET /customers/*/operations/* ব্যাচ অপারেশনের স্ট্যাটাস ও ফলাফল দেখায়।
customers.quarantines.list GET /customers/*/quarantines গ্রাহকের জন্য কনফিগার করা কোয়ারেন্টাইনের তালিকা দেখায়।
customers.quarantines.get GET /customers/*/quarantines/* কোয়ারেন্টাইনের ডিসপ্লে নাম ও বিবরণ পায়।

উচ্চ-স্তরের প্রয়োগ করার বিভিন্ন ধাপ

  1. API সেট-আপ করুন: ডেভেলপার প্রিভিউ প্রোগ্রামে যোগ দিন, আপনার Google Cloud প্রোজেক্টে API চালু করুন, আপনার কাস্টমার আইডি খুঁজে নিন এবং প্রয়োজনীয় অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা দিন।
  2. ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অনুমোদন করুন: একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন, অ্যাডমিন কোয়ারেন্টাইন API স্কোপের সাথে ডোমেন-ওয়াইড ডেলিগেশন কনফিগার করুন এবং অ্যাডমিনিস্ট্রেটরের ছদ্মবেশ ধারণ করে এমন একটি অ্যাক্সেস টোকেন পান।
  3. মেসেজ ট্রায়াজ করুন:
    1. কোয়ারেন্টাইন করা মেসেজের তালিকা দেখা ও সার্চ করা।
    2. মেসেজের বিবরণ পান।
    3. কোনও মেসেজ রিলিজ বা প্রত্যাখ্যান করুন, অথবা ব্যাচে মেসেজ রিলিজ বা প্রত্যাখ্যান করুন।
  4. ব্যবহারের কোটার মধ্যে থাকুন।

অডিট লগিং

কোয়ারেন্টাইনে থাকা মেসেজ পড়ে বা পরিবর্তন করে এমন প্রতিটি API কল অ্যাডমিন কনসোলের অডিট ও তদন্ত লগে রেকর্ড করা হয়, যে অ্যাডমিনিস্ট্রেটরের অনুরোধ হিসেবে এটি রান করে তার নামে এটি অ্যাট্রিবিউট করা হয়।

পরবর্তী ধাপ