सेव की गई क्वेरी मैनेज करें

सेव की गई क्वेरी एपीआई की मदद से, Vault में सेव की गई क्वेरी को प्रोग्राम के हिसाब से मैनेज किया जा सकता है. सेव की गई क्वेरी को चलाकर, उसी तरह के नतीजे या क्वेरी की शर्तों के हिसाब से नए नतीजे पाए जा सकते हैं. उदाहरण के लिए, अगर आपकी क्वेरी में खत्म होने की तारीख शामिल है, तो आपको वही नतीजे मिलेंगे जो पहली बार क्वेरी चलाने पर मिले थे. अगर क्वेरी में खत्म होने की तारीख शामिल नहीं है, तो आपको अपने मूल नतीजे के साथ-साथ, खोज की शर्तों को पूरा करने वाला नया डेटा भी मिलेगा.

ध्यान दें: सेव की गई क्वेरी, क्वेरी से जनरेट हुए मैसेज और फ़ाइलों को सेव नहीं करती. यह सिर्फ़ खोज पैरामीटर सेव करती है. मैसेज और फ़ाइलों को उनकी मौजूदा स्थिति में बनाए रखने के लिए, आपको खोज के नतीजों को एक्सपोर्ट करना होगा.

इस एपीआई का इस्तेमाल उन स्क्रिप्ट में किया जा सकता है जो:

• किसी मामले में सेव की गई क्वेरी बनाना
• किसी मामले से सेव की गई क्वेरी मिटाना
• किसी मामले से सेव की गई क्वेरी को वापस पाना
• किसी मामले से सेव की गई सभी क्वेरी वापस पाना

Vault के संसाधनों का इस्तेमाल करने के लिए, आपके खाते के पास Vault के ज़रूरी ऐक्सेस और मामले का ऐक्सेस होना चाहिए. किसी मामले को ऐक्सेस करने के लिए, ज़रूरी है कि खाते ने वह मामला बनाया हो, उसने वह मामला शेयर किया हो या उसके पास सभी मामले देखें की अनुमति हो.

सेव की गई खोज क्वेरी बनाना

यहां दिए गए उदाहरणों में, मेल मैसेज और Drive में मौजूद फ़ाइलों के लिए, सेव की गई क्वेरी बनाने का तरीका बताया गया है:

Mail

JavaPython

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

Drive

JavaPython

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

सेव की गई खोज क्वेरी मिटाना

यहां दिए गए उदाहरण में, सेव की गई क्वेरी को मिटाने का तरीका बताया गया है.

JavaPython

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

सेव की गई खोज क्वेरी पाना

यहां दिए गए उदाहरण में, सेव की गई क्वेरी को उसके आईडी से वापस पाने का तरीका बताया गया है.

JavaPython

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

किसी मामले में सेव की गई क्वेरी की सूची देखना

यहां दिए गए उदाहरण में, किसी मामले की सेव की गई क्वेरी की सूची बनाने का तरीका बताया गया है.

JavaPython

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