저장된 쿼리 관리

저장된 쿼리 API를 사용하면 Google Vault에서 저장된 쿼리를 프로그래매틱 방식으로 관리할 수 있습니다. 저장된 쿼리를 실행하여 쿼리 기준에 따라 동일한 결과 또는 추가적인 최신 결과를 가져올 수 있습니다. 예를 들어 쿼리에 종료 날짜가 포함된 경우 처음 쿼리를 실행했을 때와 동일한 결과를 가져옵니다. 쿼리에 종료 날짜가 포함되지 않은 경우 원래 결과와 함께 검색 기준을 충족하는 모든 새 데이터가 반환됩니다.

저장된 쿼리는 쿼리에서 생성된 메일 및 파일을 보존하지 않고 검색 매개변수만 저장합니다. 현재 상태의 메일 및 파일을 보존하려면 검색 결과를 내보내야 합니다.

다음 작업을 실행하는 스크립트에서 이 API를 사용할 수 있습니다.

  • 법적 사안에서 저장된 쿼리를 만듭니다.
  • 법적 사안에서 저장된 쿼리를 삭제합니다.
  • 법적 사안에서 저장된 쿼리를 가져옵니다.
  • 법적 사안에서 저장된 쿼리를 모두 가져옵니다.

Vault 리소스를 사용하려면 계정에 필요한 Vault 권한 이 있고 법적 사안에 액세스할 수 있어야 합니다. 법적 사안에 액세스하려면 계정에서 법적 사안을 만들었거나 법적 사안이 공유되었거나 모든 법적 사안 보기 권한이 있어야 합니다.

저장된 검색 쿼리 만들기

다음 예에서는 메일 메시지 및 Google Drive의 파일에 대해 저장된 쿼리를 만드는 방법을 보여줍니다.

메일

자바

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:ceo@solarmora.com";
    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();
}

Python

def create_mail_all_data_account_saved_query(self, matter_id):
    emails_to_search = ['email1', 'email2']
    mail_query_options = {'excludeDrafts': True}
    query_terms = 'to:ceo@solarmora.com'
    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();
  }
}

Python

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

Python

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

저장된 검색 쿼리 가져오기

다음 예에서는 ID로 저장된 쿼리를 가져오는 방법을 보여줍니다.

자바

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

Python

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

Python

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