একটি মেইলবক্স ডাউনলোড করুন

একজন প্রশাসক হিসাবে, আপনি নিরীক্ষার উদ্দেশ্যে আপনার ডোমেনের মধ্যে মেইলবক্স অ্যাকাউন্ট ডাউনলোড করতে পারেন। রপ্তানির জন্য একটি মেলবক্স প্রস্তুত করতে, ইমেল অডিট API ব্যবহারকারীর মেলবক্সের একটি এনক্রিপ্ট করা অনুলিপি তৈরি করে৷ সিস্টেমটি এনক্রিপ্ট করা মেলবক্স ফাইলগুলির URLগুলি ফেরত দেয় যেগুলি ডাউনলোড এবং ডিক্রিপ্ট করা হলে, এমবক্স ফর্ম্যাটে পাওয়া যায়৷

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

Google এনক্রিপ্ট করা মেলবক্স ফাইলগুলিকে 3 সপ্তাহের জন্য ধরে রাখে তাই নিশ্চিত করুন যে আপনি এই সময়ের মধ্যে এই মেলবক্স ফাইলগুলি ডাউনলোড করেছেন৷ এই সময়ের পরে, তারা মুছে ফেলা হয়। সময়সীমা শেষ হওয়ার আগে এই মেলবক্স ফাইলগুলি মুছে ফেলতে, একটি এনক্রিপ্ট করা মেলবক্স মুছুন দেখুন।

একটি মেলবক্স ডাউনলোড করতে, নিম্নলিখিতগুলি করুন:

  • একটি সর্বজনীন কী তৈরি এবং আপলোড করুন — মেলবক্স ডাউনলোড করার জন্য একটি সর্বজনীন এনক্রিপশন কী তৈরি করুন৷ এই পদক্ষেপ শুধুমাত্র একবার করা প্রয়োজন. আপনি যদি ইতিমধ্যেই একটি সর্বজনীন কী তৈরি করে থাকেন তবে প্রতিটি মেলবক্স রপ্তানির জন্য আপনাকে এই পদক্ষেপটি সম্পূর্ণ করতে হবে না৷
  • ব্যবহারকারীর মেলবক্সের একটি রপ্তানি সংস্করণ তৈরি করুন — আপনি যখন ব্যবহারকারীর মেলবক্সের একটি অনুলিপি তৈরির অনুরোধ করেন তখন মেইলবক্স রপ্তানি প্রক্রিয়া শুরু হয়। ইমেল অডিট API আপনার শংসাপত্রগুলিকে প্রমাণীকরণ করে এবং অনুমোদন করে এবং একটি অনন্য অনুরোধ আইডি ফেরত দেয়। মেলবক্স তৈরির প্রক্রিয়াটি সময়সাপেক্ষ হতে পারে এবং মেলবক্সের আকারের উপর নির্ভর করে বেশ কয়েক দিন সময় লাগতে পারে।
  • মেলবক্স ডাউনলোড স্ট্যাটাস পুনরুদ্ধার করুন — মুলতুবি থাকা অনুরোধের স্থিতি পেতে মেলবক্স এক্সপোর্ট রিকোয়েস্ট আইডি ব্যবহার করুন। মেইলবক্সটি কপি করা এবং রপ্তানির জন্য প্রস্তুত হওয়ার পরে, প্রতিক্রিয়াটি HTTP URL হিসাবে এনক্রিপ্ট করা মেলবক্স ফাইলগুলির তালিকা সহ COMPLETED স্থিতি প্রদান করে। মেলবক্স ফাইলগুলি ডাউনলোড করতে URL এর এই সেটটি ব্যবহার করুন৷
  • ডাউনলোড করা মেলবক্স ফাইলগুলি প্রাপ্ত করুন — এনক্রিপ্ট করা ফাইলগুলি ডাউনলোড করার পরে, ডোমেনের ব্যক্তিগত কী ব্যবহার করে মেলবক্স ফাইলগুলিকে ডিক্রিপ্ট করুন৷ একবার ডিক্রিপ্ট করা হলে, ফাইলগুলি mbox ফরম্যাটে দেখা হয়।

একটি সর্বজনীন কী তৈরি করুন

আপনি মেলবক্স ডাউনলোড করার আগে, আপনাকে ডোমেনের জন্য একটি OpenPGP পাবলিক এনক্রিপশন কী আপলোড করতে হবে৷ মেইলবক্স ডাউনলোড সেট আপ করার সময় এই পদক্ষেপটি একবার করা হয়। আপনি যেকোনো OpenPGP- সামঞ্জস্যপূর্ণ সফটওয়্যার, যেমন GNU Privacy Guard (GPG) ব্যবহার করে পাবলিক/প্রাইভেট কী জোড়া তৈরি করতে পারেন। এই সর্বজনীন এনক্রিপশন কী একটি PGP ফর্ম্যাট ASCII-এনকোডেড RSA কী হওয়া উচিত।

