আইনি বা সংরক্ষণের বাধ্যবাধকতা পূরণের জন্য অনির্দিষ্টকালের জন্য ডেটা সংরক্ষণ করে। সাধারণত এক বা একাধিক ব্যবহারকারীর উপর ধারণ করা হয় যাতে নিশ্চিত করা হয় যে কোনো বিষয়ের সাথে সম্ভাব্য প্রাসঙ্গিক ডেটা মুছে ফেলা যাবে না যতক্ষণ না সেই বিষয়টি আর সক্রিয় না হয়।
হোল্ডের সাপেক্ষে একজন ব্যবহারকারী ধারণকৃত ডেটা মুছে ফেললে, সেই ডেটা ব্যবহারকারীর ভিউ থেকে সরিয়ে দেওয়া হয়, কিন্তু সেটি ভল্টে সংরক্ষিত থাকে। যতক্ষণ পর্যন্ত হোল্ড থাকে, একজন ভল্ট অ্যাডমিন সেই ডেটা অনুসন্ধান এবং রপ্তানি করতে পারেন।
হোল্ডের নিম্নলিখিত উপাদান রয়েছে:
- একটি পরিষেবা- যেটি ডেটা রাখা হবে তার জন্য দায়ী অ্যাপ্লিকেশন। পরিষেবাটি মেল, ড্রাইভ বা গ্রুপগুলিতে সেট করা যেতে পারে৷
- একটি সুযোগ- হোল্ড দ্বারা আচ্ছাদিত সত্তা। সুযোগ এক বা একাধিক ব্যবহারকারীর অ্যাকাউন্টে বা একটি সাংগঠনিক ইউনিটে (OU) সেট করা যেতে পারে।
- অতিরিক্ত বিকল্প (ঐচ্ছিক)— নির্দিষ্ট বিশদ বিবরণ (অনুসন্ধান প্রশ্ন বা কনফিগারেশন বিকল্প) সংজ্ঞায়িত সুযোগের মধ্যে রাখা ডেটা সংকীর্ণ করতে ব্যবহৃত হয়। বিকল্প অন্তর্ভুক্ত:
- মেল, গ্রুপ: হোল্ড সংকীর্ণ করতে অনুসন্ধান ক্যোয়ারী
- ড্রাইভ: হোল্ডে শেয়ার্ড ড্রাইভ অন্তর্ভুক্ত করুন
ভল্ট সংস্থানগুলির সাথে কাজ করার জন্য, অ্যাকাউন্টে প্রয়োজনীয় ভল্ট সুবিধা এবং বিষয়টিতে অ্যাক্সেস থাকতে হবে। একটি বিষয় অ্যাক্সেস করার জন্য, অ্যাকাউন্টটি অবশ্যই বিষয়টি তৈরি করেছে, বিষয়টি তাদের সাথে ভাগ করে নিতে হবে বা সমস্ত বিষয় দেখার বিশেষাধিকার থাকতে হবে।
একটি অনুসন্ধান ক্যোয়ারী সহ নির্দিষ্ট ব্যবহারকারী অ্যাকাউন্টে মেলের জন্য একটি হোল্ড তৈরি করুন৷
নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে "মাই ফার্স্ট মেল অ্যাকাউন্ট হোল্ড" নামে একটি হোল্ড তৈরি করা হয়:
- পরিষেবা: মেইল
- সত্তা: ব্যবহারকারীর অ্যাকাউন্ট "user1" এবং "user2"
- অতিরিক্ত বিকল্প: অনুসন্ধান ক্যোয়ারী "to:[email protected]"
AdminSdk থেকে ব্যবহারকারীর অ্যাকাউন্ট আইডি পুনরুদ্ধার করুন। মনে রাখবেন যে HeldAccount অ্যাকাউন্ট আইডি বা ইমেল নিতে পারে। যদি উভয়ই দেওয়া হয়, ইমেল ব্যবহার করা হয় এবং অ্যাকাউন্ট আইডি উপেক্ষা করা হয়।
জাভা
HeldMailQuery mailQuery = new HeldMailQuery().setTerms("to:[email protected]"); Listaccounts = Lists.newArrayList(); accounts.add(new HeldAccount().setAccountId(user1accountId)); accounts.add(new HeldAccount().setEmail(user2Email)); Hold hold = new Hold() .setName("My First mail Accounts Hold") .setCorpus("MAIL"); .setQuery(new CorpusQuery().setMailQuery(mailQuery)) .setAccounts(accounts); Hold createdHold = client.matters().holds().create(matterId, hold).execute();
পাইথন
def create_hold_mail_accounts(service, matter_id, account_id): mail_query = {'terms': 'to:[email protected]'} accounts = [ {'accountId': user1_account_id}, {'email': user2_email} ] wanted_hold = { 'name': 'My First mail Accounts Hold', 'corpus': 'MAIL', 'query': { 'mailQuery': mail_query }, 'accounts': accounts } return service.matters().holds().create( matterId=matter_id, body=wanted_hold).execute()
একটি OU-তে ড্রাইভের জন্য একটি হোল্ড তৈরি করুন এবং শেয়ার্ড ড্রাইভ সামগ্রী অন্তর্ভুক্ত করুন
নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে "মাই ফার্স্ট ড্রাইভ ওউ হোল্ড" নামে একটি হোল্ড তৈরি করা হয়েছে:
- পরিষেবা: ড্রাইভ
- সত্তা: অর্গ ইউনিট "ফাইনান্স" (OU আইডি orgUnitId-এ ক্যাপচার করা হয়েছে)
- অতিরিক্ত বিকল্প: শেয়ার্ড ড্রাইভগুলি অন্তর্ভুক্ত করুন যেগুলি এই অর্গ ইউনিটের ব্যবহারকারীরা সদস্য৷
AdminSdk থেকে OU আইডি পুনরুদ্ধার করুন।
জাভা
HeldOrgUnit orgUnit = new HeldOrgUnit().setOrgUnitId(orgUnitId); // Include shared drives content. HeldDriveQuery driveQuery = new HeldDriveQuery().setIncludeSharedDriveFiles(true); // Create the hold. Hold hold = new Hold() .setName("My First Drive OU Hold") .setCorpus("DRIVE") .setQuery(new CorpusQuery().setDriveQuery(driveQuery)) .setOrgUnit(orgUnit); Hold createdHold = client.matters().holds().create(matterId, hold).execute(); return createdHold;
পাইথন
def create_hold_drive_org(service, matter_id, org_unit_id): drive_query = {'includeSharedDriveFiles': True} org_unit = {'orgUnitId': org_unit_id} wanted_hold = { 'name': 'My First Drive OU Hold', 'corpus': 'DRIVE', 'orgUnit': org_unit, 'query': { 'driveQuery': drive_query } } return service.matters().holds().create( matterId=matter_id, body=wanted_hold).execute()
নির্দিষ্ট গ্রুপ অ্যাকাউন্টে একটি তারিখ পরিসীমা সহ গ্রুপগুলির জন্য একটি হোল্ড তৈরি করুন
নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে "মাই ফার্স্ট গ্রুপ হোল্ড" নামে একটি হোল্ড তৈরি করা হয়েছে:
- পরিষেবা: গ্রুপ
- সত্তা: গ্রুপ অ্যাকাউন্ট "গ্রুপ 1" এবং "গ্রুপ 2"
- অতিরিক্ত বিকল্প: শুধুমাত্র "স্টার্টটাইম" এবং "এন্ডটাইম" এর মধ্যে পাঠানো তারিখ সহ বার্তাগুলি ধরে রাখুন
AdminSdk থেকে গ্রুপ অ্যাকাউন্ট আইডি পুনরুদ্ধার করুন।
জাভা
String APRIL_2_2017_GMT = "2017-04-02T00:00:00Z"; // See below for format*. Listaccounts = Lists.newArrayList(); accounts.add(new HeldAccount().setAccountId(accountId)); accounts.add(new HeldAccount().setAccountId(accountId2)); HeldGroupsQuery groupQuery = new HeldGroupsQuery(); // Restrict by sent date. groupQuery.setStartTime(APRIL_2_2017_GMT); groupQuery.setEndTime(APRIL_2_2017_GMT); // create the hold Hold hold = new Hold() .setName("My First Group Hold") .setCorpus("GROUPS") .setQuery(new CorpusQuery().setGroupsQuery(groupQuery)); hold.setAccounts(accounts); Hold createdHold = client.matters().holds().create(matterId, hold).execute();
পাইথন
def create_hold_groups_date_range(service, matter_id, group_account_id): groups_query = { 'startTime': '2017-04-02T00:00:00Z', # See below for format* 'endTime': '2017-04-02T00:00:00Z' } accounts = [{'accountId': group_account_id}] wanted_hold = { 'name': 'My First Group Hold', 'corpus': 'GROUPS', 'query': { 'groupsQuery': groups_query }, 'accounts': accounts } return service.matters().holds().create( matterId=matter_id, body=wanted_hold).execute()
- টাইমস্ট্যাম্প বিন্যাস । উপরন্তু, স্টার্ট/এন্ডটাইমসকে GMT-এ রূপান্তরিত করা হয় এবং প্রদত্ত তারিখের শুরুতে রাউন্ড ডাউন করা হয়।
ক্যোয়ারী এবং বিদ্যমান হোল্ড পরিবর্তন
নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি বিদ্যমান হোল্ডে অন্তর্ভুক্ত সমস্ত অ্যাকাউন্ট তালিকাভুক্ত করতে হয়:
জাভা
client.matters().holds().accounts().list(matterId, holdId).execute().getAccounts();
পাইথন
# If no accounts are on hold, ['accounts'] will raise an error.
def list_held_accounts(service, matter_id, hold_id):
return service.matters().holds().accounts().list(
matterId=matter_id, holdId=hold_id).execute()['accounts']
নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি অ্যাকাউন্ট যোগ করতে হয় এবং একটি বিদ্যমান হোল্ড থেকে একটি অ্যাকাউন্ট সরাতে হয়:
জাভা
// Add an account by id. client .matters() .holds() .accounts() .create(matterId, holdId, new HeldAccount().setAccountId(accountId)) .execute(); // Remove an account by id. client.matters().holds().accounts().delete(matterId, holdId, accountId).execute(); String email = "[email protected]"; // Add an account by email. client .matters() .holds() .accounts() .create(matterId, holdId, new HeldAccount().setEmail(email)) .execute();
পাইথন
def add_held_account(service, matter_id, hold_id, account_id): held_account = {'accountId': account_id} return service.matters().holds().accounts().create( matterId=matter_id, holdId=hold_id, body=held_account).execute() def remove_held_account(service, matter_id, hold_id, account_id): return service.matters().holds().accounts().delete( matterId=matter_id, holdId=hold_id, accountId=account_id).execute() def add_held_account(service, matter_id, hold_id, email): held_account = {'email': email} return service.matters().holds().accounts().create( matterId=matter_id, holdId=hold_id, body=held_account).execute()
নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে বিদ্যমান OU হোল্ডে OU পরিবর্তন করতে হয়:
জাভা
Hold hold = client.matters().holds().get(matterId, holdId).execute(); hold.getOrgUnit().setOrgUnitId(newOrgUnitId); Hold modifiedHold = client.matters().holds().update(matterId, holdId, hold).execute(); return modifiedHold;
পাইথন
def update_hold_ou(service, matter_id, hold_id, org_unit_id): current_hold = get_hold(matter_id, hold_id) current_hold['orgUnit'] = {'orgUnitId': org_unit_id} return service.matters().holds().update( matterId=matter_id, holdId=hold_id, body=current_hold).execute()
নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি বিষয়ের জন্য সমস্ত হোল্ড তালিকাভুক্ত করা যায়:
জাভা
String matterId = "Matter Id";// List all holds. List
holdsList = client.matters().holds().list(matterId).execute().getHolds(); // Paginate on holds. ListHoldsResponse response = client .matters() .holds() .list(matterId) .setPageSize(10) .execute();
String nextPageToken = response.getNextPageToken(); if (nextPageToken != null) { client .matters() .holds() .list(matterId) .setPageSize(10) .setPageToken(nextPageToken) .execute(); }
পাইথন
# This can paginate in the same manner as with matters.
def list_holds(service, matter_id):
return service.matters().holds().list(matterId=matter_id).execute()