ধারণগুলি পরিচালনা করুন

আইনি বা সংরক্ষণের বাধ্যবাধকতা পূরণের জন্য হোল্ড অনির্দিষ্টকালের জন্য ডেটা সংরক্ষণ করে। সাধারণত, এক বা একাধিক ব্যবহারকারীর উপর হোল্ড আরোপ করা হয়, যাতে কোনো বিষয় সক্রিয় না থাকা পর্যন্ত সেই বিষয়ের সাথে সম্পর্কিত ডেটা মুছে ফেলা না যায়।

যদি কোনো ব্যবহারকারী হোল্ডের অধীনে থাকা ডেটা মুছে ফেলেন, তাহলে ডেটাটি ব্যবহারকারীর দৃষ্টি থেকে অদৃশ্য হয়ে যায়, কিন্তু এটি গুগল ভল্টে সংরক্ষিত থাকে। যতক্ষণ হোল্ডটি কার্যকর থাকে, ততক্ষণ একজন ভল্ট প্রশাসক সেই ডেটা অনুসন্ধান এবং এক্সপোর্ট করতে পারেন।

হোল্ডগুলির নিম্নলিখিত উপাদান রয়েছে:

  • একটি পরিষেবা। যে অ্যাপ্লিকেশনটি সংরক্ষিতব্য ডেটার জন্য দায়ী। পরিষেবাটি মেইল, ড্রাইভ বা গ্রুপে সেট করা যেতে পারে।
  • একটি পরিধি। হোল্ডের আওতাভুক্ত সত্তাগুলো। এই পরিধি এক বা একাধিক ব্যবহারকারী অ্যাকাউন্ট, অথবা একটি সাংগঠনিক ইউনিট (OU)-এর জন্য নির্ধারণ করা যেতে পারে।
  • অতিরিক্ত বিকল্প (ঐচ্ছিক)। সংজ্ঞায়িত পরিসরের মধ্যে ধারণ করার জন্য ডেটাকে সংকুচিত করতে ব্যবহৃত নির্দিষ্ট বিবরণ (অনুসন্ধান কোয়েরি বা কনফিগারেশন বিকল্প)। বিকল্পগুলির মধ্যে রয়েছে:
    • মেইল, গ্রুপ: হোল্ডকে সংকুচিত করার জন্য সার্চ কোয়েরি
    • ড্রাইভ: হোল্ডে শেয়ার্ড ড্রাইভ অন্তর্ভুক্ত করুন

ভল্ট রিসোর্স নিয়ে কাজ করার জন্য, একটি অ্যাকাউন্টের অবশ্যই প্রয়োজনীয় ভল্ট প্রিভিলেজ এবং ম্যাটারটিতে অ্যাক্সেস থাকতে হবে। কোনো ম্যাটার অ্যাক্সেস করার জন্য, অ্যাকাউন্টটিকে অবশ্যই ম্যাটারটি তৈরি করতে হবে, অথবা তাদের সাথে ম্যাটারটি শেয়ার করা থাকতে হবে, কিংবা তাদের 'ভিউ অল ম্যাটারস' প্রিভিলেজ থাকতে হবে। হোল্ড তৈরি করার আগে ম্যাটারটির অস্তিত্ব থাকা আবশ্যক।

একটি সার্চ কোয়েরি ব্যবহার করে নির্দিষ্ট ব্যবহারকারী অ্যাকাউন্টে মেইল ​​হোল্ড তৈরি করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে 'আমার প্রথম মেইল ​​অ্যাকাউন্ট হোল্ড' নামের একটি হোল্ড তৈরি করা হয়:

  • পরিষেবা: মেইল
  • সত্তা: ব্যবহারকারী অ্যাকাউন্ট "user1" এবং "user2"
  • অতিরিক্ত বিকল্প: অনুসন্ধান ক্যোয়ারি 'to:ceo@company.com'

Retrieve user account IDs from the Directory API . The HeldAccount can take an account ID or email. If both are given, the email is used and the account ID is ignored.

জাভা 

HeldMailQuery mailQuery = new HeldMailQuery().setTerms("to:ceo@company.com");
List accounts = 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:ceo@company.com'}
    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-তে ড্রাইভের জন্য হোল্ড তৈরি করুন এবং শেয়ার করা ড্রাইভের কন্টেন্ট অন্তর্ভুক্ত করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে নিম্নলিখিতগুলির জন্য 'My First Drive OU Hold' নামের একটি হোল্ড তৈরি করা হয়:

  • পরিষেবা: ড্রাইভ
  • সত্তা: সাংগঠনিক ইউনিট "অর্থায়ন" (OU ID orgUnitId-তে ধারণ করা হয়েছে)
  • অতিরিক্ত বিকল্প: এই সাংগঠনিক ইউনিটের ব্যবহারকারীরা যে শেয়ার্ড ড্রাইভগুলির সদস্য, সেগুলি অন্তর্ভুক্ত করুন।

ডিরেক্টরি এপিআই থেকে সাংগঠনিক ইউনিট আইডিগুলো পুনরুদ্ধার করুন।

জাভা 

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()

একটি নির্দিষ্ট তারিখের পরিসর সহ নির্দিষ্ট গ্রুপ অ্যাকাউন্টগুলিতে গ্রুপগুলির জন্য একটি হোল্ড তৈরি করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে নিম্নলিখিতগুলির জন্য 'My First Group Hold' নামের একটি হোল্ড তৈরি করা হয়:

  • পরিষেবা: গোষ্ঠী
  • সত্তা: গ্রুপ অ্যাকাউন্ট 'group1' এবং 'group2'
  • অতিরিক্ত বিকল্প: শুধুমাত্র 'startTime' এবং 'endTime'-এর মধ্যে পাঠানো তারিখ সহ বার্তাগুলি আটকে রাখুন।

ডিরেক্টরি এপিআই থেকে গ্রুপ অ্যাকাউন্ট আইডিগুলো পুনরুদ্ধার করুন।

জাভা 

String APRIL_2_2017_GMT = "2017-04-02T00:00:00Z"; // See below for format*.
 
List accounts = 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()

বিদ্যমান হোল্ডগুলি অনুসন্ধান ও পরিবর্তন করুন

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি হোল্ডের অন্তর্ভুক্ত সমস্ত অ্যাকাউন্ট তালিকাভুক্ত করতে হয়।

জাভা 

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@email.com";
// 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()

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি বিদ্যমান হোল্ডে সাংগঠনিক ইউনিট পরিবর্তন করতে হয়।

জাভা 

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()