Эта страница переведена с помощью Cloud Translation API.

Управление экспортом

API Google Vault позволяет управлять экспортом данных из Google Vault. Вы можете выполнять следующие задачи:

Создавайте экспорты. Отправьте запрос в Vault, чтобы найти сообщения или файлы, соответствующие вашему запросу, и экспортировать их в Google Cloud.
В рамках вашей организации одновременно может выполняться до 20 экспортов. Для ускорения экспорта разделите большие объемы на более мелкие. Например, экспортируйте данные по месяцам, а не все сразу. Другой вариант — включать в каждый экспорт меньшее количество элементов, таких как пользователи, группы или чаты. Экспорты доступны в течение 15 дней после создания. По истечении этого времени они удаляются и становятся недоступными.
Следующие примеры показывают, как создавать экспорты для различных сервисов:
Список экспортных операций . Получение статуса всех экспортных операций, связанных с данным вопросом.
Получить информацию об экспорте . Получить сведения об экспорте.
Загрузка экспортированных файлов . Загрузите экспортированный файл из Google Cloud.
Удаление экспортированных данных . Удаляйте экспортированные данные из дела, когда они больше не нужны.

Прежде чем начать

Для настройки необходимых библиотек и аутентификации следуйте инструкциям по быстрому запуску для вашего языка программирования.

Для работы с ресурсами Vault учетная запись должна обладать необходимыми привилегиями Vault и доступом к делу. Для доступа к делу учетная запись должна создать это дело, предоставить к нему общий доступ или иметь привилегию «Просмотр всех дел» .

Создать экспорт в Gmail

В следующем примере показано, как создать запрос на экспорт из Gmail. Этот запрос экспортирует все сообщения Gmail и классического Hangouts, соответствующие следующим критериям:

Сообщения, принадлежащие учетным записям email1 и email2 .
Исключаются черновики сообщений.
Сообщения отправляются на ceo@solarmora.com .

В этих примерах используется классическая система экспорта Gmail. Для экспорта с использованием новой системы экспорта в параметре MailExportOptions установите useNewExport равным true.

Java

public Export createMailAccountHeldDataExports(Vault client, String matterId) {
  AccountInfo emailsToSearch = new AccountInfo().setEmails(ImmutableList.of("email1", "email2"));
  MailOptions mailQueryOptions = new MailOptions().setExportFormat("PST");
  String queryTerms = "to:ceo@solarmora.com";
  Query mailQuery =
      new Query()
          .setCorpus("MAIL")
          .setDataScope("HELD_DATA")
          .setSearchMethod("ACCOUNT")
          .setAccountInfo(emailsToSearch)
          .setTerms(queryTerms)
          .setMailOptions(mailQueryOptions);
  MailExportOptions mailExportOptions =
      new MailExportOptions()
          .setExportFormat("MBOX")
          .showConfidentialModeContent(true);
  Export wantedExport =
      new Export()
          .setMatterId(matterId)
          .setName("My first mail accounts export")
          .setQuery(mailQuery)
          .setExportOptions(new ExportOptions().setMailOptions(mailExportOptions));
  return client.matters().exports().create(matter, wantedExport).execute();
}

Python

def create_mail_account_held_data_export(service, matter_id):
  emails_to_search = ['email1', 'email2']
  mail_query_options = {'excludeDrafts': True}
  query_terms = 'to:ceo@solarmora.com'
  mail_query = {
      'corpus': 'MAIL',
      'dataScope': 'HELD_DATA',
      'searchMethod': 'ACCOUNT',
      'accountInfo': {
          'emails': emails_to_search
      },
      'terms': query_terms,
      'mailOptions': mail_query_options,
  }
  mail_export_options = {
      'exportFormat': 'MBOX',
      'showConfidentialModeContent': True
      }
  wanted_export = {
      'name': 'My first mail accounts export',
      'query': mail_query,
      'exportOptions': {
          'mailOptions': mail_export_options
  }
}
return service.matters().exports().create(
  matterId=matter_id, body=wanted_export).execute()

При экспорте в Gmail формат MBOX обрабатывается быстрее, чем формат PST .

Создать экспорт в Google Диск

В следующем примере показано, как создать запрос на экспорт в Google Диск. Этот запрос экспортирует все файлы, включая файлы на общих дисках, которые соответствуют следующим критериям:

Принадлежит к указанному организационному подразделению (получено с помощью Admin SDK).
Были созданы в указанный период времени .

Java

public Export createDriveOuAllDataExport(Vault client, String matterId) {
  OrgUnitInfo ouToSearch = new OrgUnitInfo().setOrgUnitId("ou id retrieved from admin sdk");
  DriveOptions driveQueryOptions = new DriveOptions().setIncludeSharedDrives(true);
  Query driveQuery =
      new Query()
          .setCorpus("DRIVE")
          .setDataScope("ALL_DATA")
          .setSearchMethod("ORG_UNIT")
          .setOrgUnitInfo(ouToSearch)
          .setDriveOptions(driveQueryOptions)
          .setStartTime("2017-03-16T00:00:00Z")
          .setEndTime("2017-03-16T00:00:00Z")
          .setTimeZone("Etc/GMT+2");
  DriveExportOptions driveExportOptions = new DriveExportOptions().setIncludeAccessInfo(false);
  Export wantedExport =
      new Export()
          .setName("My first drive ou export")
          .setQuery(driveQuery)
          .setExportOptions(new ExportOptions().setDriveOptions(driveExportOptions));
  return client.matters().exports().create(matter, wantedExport).execute();
}

Python

