গুগল ভল্ট এপিআই আপনাকে গুগল ভল্ট এক্সপোর্ট পরিচালনা করতে দেয়। আপনি নিম্নলিখিত কাজগুলো সম্পাদন করতে পারেন:
এক্সপোর্ট তৈরি করুন। আপনার কোয়েরির সাথে মেলে এমন মেসেজ বা ফাইল খুঁজে বের করতে এবং সেগুলোকে গুগল ক্লাউডে এক্সপোর্ট করতে ভল্ট-এ একটি অনুরোধ পাঠান।
আপনি আপনার প্রতিষ্ঠান জুড়ে একবারে সর্বোচ্চ ২০টি এক্সপোর্ট চালু রাখতে পারেন। এক্সপোর্ট দ্রুত করার জন্য, বড় এক্সপোর্টগুলোকে ছোট ছোট অংশে ভাগ করুন। উদাহরণস্বরূপ, একবারে সব ডেটা এক্সপোর্ট না করে মাস অনুযায়ী এক্সপোর্ট করুন। আরেকটি বিকল্প হলো, প্রতিটি এক্সপোর্টে ব্যবহারকারী, গ্রুপ বা চ্যাট স্পেসের মতো কম সংখ্যক আইটেম অন্তর্ভুক্ত করা। এক্সপোর্টগুলো তৈরি করার পর ১৫ দিনের জন্য উপলব্ধ থাকে। এই সময়ের পর, সেগুলো মুছে ফেলা হয় এবং আর অ্যাক্সেসযোগ্য থাকে না।
নিম্নলিখিত উদাহরণগুলিতে দেখানো হয়েছে কীভাবে বিভিন্ন পরিষেবার জন্য এক্সপোর্ট তৈরি করতে হয়:
রপ্তানিগুলোর তালিকা দেখুন । কোনো একটি বিষয়ের সাথে যুক্ত সমস্ত রপ্তানির অবস্থা জানুন।
রপ্তানিসমূহ দেখুন । কোনো রপ্তানি সম্পর্কিত তথ্য পুনরুদ্ধার করুন।
এক্সপোর্ট ডাউনলোড করুন । গুগল ক্লাউড থেকে একটি এক্সপোর্ট ডাউনলোড করুন।
এক্সপোর্ট মুছে ফেলুন । কোনো বিষয় থেকে এক্সপোর্টগুলো অপ্রয়োজনীয় হয়ে গেলে সরিয়ে ফেলুন।
শুরু করার আগে
প্রয়োজনীয় লাইব্রেরি ও অথেনটিকেশন সেট আপ করার জন্য, আপনার প্রোগ্রামিং ভাষার কুইকস্টার্টটি অনুসরণ করুন।
ভল্ট রিসোর্স নিয়ে কাজ করার জন্য, একটি অ্যাকাউন্টের অবশ্যই প্রয়োজনীয় ভল্ট প্রিভিলেজ এবং ম্যাটারটিতে অ্যাক্সেস থাকতে হবে। কোনো ম্যাটার অ্যাক্সেস করার জন্য, অ্যাকাউন্টটিকে অবশ্যই ম্যাটারটি তৈরি করতে হবে, অথবা ম্যাটারটি তাদের সাথে শেয়ার করা থাকতে হবে, কিংবা তাদের 'ভিউ অল ম্যাটারস' প্রিভিলেজ থাকতে হবে।
একটি জিমেইল এক্সপোর্ট তৈরি করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি জিমেইল এক্সপোর্ট তৈরি করতে হয়। এই অনুরোধটি সেই সমস্ত জিমেইল এবং ক্লাসিক হ্যাংআউটস বার্তা এক্সপোর্ট করে যা নিম্নলিখিত শর্তগুলো পূরণ করে:
-
email1এবংemail2অ্যাকাউন্টগুলোর মালিকানাধীন বার্তাগুলো। - খসড়া বার্তাগুলো এর অন্তর্ভুক্ত নয়।
-
ceo@solarmora.comএ বার্তা পাঠানো হয়েছে।
এই উদাহরণগুলিতে ক্লাসিক জিমেইল এক্সপোর্ট সিস্টেম ব্যবহার করা হয়েছে। নতুন এক্সপোর্ট সিস্টেম ব্যবহার করে এক্সপোর্ট করতে, MailExportOptions- এ useNewExport true সেট করুন।
জাভা
public Export createMailAccountHeldDataExports(Vault client, String matterId) {
AccountInfo emailsToSearch = new AccountInfo().setEmails(ImmutableList.of("email1", "email2"));
MailOptions mailQueryOptions = new MailOptions().setExportFormat("PST");
String queryTerms = "to:ceo@solarmora.com";
Query mailQuery =
new Query()
.setCorpus("MAIL")
.setDataScope("HELD_DATA")
.setSearchMethod("ACCOUNT")
.setAccountInfo(emailsToSearch)
.setTerms(queryTerms)
.setMailOptions(mailQueryOptions);
MailExportOptions mailExportOptions =
new MailExportOptions()
.setExportFormat("MBOX")
.showConfidentialModeContent(true);
Export wantedExport =
new Export()
.setMatterId(matterId)
.setName("My first mail accounts export")
.setQuery(mailQuery)
.setExportOptions(new ExportOptions().setMailOptions(mailExportOptions));
return client.matters().exports().create(matter, wantedExport).execute();
}
পাইথন
def create_mail_account_held_data_export(service, matter_id):
emails_to_search = ['email1', 'email2']
mail_query_options = {'excludeDrafts': True}
query_terms = 'to:ceo@solarmora.com'
mail_query = {
'corpus': 'MAIL',
'dataScope': 'HELD_DATA',
'searchMethod': 'ACCOUNT',
'accountInfo': {
'emails': emails_to_search
},
'terms': query_terms,
'mailOptions': mail_query_options,
}
mail_export_options = {
'exportFormat': 'MBOX',
'showConfidentialModeContent': True
}
wanted_export = {
'name': 'My first mail accounts export',
'query': mail_query,
'exportOptions': {
'mailOptions': mail_export_options
}
}
return service.matters().exports().create(
matterId=matter_id, body=wanted_export).execute()
জিমেইলে এক্সপোর্টের ক্ষেত্রে, PST ফরম্যাটের চেয়ে MBOX ফরম্যাটের এক্সপোর্ট দ্রুত সম্পন্ন হয়।
ড্রাইভ এক্সপোর্ট তৈরি করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি ড্রাইভ এক্সপোর্ট তৈরি করতে হয়। এই অনুরোধটি শেয়ার করা ড্রাইভের ফাইল সহ সেই সমস্ত ফাইল এক্সপোর্ট করে, যা নিম্নলিখিত শর্তগুলো পূরণ করে:
- নির্দিষ্ট সাংগঠনিক ইউনিটের অন্তর্ভুক্ত হতে হবে (যা অ্যাডমিন এসডিকে থেকে প্রাপ্ত)।
নির্দিষ্ট সময়সীমার মধ্যে তৈরি করা হয়েছিল।
জাভা
public Export createDriveOuAllDataExport(Vault client, String matterId) {
OrgUnitInfo ouToSearch = new OrgUnitInfo().setOrgUnitId("ou id retrieved from admin sdk");
DriveOptions driveQueryOptions = new DriveOptions().setIncludeSharedDrives(true);
Query driveQuery =
new Query()
.setCorpus("DRIVE")
.setDataScope("ALL_DATA")
.setSearchMethod("ORG_UNIT")
.setOrgUnitInfo(ouToSearch)
.setDriveOptions(driveQueryOptions)
.setStartTime("2017-03-16T00:00:00Z")
.setEndTime("2017-03-16T00:00:00Z")
.setTimeZone("Etc/GMT+2");
DriveExportOptions driveExportOptions = new DriveExportOptions().setIncludeAccessInfo(false);
Export wantedExport =
new Export()
.setName("My first drive ou export")
.setQuery(driveQuery)
.setExportOptions(new ExportOptions().setDriveOptions(driveExportOptions));
return client.matters().exports().create(matter, wantedExport).execute();
}
পাইথন
def create_drive_ou_all_data_export(service, matter_id):
ou_to_search = 'ou id retrieved from admin sdk'
drive_query_options = {'includeSharedDrives': True}
drive_query = {
'corpus': 'DRIVE',
'dataScope': 'ALL_DATA',
'searchMethod': 'ORG_UNIT',
'orgUnitInfo': {
'org_unit_id': ou_to_search
},
'driveOptions': drive_query_options,
'startTime': '2017-03-16T00:00:00Z',
'endTime': '2017-09-23T00:00:00Z',
'timeZone': 'Etc/GMT+2'
}
drive_export_options = {'includeAccessInfo': False}
wanted_export = {
'name': 'My first drive ou export',
'query': drive_query,
'exportOptions': {
'driveOptions': drive_export_options
}
}
return service.matters().exports().create(
matterId=matter_id, body=wanted_export).execute()
একটি মিট এক্সপোর্ট তৈরি করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি Meet এক্সপোর্ট তৈরি করতে হয়। এই অনুরোধটি নির্দিষ্ট সাংগঠনিক ইউনিটের অ্যাকাউন্টগুলির সাথে যুক্ত ফাইলগুলি এক্সপোর্ট করে, যেগুলির ফাইলের নাম Meet রেকর্ডিংয়ের প্যাটার্ন অনুসরণ করে।
পাইথন
def create_meet_export(service, matter_id, ou_to_search, export_name):
export = {
'name': export_name,
'query': {
'corpus': 'DRIVE',
'dataScope': 'ALL_DATA',
'searchMethod': 'ORG_UNIT',
'terms': 'title:"...-...-... \\(....-..-.. at ..:.. *\\)"',
'orgUnitInfo': {
'orgUnitId': 'id:'+ou_to_search
},
'driveOptions': {
'includeTeamDrives': True,
'includeSharedDrives': True
},
'timeZone': 'Etc/GMT',
'method': 'ORG_UNIT'
},
'exportOptions': {
'driveOptions': {},
'region': 'ANY'
},
}
return service.matters().exports().create(
matterId=matter_id, body=export).execute()
সংরক্ষিত কোয়েরি থেকে রপ্তানি করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি সংরক্ষিত কোয়েরি থেকে এক্সপোর্ট তৈরি করতে হয়।
পাইথন
def create_mail_export_from_saved_query(service, matter_id, saved_query_id, export_name):
export = {
'name': export_name,
'exportOptions': {
'mailOptions': {
'exportFormat': 'PST',
'showConfidentialModeContent': True
},
'region': 'ANY'
}
}
export['query'] = service.matters().savedQueries().get(
savedQueryId=saved_query_id, matterId=matter_id).execute()['query']
return service.matters().exports().create(
matterId=matter_id, body=export).execute()
তালিকা রপ্তানি
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি বিষয়ের সাথে যুক্ত রপ্তানিগুলির একটি তালিকা পুনরুদ্ধার করতে হয়।
জাভা
public class exports {
public ListExportsResponse listExports(Vault client, String matterId) {
return client.matters().exports().list(matterId).execute();
}
পাইথন
def list_exports(service, matter_id):
return service.matters().exports().list(matterId=matter_id).execute()
রপ্তানি সম্পর্কে তথ্য জানুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি নির্দিষ্ট এক্সপোর্ট সম্পর্কে তথ্য পাওয়া যায়। এক্সপোর্ট করা ফাইল এবং মেসেজ ডাউনলোড করতে, আপনি ক্লাউড এপিআই (পরবর্তী উদাহরণে) ব্যবহার করবেন।
জাভা
public Export getExportById(Vault client, String matterId, String exportId) {
return client.matters().exports().get(matterId, exportId).execute();
}
পাইথন
def get_export_by_id(service, matter_id, export_id):
return service.matters().exports().get(
matterId=matter_id, exportId=export_id).execute()
গুগল ক্লাউড থেকে একটি এক্সপোর্ট ডাউনলোড করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে গুগল ক্লাউড থেকে একটি ম্যাটারের সমস্ত সম্পন্ন এক্সপোর্ট ডাউনলোড করতে হয়। এই অনুরোধটি ভল্ট এবং ক্লাউড এপিআই ব্যবহার করে।
কোনো এক্সপোর্ট ডাউনলোড করতে হলে, অ্যাকাউন্টটির 'ম্যানেজ এক্সপোর্টস' প্রিভিলেজ এবং তাদের সাথে শেয়ার করা বিষয়টি থাকা প্রয়োজন।
পাইথন
def download_exports(service, matter_id):
"""Google Cloud storage service is authenticated by running
`gcloud auth application-default login` and expects a billing enabled project
in ENV variable `GOOGLE_CLOUD_PROJECT` """
gcpClient = storage.Client()
matter_id = os.environ['MATTERID']
for export in vaultService.matters().exports().list(
matterId=matter_id).execute()['exports']:
if 'cloudStorageSink' in export:
directory = export['name']
if not os.path.exists(directory):
os.makedirs(directory)
print(export['id'])
for sinkFile in export['cloudStorageSink']['files']:
filename = '%s/%s' % (directory, sinkFile['objectName'].split('/')[-1])
objectURI = 'gs://%s/%s' % (sinkFile['bucketName'],
sinkFile['objectName'])
print('get %s to %s' % (objectURI, filename))
gcpClient.download_blob_to_file(objectURI, open(filename, 'wb+'))
একটি রপ্তানি মুছে ফেলুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি এক্সপোর্ট ডিলিট করতে হয়।
জাভা
public void deleteExportById(Vault client, String matterId, String exportId) {
client.matters().exports().delete(matterId, exportId).execute();
পাইথন
def delete_export_by_id(service, matter_id, export_id):
return service.matters().exports().delete(
matterId=matter_id, exportId=export_id).execute()
অনুসন্ধানের সীমা সহ অনুসন্ধান এবং রপ্তানি সম্পর্কিত অ্যাপ-নির্দিষ্ট তথ্যের জন্য, "Vault অনুসন্ধান এবং রপ্তানি দিয়ে শুরু করুন" দেখুন।