সংরক্ষিত প্রশ্নগুলি পরিচালনা করুন

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

দ্রষ্টব্য: একটি সংরক্ষিত কোয়েরি কোয়েরি দ্বারা তৈরি বার্তা এবং ফাইলগুলি সংরক্ষণ করে না; এটি কেবল অনুসন্ধান পরামিতিগুলি সংরক্ষণ করে। বার্তা এবং ফাইলগুলিকে তাদের বর্তমান অবস্থায় সংরক্ষণ করতে আপনাকে অনুসন্ধান ফলাফল রপ্তানি করতে হবে।

আপনি এই API টি স্ক্রিপ্টগুলিতে ব্যবহার করতে পারেন যা:

• কোনও বিষয়ে একটি সংরক্ষিত প্রশ্ন তৈরি করুন
• কোনও বিষয় থেকে সংরক্ষিত প্রশ্ন মুছে ফেলুন
• কোনও বিষয় থেকে সংরক্ষিত প্রশ্ন উদ্ধার করুন
• কোনও বিষয় থেকে সমস্ত সংরক্ষিত প্রশ্ন পুনরুদ্ধার করুন

ভল্ট রিসোর্সগুলির সাথে কাজ করার জন্য, অ্যাকাউন্টটির অবশ্যই প্রয়োজনীয় ভল্ট সুবিধা এবং বিষয়টিতে অ্যাক্সেস থাকতে হবে। কোনও বিষয়টি অ্যাক্সেস করার জন্য, অ্যাকাউন্টটি অবশ্যই বিষয়টি তৈরি করেছে, বিষয়টি তাদের সাথে ভাগ করে নিয়েছে, অথবা View All Matters সুবিধা থাকতে হবে।

একটি সংরক্ষিত অনুসন্ধান কোয়েরি তৈরি করুন

নিম্নলিখিত উদাহরণগুলি দেখায় যে কীভাবে মেল বার্তা এবং ড্রাইভে ফাইলগুলির জন্য সংরক্ষিত কোয়েরি তৈরি করতে হয়:

মেইল

জাভা

public SavedQuery createMailAllDataAccountSavedQuery(String matterId) throws Exception {
    AccountInfo emailsToSearch =
        new AccountInfo().setEmails((ImmutableList.of("email1", "email2")));
    MailOptions mailOptions = new MailOptions().setExcludeDrafts(true);
    String queryTerms = "to:[e-mail]";
    Query mailQuery =
        new Query()
            .setCorpus("MAIL")
            .setDataScope("ALL_DATA")
            .setSearchMethod("ACCOUNT")
            .setAccountInfo(emailsToSearch)
            .setTerms(queryTerms)
            .setMailOptions(mailOptions);
    SavedQuery savedQuery =
        new SavedQuery()
            .setDisplayName("NEW SAVED QUERY NAME")
            .setQuery(mailQuery);
    return client.matters().savedQueries().create(matterId, savedQuery).execute();
} 

পাইথন

def create_mail_all_data_account_saved_query(self, matter_id):
    emails_to_search = ['email1', 'email2']
    mail_query_options = {'excludeDrafts': True}
    query_terms = 'to:[e-mail]'
    mail_query = {
        'corpus': 'MAIL',
        'dataScope': 'ALL_DATA',
        'searchMethod': 'ACCOUNT',
        'accountInfo': {
            'emails': emails_to_search
        },
        'terms': query_terms,
        'mailOptions': mail_query_options,
    }
    saved_query = {
        'displayName': 'NEW SAVED QUERY NAME',
        'query': mail_query,
    }
    return self.service.matters().savedQueries().create(
        matterId=matter_id, body=saved_query).execute()

ড্রাইভ

জাভা

public SavedQuery createDriveAllDataOUSavedQuery(String matterId) throws Exception {
    OrgUnitInfo ouToSearch = new OrgUnitInfo().setOrgUnitId("ou id retrieved from admin sdk");
    DriveOptions driveQueryOptions = new DriveOptions().setIncludeTeamDrives(true);
    Query driveQuery =
        new Query()
            .setCorpus("DRIVE")
            .setDataScope("ALL_DATA")
            .setSearchMethod("ORG_UNIT")
            .setOrgUnitInfo(ouToSearch)
            .setDriveOptions(driveQueryOptions);
    SavedQuery savedQuery =
        new SavedQuery()
            .setDisplayName("NEW SAVED QUERY NAME")
            .setQuery(driveQuery);
    return client.matters().savedQueries().create(matterId, savedQuery).execute();
  }
} 

পাইথন

def create_drive_all_data_ou_saved_query(self, matter_id):
    ou_to_search = 'ou id retrieved from admin sdk'
    drive_query_options = {'includeTeamDrives': True}
    drive_query = {
        'corpus': 'DRIVE',
        'dataScope': 'ALL_DATA',
        'searchMethod': 'ORG_UNIT',
        'orgUnitInfo': {
            'org_unit_id': ou_to_search,
        },
        'driveOptions': drive_query_options
    }
    saved_query = {
        'displayName': 'NEW SAVED QUERY NAME',
        'query': drive_query,
    }
    return self.service.matters().savedQueries().create(
        matterId=matter_id, body=saved_query).execute()

একটি সংরক্ষিত অনুসন্ধান কোয়েরি মুছুন

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

জাভা

public Empty deleteSavedQuery(String matterId, String savedQueryId) throws Exception {
    return client.matters().savedQueries().delete(matterId, savedQueryId).execute();
} 

পাইথন

def delete_saved_query(self, matter_id, saved_query_id):
    empty_response = self.service.matters().savedQueries().delete(
        matterId=matter_id, savedQueryId=saved_query_id).execute()
    return empty_response

একটি সংরক্ষিত অনুসন্ধান কোয়েরি পান

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

জাভা

public SavedQuery getSavedQuery(String matterId, String savedQueryId) throws Exception {
    return client.matters().savedQueries().get(matterId, savedQueryId).execute();
} 

পাইথন

def get_saved_query(self, matter_id, saved_query_id):
    saved_query = self.service.matters().savedQueries().get(
        matterId=matter_id, savedQueryId=saved_query_id).execute()
    return saved_query

কোনও বিষয়ে সংরক্ষিত প্রশ্নের তালিকা তৈরি করুন

নিচের উদাহরণটি দেখায় কিভাবে একটি বিষয়ের সংরক্ষিত প্রশ্নগুলি তালিকাভুক্ত করতে হয়।

জাভা

public void listSavedQueries(String matterId) throws Exception {
    ListSavedQueriesResponse firstPageResponse =
        client.matters().savedQueries().list(matterId).setPageSize(10).execute();
    String nextPageToken = firstPageResponse.getNextPageToken();
    if (nextPageToken != null) {
      client
          .matters()
          .savedQueries()
          .list(matterId)
          .setPageSize(10)
          .setPageToken(nextPageToken)
          .execute();
    }
} 

পাইথন

def list_saved_queries(self, matter_id):
    first_page_response = self.service.matters().savedQueries().list(
        matterId=matter_id, pageSize=10).execute()
    if 'nextPageToken' in first_page_response:
      self.service.matters().savedQueries().list(
          pageSize=10,
          pageToken=first_page_response['nextPageToken']).execute()