def create_drive_ou_all_data_export(service, matter_id):
  ou_to_search = 'ou id retrieved from admin sdk'
  drive_query_options = {'includeSharedDrives': True}
  drive_query = {
    'corpus': 'DRIVE',
    'dataScope': 'ALL_DATA',
    'searchMethod': 'ORG_UNIT',
    'orgUnitInfo': {
        'org_unit_id': ou_to_search
    },
    'driveOptions': drive_query_options,
    'startTime': '2017-03-16T00:00:00Z',
    'endTime': '2017-09-23T00:00:00Z',
    'timeZone': 'Etc/GMT+2'
  }
  drive_export_options = {'includeAccessInfo': False}
  wanted_export = {
    'name': 'My first drive ou export',
    'query': drive_query,
    'exportOptions': {
        'driveOptions': drive_export_options
    }
  }
return service.matters().exports().create(
  matterId=matter_id, body=wanted_export).execute()

Создать экспорт Meet

В следующем примере показано, как создать запрос на экспорт данных из Meet. Этот запрос экспортирует файлы, связанные с учетными записями в указанном организационном подразделении, имена файлов которых соответствуют шаблону для записей Meet.

Python

def create_meet_export(service, matter_id, ou_to_search, export_name):
  export = {
    'name': export_name,
    'query': {
        'corpus': 'DRIVE',
        'dataScope': 'ALL_DATA',
        'searchMethod': 'ORG_UNIT',
        'terms': 'title:"...-...-... \\(....-..-.. at ..:.. *\\)"',
        'orgUnitInfo': {
            'orgUnitId': 'id:'+ou_to_search
        },
        'driveOptions': {
            'includeTeamDrives': True,
            'includeSharedDrives': True
        },
        'timeZone': 'Etc/GMT',
        'method': 'ORG_UNIT'
    },
    'exportOptions': {
        'driveOptions': {},
        'region': 'ANY'
    },
  }

  return service.matters().exports().create(
    matterId=matter_id, body=export).execute()

Экспорт из сохраненного запроса

В следующем примере показано, как создать экспорт из сохраненного запроса.

Python

def create_mail_export_from_saved_query(service, matter_id, saved_query_id, export_name):
  export = {
    'name': export_name,
    'exportOptions': {
      'mailOptions': {
        'exportFormat': 'PST',
        'showConfidentialModeContent': True
      },
    'region': 'ANY'
    }
  }

  export['query'] = service.matters().savedQueries().get(
    savedQueryId=saved_query_id, matterId=matter_id).execute()['query']
  return service.matters().exports().create(
    matterId=matter_id, body=export).execute()

Список экспортируемых товаров

В следующем примере показано, как получить список экспортируемых документов, связанных с делом.

Java

public class exports {
  public ListExportsResponse listExports(Vault client, String matterId) {
    return client.matters().exports().list(matterId).execute();
}

Python

def list_exports(service, matter_id):
 return service.matters().exports().list(matterId=matter_id).execute()

Получите информацию об экспорте.

В следующем примере показано, как получить информацию о конкретном экспорте. Для загрузки экспортированных файлов и сообщений используются API облачных сервисов (в следующем примере).

Java

public Export getExportById(Vault client, String matterId, String exportId) {
  return client.matters().exports().get(matterId, exportId).execute();
}

Python

def get_export_by_id(service, matter_id, export_id):
  return service.matters().exports().get(
    matterId=matter_id, exportId=export_id).execute()

Загрузите экспорт из Google Cloud.

В следующем примере показано, как загрузить все завершенные экспорты по делу из Google Cloud. Этот запрос использует API Vault и Cloud.

Для загрузки экспортированного файла пользователю необходимы права доступа «Управление экспортом» и предоставленный ему доступ к содержимому файла.

Python

def download_exports(service, matter_id):
"""Google Cloud storage service is authenticated by running
`gcloud auth application-default login` and expects a billing enabled project
in ENV variable `GOOGLE_CLOUD_PROJECT` """
gcpClient = storage.Client()
matter_id = os.environ['MATTERID']
  for export in vaultService.matters().exports().list(
      matterId=matter_id).execute()['exports']:
    if 'cloudStorageSink' in export:
      directory = export['name']
      if not os.path.exists(directory):
        os.makedirs(directory)
      print(export['id'])
      for sinkFile in export['cloudStorageSink']['files']:
        filename = '%s/%s' % (directory, sinkFile['objectName'].split('/')[-1])
        objectURI = 'gs://%s/%s' % (sinkFile['bucketName'],
                                    sinkFile['objectName'])
        print('get %s to %s' % (objectURI, filename))
        gcpClient.download_blob_to_file(objectURI, open(filename, 'wb+'))

Удалить экспорт

В следующем примере показано, как удалить экспорт.

Java

public void deleteExportById(Vault client, String matterId, String exportId) {
   client.matters().exports().delete(matterId, exportId).execute();

Python

def delete_export_by_id(service, matter_id, export_id):
  return service.matters().exports().delete(
    matterId=matter_id, exportId=export_id).execute()

Для получения информации о поиске и экспорте, включая ограничения поиска, см. раздел «Начало работы с поиском и экспортом Vault» .

Управление экспортом Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Прежде чем начать

Создать экспорт в Gmail

Java

Python

Создать экспорт в Google Диск

Java

Python

Создать экспорт Meet

Python

Экспорт из сохраненного запроса

Python

Список экспортируемых товаров

Java

Python

Получите информацию об экспорте.

Java

Python

Загрузите экспорт из Google Cloud.

Python

Удалить экспорт

Java

Python

Управление экспортом