GNU প্রাইভেসি গার্ড দিয়ে একটি কী তৈরি করতে, এই ধাপগুলি অনুসরণ করুন:

  1. GnuPG 1.4 ইনস্টল করুন ।

  2. একটি নতুন কী তৈরি করুন:

    gpg --gen-key --expert

  3. আপনার নিজস্ব ক্ষমতা সেট করতে, বিকল্প 8 নির্বাচন করুন এবং সাইন ক্ষমতা টগল করুন।

  4. কী জেনারেশন প্রক্রিয়া সম্পূর্ণ করতে, সমস্ত ডিফল্ট বিকল্প গ্রহণ করুন। এই কীটিতে এনক্রিপ্ট অ্যাকশন সক্রিয় থাকা উচিত। আপনি সাইন অ্যাকশনটি বন্ধ করতে পারেন কারণ এটি ব্যবহার করা হয়নি।

  5. শুধুমাত্র আপনার Google Workspace-এর সাথে সামঞ্জস্যপূর্ণ ইউজার আইডির কী এক্সপোর্ট করুন:

    • আপনি যদি প্রথমবার GPG ব্যবহার করে একটি কী তৈরি করেন, তাহলে আপনি এইমাত্র তৈরি করা একক কী রপ্তানি করুন:

      gpg --armor --export

    • আপনি যদি ইতিমধ্যেই অন্যান্য কী তৈরি করতে GPG ব্যবহার করে থাকেন, তাহলে আপনার কীরিং-এ একাধিক কী আছে। কীগুলির একটি তালিকা পান:

      gpg --list-keys

      তালিকাভুক্ত একাধিক কী থাকলে, আপনি যে কী রপ্তানি করতে চান তার uid উল্লেখ করুন:

      gpg --armor --export KEY_UID

  6. Motobit বা অন্য টুল দিয়ে base64 এনকোডিং সহ কী এনকোড করুন। শিরোনাম সহ সমস্ত লাইন অনুলিপি করা নিশ্চিত করুন এবং কোনো অতিরিক্ত লাইন যোগ করবেন না। পাবলিক কী ফাইলটি অক্ষরসেট US-ASCII , ( ASCII-এর জন্য IANA পছন্দের অক্ষরসেট নাম) দিয়ে পড়া উচিত।

উদাহরণ

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি সর্বজনীন কীকে একটি বেস64 এনকোডেড স্ট্রিং-এ রূপান্তর করতে হয়।

নিম্নলিখিত উদাহরণ হল রূপান্তরের আগে সর্বজনীন কী:

-----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==

পাবলিক কী আপলোড করুন

  1. সর্বজনীন কী আপলোড করতে, 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>

  2. আপনার Google Workspace ডোমেনের publickey কি ফিড URI-তে HTTP POST অনুরোধ পাঠান:

    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 ।
  • beginDate হল July 1, 2022, 04:30 hours ।
  • endDate হল August 30, 2022, 20:00 hours ।
  • includeDeleted false ।
  • searchQuery in: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
মেলবক্স ফাইলগুলি 3 সপ্তাহ ধরে রাখার সীমার পরে Google মুছে দিয়েছে৷

একটি মেলবক্সের রপ্তানি স্থিতি পুনরুদ্ধার করার উদাহরণ

এই উদাহরণটি 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 স্থিতি সহ সফল। এটি এনক্রিপ্ট করা মেলবক্স ফাইল সমন্বিত দুটি মেলবক্স ফাইল ইউআরএল ফেরত দেয়, যা ফাইল 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 উল্লেখ না থাকলে, গত তিন সপ্তাহের সমস্ত অনুরোধ পুনরুদ্ধার করা হয়।

একটি বড় প্রতিক্রিয়ার জন্য, ফলাফলের প্রতিটি পৃষ্ঠা সর্বাধিক 100টি এন্ট্রি প্রদান করে, এবং ফলাফলের পরবর্তী পৃষ্ঠায় নির্দেশ করে একটি <link rel='next'...> ট্যাগে একটি URI অন্তর্ভুক্ত করে। আপনার ক্লায়েন্ট অ্যাপ্লিকেশন বিকাশ করার সময়, আপনার কোডকে এই অতিরিক্ত ফলাফলগুলি পরিচালনা করতে হবে।

সমস্ত মেলবক্স স্ট্যাটাস অনুরোধ পুনরুদ্ধার করার উদাহরণ

এই উদাহরণটি ডোমেন example.com এর জন্য 9 PM, August 30, 2022 পরে করা সমস্ত মেলবক্স স্ট্যাটাস অনুরোধ পুনরুদ্ধার করে :

প্রোটোকল

<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 এর স্থিতি সহ এনক্রিপ্ট করা মেলবক্স ফাইলগুলি মুছতে, মেলবক্সের requestId এবং Authorization শিরোনাম সহ এক্সপোর্ট ফিডের URI-তে একটি HTTP DELETE অনুরোধ করুন৷

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");