একজন প্রশাসক হিসেবে, আপনি আপনার ডোমেনের মধ্যে অডিটের উদ্দেশ্যে মেলবক্স অ্যাকাউন্টগুলি ডাউনলোড করতে পারেন। এক্সপোর্টের জন্য একটি মেলবক্স প্রস্তুত করতে, ইমেল অডিট API ব্যবহারকারীর মেলবক্সের একটি এনক্রিপ্ট করা কপি তৈরি করে। সিস্টেমটি এনক্রিপ্ট করা মেলবক্স ফাইলগুলির URL গুলি ফেরত দেয় যা ডাউনলোড এবং ডিক্রিপ্ট করার সময়, mbox ফর্ম্যাটে উপলব্ধ থাকে।
প্রতিদিন সর্বাধিক ১০০টি মেলবক্স রপ্তানি তৈরির অনুরোধ, সমস্ত ডোমেন প্রশাসকদের কাছ থেকে। মেলবক্স তৈরির প্রক্রিয়াটি সময়সাপেক্ষ হতে পারে এবং মেলবক্সের আকারের উপর নির্ভর করে বেশ কয়েক দিন সময় লাগতে পারে।
গুগল ৩ সপ্তাহের জন্য এনক্রিপ্ট করা মেলবক্স ফাইলগুলি সংরক্ষণ করে রাখে, তাই এই সময়ের মধ্যে এই মেলবক্স ফাইলগুলি ডাউনলোড করতে ভুলবেন না। এই সময়ের পরে, সেগুলি মুছে ফেলা হয়। সময়সীমা শেষ হওয়ার আগে এই মেলবক্স ফাইলগুলি মুছে ফেলার জন্য, একটি এনক্রিপ্ট করা মেলবক্স মুছুন দেখুন।
একটি মেলবক্স ডাউনলোড করতে, নিম্নলিখিতগুলি করুন:
- একটি পাবলিক কী তৈরি করুন এবং আপলোড করুন — মেলবক্স ডাউনলোড করার জন্য একটি পাবলিক এনক্রিপশন কী তৈরি করুন। এই ধাপটি শুধুমাত্র একবার করতে হবে। যদি আপনি ইতিমধ্যেই একটি পাবলিক কী তৈরি করে থাকেন, তাহলে প্রতিটি মেলবক্স রপ্তানির জন্য আপনাকে এই ধাপটি সম্পূর্ণ করতে হবে না।
- ব্যবহারকারীর মেলবক্সের একটি এক্সপোর্ট ভার্সন তৈরি করুন — আপনি যখন একজন ব্যবহারকারীর মেলবক্সের একটি কপি তৈরির অনুরোধ করেন তখন মেলবক্স এক্সপোর্ট প্রক্রিয়া শুরু হয়। ইমেল অডিট API আপনার শংসাপত্রগুলিকে প্রমাণীকরণ এবং অনুমোদন করে এবং একটি অনন্য অনুরোধ আইডি প্রদান করে। মেলবক্স তৈরির প্রক্রিয়াটি সময়সাপেক্ষ হতে পারে এবং মেলবক্সের আকারের উপর নির্ভর করে বেশ কয়েক দিন সময় নিতে পারে।
- মেলবক্স ডাউনলোডের অবস্থা পুনরুদ্ধার করুন — মুলতুবি থাকা অনুরোধের অবস্থা পেতে মেলবক্স এক্সপোর্ট রিকোয়েস্ট আইডি ব্যবহার করুন। মেলবক্সটি কপি করে এক্সপোর্টের জন্য প্রস্তুত করার পরে, প্রতিক্রিয়াটি HTTP URL হিসাবে এনক্রিপ্ট করা মেলবক্স ফাইলগুলির তালিকা সহ
COMPLETEDএর একটি অবস্থা ফেরত পাঠায়। মেলবক্স ফাইলগুলি ডাউনলোড করতে এই URL গুলির সেটটি ব্যবহার করুন। - ডাউনলোড করা মেলবক্স ফাইলগুলি পান — এনক্রিপ্ট করা ফাইলগুলি ডাউনলোড করার পরে, ডোমেনের প্রাইভেট কী ব্যবহার করে মেলবক্স ফাইলগুলি ডিক্রিপ্ট করুন। ডিক্রিপ্ট হয়ে গেলে, ফাইলগুলি mbox ফর্ম্যাটে দেখা হবে।
একটি পাবলিক কী তৈরি করুন
মেলবক্সটি ডাউনলোড করার আগে, আপনাকে ডোমেনের জন্য একটি OpenPGP পাবলিক এনক্রিপশন কী আপলোড করতে হবে। মেলবক্স ডাউনলোড সেট আপ করার সময় এই ধাপটি একবার করা হয়। আপনি GNU Privacy Guard (GPG) এর মতো যেকোনো OpenPGP-সামঞ্জস্যপূর্ণ সফ্টওয়্যার ব্যবহার করে পাবলিক/প্রাইভেট কী জোড়া তৈরি করতে পারেন। এই পাবলিক এনক্রিপশন কীটি একটি PGP ফর্ম্যাট ASCII-এনকোডেড RSA কী হওয়া উচিত।
GNU Privacy Guard দিয়ে একটি কী তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
একটি নতুন কী তৈরি করুন:
gpg --gen-key --expertআপনার নিজস্ব ক্ষমতা সেট করতে, বিকল্প
8নির্বাচন করুন এবং সাইন ক্ষমতা টগল করুন।কী তৈরির প্রক্রিয়াটি সম্পূর্ণ করতে, সমস্ত ডিফল্ট বিকল্প গ্রহণ করুন। এই কীটিতে এনক্রিপ্ট অ্যাকশন সক্ষম থাকা উচিত। আপনি সাইন অ্যাকশনটি বন্ধ করতে পারেন কারণ এটি ব্যবহার করা হয়নি।
শুধুমাত্র আপনার Google Workspace-এর সাথে সম্পর্কিত ব্যবহারকারী আইডির জন্য কীটি রপ্তানি করুন:
যদি আপনি প্রথমবারের মতো GPG ব্যবহার করে একটি কী তৈরি করেন, তাহলে আপনার তৈরি করা একক কীটি রপ্তানি করুন:
gpg --armor --exportযদি আপনি ইতিমধ্যেই অন্যান্য কী তৈরি করার জন্য GPG ব্যবহার করে থাকেন, তাহলে আপনার কীরিংয়ে একাধিক কী আছে। কীগুলির একটি তালিকা পান:
gpg --list-keysযদি একাধিক কী তালিকাভুক্ত থাকে, তাহলে আপনি যে কীটি রপ্তানি করতে চান তার
uidউল্লেখ করুন:gpg --armor --export KEY_UID
Motobit অথবা অন্য কোন টুল দিয়ে base64 এনকোডিং দিয়ে কীটি এনকোড করুন। হেডার সহ সকল লাইন কপি করতে ভুলবেন না এবং অতিরিক্ত কোন লাইন যোগ করবেন না। পাবলিক কী ফাইলটি US-ASCII অক্ষরসেট ( IANA ASCII এর জন্য পছন্দের অক্ষরসেট নাম) দিয়ে পড়া উচিত।
উদাহরণ
নিচের উদাহরণটি দেখায় কিভাবে একটি পাবলিক কীকে base64 এনকোডেড স্ট্রিংয়ে রূপান্তর করতে হয়।
নিম্নলিখিত উদাহরণটি রূপান্তরের আগে পাবলিক কী:
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.10 (GNU/Linux)
mQENBErWaD4BCACt2ngfs6/+QOGYbxNbc3gLnXHtqp7NTTXNW4SJo+/A1oUZoGxA
Qx6zFXhQ/8MXW66+8STS1YqNJOARFtjbIKPwjrdcukdPzYVKGZre0RaxCnMyCV+6
F4YNQD1UegHTu2wCGR1uiYOfLxUa7/do6s31WRTH8vbtiPY9/6obEIxDjDzKIqYO
rvRDWqALBYklOkJ3Hbgfyl42EsnLiAhS+dMs2PCDi2X0ZJCPZ8eTjLsdAtqVZJ+R
WC1J3UDuFfmcpsDYRtUL9w6YMtlapC+9mmJ3ABEBAAG0V0Rhc2hlciBUZXN0IChU
dGVyMkBkYXNoZXItaHlkLXRlc3QuY29tPokBOAQTAQIAIgUCStZoPgIbDQYLCQgH
k19QckTpwBdskEYumFvmWve5UX2SVV7fzOC0nZtgFxtZGlJhGmjsA3rxFTlb+Ira
WZayXCWYiCzd7m9z5/KyGD2GFTK/94mdm25N6GXh/b35pIFZXBI/rZjrYrhYRBFu
GtzGFIw9AAnFyUzEUUVfPWUtBe5yHMW54C60nHk5xYIa6qFhiLp4PYqZCrYX1iIs
fRROFA==
=STHr
-----END PGP PUBLIC KEY BLOCK-----
নিম্নলিখিত উদাহরণটি রূপান্তরের পরে পাবলিক কী:
LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv
K1FPR1lieE5iYzNnTG5YSHRxcDdOVFRYTlc0U0pvKy9BMW9VWm9HeEENClF4NnpGWG
hRLzhNWFc2Nis4U1RTMVlxTkpPQVJGdGpiSUtQd2pyZGN1a2RQellWS0dacmUwUmF4
Q25NeUNWKzYNCkY0WU5RRDFVZWdIVHUyd0NHUjF1aVlPZkx4VWE3L2RvNnMzMVdSVE
g4dmJ0aVBZOS82b2JFSXhEakR6S0lxWU8NCnJ2UkRXcUFMQllrbE9rSjNIYmdmeWw0
MkVzbkxpQWhTK2RNczJQQ0RpMlgwWkpDUFo4ZVRqTHNkQXRxVlpKK1INCldDMUozVU
R1RmZtY3BzRFlSdFVMOXc2WU10bGFwQys5bW1KM0FCRUJBQUcwVjBSaGMyaGxjaUJV
WlhOMElDaFUNCmRHVnlNa0JrWVhOb1pYSXRhSGxrTFhSbGMzUXVZMjl0UG9rQk9BUV
RBUUlBSWdVQ1N0Wm9QZ0liRFFZTENRZ0gNCmsxOVFja1Rwd0Jkc2tFWXVtRnZtV3Zl
NVVYMlNWVjdmek9DMG5adGdGeHRaR2xKaEdtanNBM3J4RlRsYitJcmENCldaYXlYQ1
dZaUN6ZDdtOXo1L0t5R0QyR0ZUSy85NG1kbTI1TjZHWGgvYjM1cElGWlhCSS9yWmpy
WXJoWVJCRnUNCkd0ekdGSXc5QUFuRnlVekVVVVZmUFdVdEJlNXlITVc1NEM2MG5Iaz
V4WUlhNnFGaGlMcDRQWXFaQ3JZWDFpSXMNCmZSUk9GQT09DQo9U1RIcg0KLS0tLS1F
TkQgUEdQIFBVQkxJQyBLRVkgQkxPQ0stLS0tLQ==
পাবলিক কী আপলোড করুন
পাবলিক কী আপলোড করতে, base64-এনকোডেড পাবলিক কী দিয়ে একটি XML এন্ট্রি তৈরি করুন:
<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <apps:property name="publicKey" value="ENCODED_KEY"/> </atom:entry>
আপনার Google Workspace ডোমেনের
publickeyফিড URI-তে একটি HTTPPOSTঅনুরোধ পাঠান:POST https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME
সফল হলে, সার্ভারটি একটি
201 CREATED status codeএবং এই উদাহরণের অনুরূপ একটি প্রতিক্রিয়া প্রদান করে:<entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <id>https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME/id>/id> <updated>2009-04-17T15:02:45.646Z</updated> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME/id'/> <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME/id'/> <apps:property name='publicKey' value='ENCODED_KEY'/> </entry>
রপ্তানির জন্য একটি মেলবক্সের একটি অনুলিপি তৈরি করুন
এক্সপোর্ট এবং ডাউনলোডের জন্য ব্যবহারকারীর মেলবক্সের একটি কপি প্রস্তুত করতে, ইমেল অডিট API এর এক্সপোর্ট ফিড ব্যবহার করুন।
এক্সপোর্ট ফিডের URI-তে একটি POST অনুরোধ পাঠান এবং Authorization হেডারটি অন্তর্ভুক্ত করুন:
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME/SOURCE_USERNAME
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
DOMAIN_NAME: Google Workspace ডোমেন নাম—যেমন, example.com। -
SOURCE_USERNAME: আপনি যে মেলবক্সটি ডাউনলোড করতে চান তার ব্যবহারকারীর নাম।
অনুরোধটিতে নিম্নলিখিত Content-type হেডার রয়েছে:
Content-type: application/atom+xml
একটি মেলবক্স এক্সপোর্ট অনুরোধে ব্যবহারের জন্য প্যারামিটারগুলির সম্পূর্ণ তালিকার জন্য, সম্পদগুলি দেখুন: export ।
রপ্তানির জন্য একটি মেলবক্স তৈরির উদাহরণ
উদাহরণটি নিম্নলিখিত পরামিতিগুলি ব্যবহার করে:
- যে ব্যবহারকারীর জন্য মেলবক্সটি রপ্তানি করতে হবে তিনি হলেন
quinn@example.com। -
beginDateJuly 1, 2022, 04:30 hours। -
endDateAugust 30, 2022, 20:00 hours। -
includeDeletedfalse। -
searchQueryin:chatআছে। -
packageContentহলFULL_MESSAGE।
প্রোটোকল
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn <atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <apps:property name='beginDate' value='2022-07-01 04:30'/> <apps:property name='endDate' value='2022-08-30 20:00'/> <apps:property name='includeDeleted' value='false'/> <apps:property name='searchQuery' value='in:chat'/> <apps:property name='packageContent' value='FULL_MESSAGE'/> </atom:entry>
সফল হলে, সার্ভারটি একটি 201 CREATED স্ট্যাটাস কোড এবং একটি AtomPub এন্ট্রি প্রদান করবে।
<entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156>/id> <updated>2022-10-17T15:02:45.646Z</updated> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/> <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/> <apps:property name='status' value='PENDING'/> <apps:property name='packageContent' value='FULL_MESSAGE'/> <apps:property name='includeDeleted' value='false'/> <apps:property name='searchQuery' value='in:chat'/> <apps:property name='completedDate' value='2022-09-18 10:13'/> <apps:property name='adminEmailAddress' value='admin1@example.com'/> <apps:property name='requestId' value='53156'/> <apps:property name='userEmailAddress' value='quinn@example.com'/> <apps:property name='endDate' value='2022-08-30 20:00'/> <apps:property name='requestDate' value='2022-09-17 12:51'/> <apps:property name='beginDate' value='2022-07-01 04:30'/> </entry>
এই উদাহরণে, এই মেলবক্সের প্রক্রিয়াকরণ সম্পন্ন হয়েছে। status প্রোপার্টিটি COMPLETED হয়েছে এবং রপ্তানির জন্য ফেরত পাঠানো numberOfFiles দুটি।
জাভা
import java.util.Calendar; import com.google.gdata.client.appsforyourdomain.audit.AuditService; import com.google.gdata.client.appsforyourdomain.audit.MailBoxDumpRequest; import com.google.gdata.data.appsforyourdomain.generic.GenericEntry; ... MailBoxDumpRequest request = new MailBoxDumpRequest(); request.setAdminEmailAddress("admin@example.com"); request.setUserEmailAddress("quinn@example.com"); Calendar beginDate = Calendar.getInstance(); beginDate.set(2022, Calendar.JULY, 1, 4, 30); request.setBeginDate(beginDate.getTime()); Calendar endDate = Calendar.getInstance(); endDate.set(2022, Calendar.AUGUST, 30, 20, 0); request.setEndDate(endDate.getTime()); request.setIncludeDeleted(false); request.setSearchQuery("in:chat"); request.setPackageContent("FULL_MESSAGE"); AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); GenericEntry mailboxDumpEntry = service.createMailboxDumpRequest(request); String requestId = mailboxDumpEntry.getRequestId(); String status = mailboxDumpEntry.getStatus(); String numberOfFiles = mailboxDumpEntry.getNumberOfFiles();
.নেট
using System; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... MailboxDumpRequest mailboxDumpRequest = new MailboxDumpRequest(); mailboxDumpRequest.BeginDate = new DateTime(2022, 7, 1, 4, 30, 0); mailboxDumpRequest.EndDate = new DateTime(2022, 8, 30, 20, 0, 0); mailboxDumpRequest.IncludeDeleted = false; mailboxDumpRequest.SearchQuery = "in:chat"; mailboxDumpRequest.PackageContent = MonitorLevel.FULL_MESSAGE; AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); MailboxDumpRequest dumpRequest = service.CreateMailboxDumpRequest("quinn", mailboxDumpRequest);
একটি মেলবক্সের রপ্তানি অবস্থা পুনরুদ্ধার করুন
যেহেতু একটি মেলবক্স রপ্তানি প্রস্তুতি একটি অ্যাসিঙ্ক্রোনাস প্রক্রিয়া, তাই এনক্রিপ্ট করা মেলবক্স প্রক্রিয়াকরণ সম্পন্ন হয়েছে কিনা তা দেখতে এই পুনরুদ্ধার অনুরোধটি ব্যবহার করুন।
এক্সপোর্টের জন্য প্রস্তুত একটি মেলবক্সের স্ট্যাটাস বিশদ পুনরুদ্ধার করতে, এক্সপোর্ট ফিডের URI-তে মেলবক্সের requestId সহ একটি HTTP GET অনুরোধ পাঠান এবং Authorization হেডার অন্তর্ভুক্ত করুন:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME/SOURCE_USERNAME/MAILBOX_REQUESTID
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
DOMAIN_NAME: Google Workspace ডোমেন নাম—যেমন, example.com। -
SOURCE_USERNAME: আপনি যে মেলবক্সটি ডাউনলোড করতে চান তার ব্যবহারকারীর নাম। -
MAILBOX_REQUESTID:requestIDহল মেলবক্স এক্সপোর্ট অনুরোধের জন্য একটি অনন্য শনাক্তকারী যা প্রাথমিকভাবে এক্সপোর্ট অনুরোধ করা হলে ফেরত পাঠানো হয়।
এই অনুরোধটি মেলবক্স এক্সপোর্টের বর্তমান অবস্থা সহ একটি AtomPub এন্ট্রি প্রদান করে। বর্তমান অবস্থার সম্ভাব্য মানগুলি নিম্নরূপ:
-
PENDING - অনুরোধটি প্রক্রিয়াধীন।
-
ERROR - কিছু ত্রুটির কারণে অনুরোধটি ব্যর্থ হয়েছে। সম্ভাব্য ত্রুটির একটি উদাহরণ হল ডোমেনের জন্য একটি ভুল API পাবলিক কী আপলোড করা হয়েছে।
-
COMPLETED - অনুরোধটি সম্পূর্ণরূপে প্রক্রিয়া করা হয়েছে এবং এনক্রিপ্ট করা মেলবক্স ফাইলগুলি ডাউনলোডের জন্য প্রস্তুত।
-
MARKED_DELETE - পরবর্তী সময়ে Google ক্লিনআপ কাজটি চালানোর সময় অনুরোধটি মুছে ফেলার জন্য চিহ্নিত করা হবে। এই ক্লিনআপ কাজ সম্পর্কে আরও তথ্যের জন্য, একটি এনক্রিপ্ট করা মেলবক্স মুছে ফেলুন দেখুন।
-
DELETED - "একটি এনক্রিপ্ট করা মেলবক্স মুছে ফেলুন" অপারেশন ব্যবহার করে মেলবক্স ফাইলগুলি সফলভাবে মুছে ফেলা হয়েছে।
-
EXPIRED - ৩ সপ্তাহ ধরে রাখার সীমা শেষ হওয়ার পর গুগল মেলবক্স ফাইলগুলি মুছে ফেলে।
একটি মেলবক্সের রপ্তানি অবস্থা পুনরুদ্ধারের উদাহরণ
এই উদাহরণটি quinn@example.com ব্যবহারকারীর জন্য requestIds 53156 এবং 34201 এর সাথে সম্পর্কিত মেলবক্সের স্থিতি পুনরুদ্ধার করে।
প্রোটোকল
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156
সফল হলে, সার্ভারটি একটি 201 CREATED স্ট্যাটাস কোড প্রদান করবে।
নিচের উত্তর থেকে আপনি দেখতে পাচ্ছেন, স্ট্যাটাসটি একটি ERROR এবং তাই, এনক্রিপ্ট করা মেলবক্স ফাইলগুলি কখনও তৈরি করা হয়নি।
<entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
<id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156</id>
<updated>2022-10-17T15:02:45.646Z</updated>
<link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/>
<link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/>
<apps:property name='status' value='ERROR'/>
<apps:property name='packageContent' value='FULL_MESSAGE'/>
<apps:property name='includeDeleted' value='false'/>
<apps:property name='searchQuery' value='in:chat'/>
<apps:property name='completedDate' value='2022-09-18 10:13'/>
<apps:property name='adminEmailAddress' value='admin1@example.com'/>
<apps:property name='numberOfFiles' value='0'/>
<apps:property name='requestId' value='53156'/>
<apps:property name='userEmailAddress' value='quinn@example.com'/>
<apps:property name='endDate' value='2022-08-30 20:00'/>
<apps:property name='requestDate' value='2022-09-17 12:51'/>
<apps:property name='beginDate' value='2022-07-01 04:30'/>
</entry>
এই উদাহরণটি requestId 34201 সাথে সম্পর্কিত মেলবক্সের অবস্থা পুনরুদ্ধার করে:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/34201
এই দ্বিতীয় উদাহরণটি একটি COMPLETED স্ট্যাটাস সহ সফল। এটি এনক্রিপ্ট করা মেলবক্স ফাইল ধারণকারী দুটি মেলবক্স ফাইল URL ফেরত দেয়, যা fileUrl উপাদানের URL ব্যবহার করে ডাউনলোড করা যেতে পারে।
<entry>...
...
<apps:property name='status' value='COMPLETED'/>
<apps:property name='packageContent' value='FULL_MESSAGE'/>
<apps:property name='completedDate' value='2022-09-18 10:13'/>
<apps:property name='adminEmailAddress' value='admin2@example.com'/>
<apps:property name='numberOfFiles' value='2'/>
<apps:property name='requestId' value='34201'/>
<apps:property name='userEmailAddress' value='namrata@example.com'/>
<apps:property name='requestDate' value='2022-09-17 12:51'/>
<apps:property name='fileUrl0' value='https://apps-apis.google.com/a/data/compliance/audit/OQAAABW3Z2OlwkDFR0H5n_6lnYAzv-pWlkAlbTyAzvJEV0MC4c7lBDW' />
<apps:property name='fileUrl1' value='https://apps-apis.google.com/a/data/compliance/audit/OQAAABW3Z2OlwkD55nLv-pWlkAlbTyAzvJEVPnVYW45C4cC34gtyVCC' />
</entry>
জাভা
import com.google.gdata.client.appsforyourdomain.audit.AuditService; import com.google.gdata.data.appsforyourdomain.generic.GenericEntry; ... AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); GenericEntry mailboxDumpEntry1 = service.retrieveMailboxDumpRequest("quinn", "53156"); String status = mailboxDumpEntry1.getProperty("status"); // Status is "ERROR" if the mailbox for this request isn't created GenericEntry mailboxDumpEntry2 = service.retrieveMailboxDumpRequest("quinn", "34201"); String status = mailboxDumpEntry2.getProperty("status");
.নেট
using System; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); MailboxDumpRequest mailboxDumpEntry1 = service.RetrieveMailboxDumpRequest("quinn", "53156"); RequestStatus status1 = mailboxDumpEntry1.Status; // Status is "ERROR" if the mailbox for this request isn't created MailboxDumpRequest mailboxDumpEntry2 = service.RetrieveMailboxDumpRequest("quinn", "34201"); RequestStatus status2 = mailboxDumpEntry2.Status;
সমস্ত মেলবক্স স্থিতির অনুরোধ পুনরুদ্ধার করুন
একটি নির্দিষ্ট তারিখ থেকে শুরু করে একটি ডোমেনের জন্য সমস্ত মেলবক্স অনুরোধ পুনরুদ্ধার করতে, এক্সপোর্ট ফিড URI-তে একটি HTTP GET অনুরোধ করুন এবং Authorization শিরোনাম অন্তর্ভুক্ত করুন:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME?fromDate=FROM_DATE
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
DOMAIN_NAME: Google Workspace ডোমেন নাম—যেমন, example.com। -
FROM_DATE: সমন্বিত ইউনিভার্সাল টাইম (UTC) ফর্ম্যাটে একটি এনক্রিপ্ট করা মেলবক্স অনুরোধের URL-এনকোডেড তারিখ। যদি এইGETঅনুরোধে কোনওfromDateনির্দিষ্ট না থাকে, তাহলে গত তিন সপ্তাহের সমস্ত অনুরোধ পুনরুদ্ধার করা হবে।
একটি বৃহৎ প্রতিক্রিয়ার জন্য, ফলাফলের প্রতিটি পৃষ্ঠা সর্বাধিক ১০০টি এন্ট্রি প্রদান করে এবং ফলাফলের পরবর্তী পৃষ্ঠার দিকে নির্দেশ করে একটি <link rel='next'...> ট্যাগে একটি URI অন্তর্ভুক্ত করে। আপনার ক্লায়েন্ট অ্যাপ্লিকেশন তৈরি করার সময়, আপনার কোডকে এই অতিরিক্ত ফলাফলগুলি পরিচালনা করতে হবে।
সকল মেলবক্স স্ট্যাটাস অনুরোধ পুনরুদ্ধারের উদাহরণ
এই উদাহরণটি 9 PM, August 30, 2022 বা তার পরে করা example.com ডোমেনের জন্য সমস্ত মেলবক্স স্ট্যাটাস অনুরোধ পুনরুদ্ধার করে:
প্রোটোকল
<feed xmlns:atom='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006'> <id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain</id> <updated>2010-03-17T15:29:21.064Z</updated> <link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com?fromDate=2022-08-30%2021:00'/> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com'/> <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com'/> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com?fromDate=2022-08-30%2021:00'/> <openSearch:startIndex>1</openSearch:startIndex> <entry> <atom:id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain/request ID</atom:id> <atom:updated>2022-04-17T15:29:21.064Z</atom:updated> <atom:link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain/request ID'/> <atom:link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/feeds/compliance/audit/mail/export/domain/request ID'/> <apps:property name='status' value='ERROR'/> <apps:property name='packageContent' value='FULL_MESSAGE'/> <apps:property name='includeDeleted' value='false'/> <apps:property name='searchQuery' value='in:chat'/> <apps:property name='completedDate' value='2022-09-18 10:13'/> <apps:property name='adminEmailAddress' value='admin1@example.com'/> <apps:property name='numberOfFiles' value='0'/> <apps:property name='requestId' value='the mailbox ID for this request'/> </entry> <entry> <id>>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain/second request ID</id> ... <apps:property name='status' value='COMPLETED'/> <apps:property name='packageContent' value='FULL_MESSAGE'/> <apps:property name='includeDeleted' value='false'/> <apps:property name='completedDate' value='2022-09-18 10:13'/> <apps:property name='adminEmailAddress' value='admin1@example.com'/> <apps:property name='numberOfFiles' value='0'/> <apps:property name='requestId' value='the mailbox ID for this request'/> <apps:property name='userEmailAddress' value='quinn@example.com'/> <apps:property name='endDate' value='2022-08-30 20:00'/> <apps:property name='requestDate' value='2022-09-17 12:51'/> <apps:property name='beginDate' value='2022-07-01 04:30'/> </entry> </feed>
জাভা
import java.util.Calendar; import java.util.List; import com.google.gdata.client.appsforyourdomain.audit.AuditService; import com.google.gdata.client.appsforyourdomain.audit.MailBoxDumpRequest; import com.google.gdata.data.appsforyourdomain.generic.GenericEntry; ... AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); Calendar fromDate = Calendar.getInstance(); fromDate.set(2022, Calendar.AUGUST, 30, 21, 0); List<GenericEntry> mailboxDumpRequestEntries = service.retrieveAllMailboxDumpRequests(fromDate.getTime()); for (GenericEntry entry : mailboxDumpRequestEntries) { MailBoxDumpRequest request = new MailBoxDumpRequest(entry); String status = request.getStatus(); }
.নেট
using System; using System.Collections.Generic; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); GenericFeed<MailboxDumpRequest> dumpRequests = service.RetrieveAllMailboxDumpRequests(new DateTime(2022, 8, 30, 21, 0, 0);
একটি এনক্রিপ্ট করা মেলবক্স মুছুন
COMPLETED বা MARKED_DELETED স্ট্যাটাস সহ এনক্রিপ্ট করা মেলবক্স ফাইলগুলি মুছে ফেলতে, এক্সপোর্ট ফিডের URI-তে একটি HTTP DELETE অনুরোধ করুন যাতে মেলবক্সের requestId এবং Authorization হেডার অন্তর্ভুক্ত থাকে।
DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME/SOURCE_USERNAME/MAILBOX_REQUESTID
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
DOMAIN_NAME: Google Workspace ডোমেন নাম—যেমন, example.com। -
SOURCE_USERNAME: আপনার ডাউনলোড করা মেলবক্সের ব্যবহারকারীর নাম। -
MAILBOX_REQUESTID:requestIDহল মেলবক্স এক্সপোর্ট অনুরোধের জন্য একটি অনন্য শনাক্তকারী যা প্রাথমিকভাবে এক্সপোর্ট অনুরোধ করা হলে ফেরত পাঠানো হয়।
মুছে ফেলার প্রক্রিয়া চলাকালীন যদি কোনও ত্রুটি দেখা দেয়, তাহলে MARKED_DELETE স্ট্যাটাসটি ফেরত পাঠানো হবে। এই অনুরোধটি 24 ঘন্টার মধ্যে Google ক্লিনআপ জবের মাধ্যমে স্বয়ংক্রিয়ভাবে মুছে ফেলা হবে। তবে MARKED_DELETE স্ট্যাটাস সহ একটি অনুরোধের জন্য, কিছু (অথবা সমস্ত) মেলবক্স ফাইল এখনও ডাউনলোডের জন্য উপলব্ধ থাকতে পারে। আপনি যদি নিশ্চিত করতে চান যে ফাইলগুলি মুছে ফেলা হয়েছে, তাহলে DELETED স্ট্যাটাসটি ফেরত না আসা পর্যন্ত এই অপারেশনটি আবার চালান। যদি MARKED_DELETE স্ট্যাটাসটি ধারাবাহিকভাবে ফেরত পাঠানো হয়, তাহলে সূচকীয় সময় ব্যাক অফের পরে আবার চেষ্টা করুন।
একটি এনক্রিপ্ট করা মেলবক্স মুছে ফেলার উদাহরণ
এই উদাহরণটি 34201 এর requestId এর সাথে সম্পর্কিত quinn@example.com ব্যবহারকারীর মেলবক্সটি মুছে ফেলে:
প্রোটোকল
DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/34201
জাভা
import com.google.gdata.client.appsforyourdomain.audit.AuditService; ... AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); service.deleteMailboxDumpRequest("quinn", "34201");
.নেট
using System; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); service.DeleteMailboxDumpRequest("quinn", "34201");