REST Resource: matters.exports

Recurso: Export

Una exportación

Para trabajar con recursos de Vault, la cuenta debe tener los privilegios de Vault necesarios y acceso al asunto. Para acceder a un asunto, la cuenta debe haberlo creado, tenerlo compartido o tener el privilegio Ver todos los asuntos.

Representación JSON
{
  "id": string,
  "matterId": string,
  "parentExportId": string,
  "name": string,
  "requester": {
    object (UserInfo)
  },
  "query": {
    object (Query)
  },
  "exportOptions": {
    object (ExportOptions)
  },
  "createTime": string,
  "status": enum (ExportStatus),
  "stats": {
    object (ExportStats)
  },

  "cloudStorageSink": {
    object (CloudStorageSink)
  }
}
Campos
id

string

Solo salida. Es el ID de exportación generado.

matterId

string

Solo salida. Es el ID del asunto.

parentExportId

string

Solo salida. Identifica la exportación superior que generó esta exportación secundaria. Esto solo se establece en las exportaciones secundarias.

name

string

Es el nombre de la exportación. No uses caracteres especiales (~!$'(),;@:/?) en el nombre, ya que pueden impedir que descargues las exportaciones.

requester

object (UserInfo)

Solo salida. Es el solicitante de la exportación.

query

object (Query)

Son los parámetros de consulta que se usan para crear la exportación.

exportOptions

object (ExportOptions)

Opciones de exportación adicionales

createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó la exportación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

status

enum (ExportStatus)

Solo salida. Es el estado de la exportación.

stats

object (ExportStats)

Solo salida. Detalles sobre el progreso y el tamaño de la exportación.

Es el tipo de receptor de exportación. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
cloudStorageSink

object (CloudStorageSink)

Solo salida. Es el receptor de los archivos de exportación en Cloud Storage.

Fin de los campos mutuamente excluyentes.

UserInfo

Información del usuario.

Representación JSON
{
  "email": string,
  "displayName": string
}
Campos
email

string

Es la dirección de correo electrónico del usuario.

displayName

string

Es el nombre visible del usuario.

ExportOptions

Opciones adicionales para las exportaciones

Representación JSON
{
  "region": enum (ExportRegion),

  "mailOptions": {
    object (MailExportOptions)
  },
  "groupsOptions": {
    object (GroupsExportOptions)
  },
  "driveOptions": {
    object (DriveExportOptions)
  },
  "hangoutsChatOptions": {
    object (HangoutsChatExportOptions)
  },
  "voiceOptions": {
    object (VoiceExportOptions)
  },
  "calendarOptions": {
    object (CalendarExportOptions)
  },
  "geminiOptions": {
    object (GeminiExportOptions)
  },
  "geminiInWorkspaceOptions": {
    object (GeminiInWorkspaceExportOptions)
  }
}
Campos
region

enum (ExportRegion)

Es la región de datos solicitada para la exportación.

Son las opciones específicas del servicio para las exportaciones. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
mailOptions

object (MailExportOptions)

Opciones para las exportaciones de Gmail.

groupsOptions

object (GroupsExportOptions)

Son las opciones para las exportaciones de Grupos.

driveOptions

object (DriveExportOptions)

Opciones para las exportaciones de Drive.

hangoutsChatOptions

object (HangoutsChatExportOptions)

Opciones para las exportaciones de Chat.

voiceOptions

object (VoiceExportOptions)

Opciones para las exportaciones de Voice.

calendarOptions

object (CalendarExportOptions)

Opción disponible para la exportación del calendario.

geminiOptions

object (GeminiExportOptions)

Opción disponible para la exportación de la app de Gemini.

geminiInWorkspaceOptions

object (GeminiInWorkspaceExportOptions)

Opción disponible para la exportación de Gemini en Workspace.

Fin de los campos mutuamente excluyentes.

MailExportOptions

Opciones para las exportaciones de Gmail.

Representación JSON
{
  "exportFormat": enum (ExportFormat),
  "showConfidentialModeContent": boolean,
  "useNewExport": boolean,
  "exportLinkedDriveFiles": boolean
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes exportados.

showConfidentialModeContent

boolean

Para exportar contenido del modo confidencial, establece el valor en true.

useNewExport

boolean

Para usar el nuevo sistema de exportación, configúralo como true.

exportLinkedDriveFiles

boolean

Opcional. Para habilitar la exportación de archivos de Drive vinculados, establece el valor en true.

ExportFormat

Formato de exportación de los mensajes

Enums
EXPORT_FORMAT_UNSPECIFIED No se especificó ningún formato de exportación.
MBOX Exportar como MBOX Solo está disponible para Gmail, Grupos, Hangouts y Voice.
PST Exportar como PST Solo está disponible para Gmail, Grupos, Hangouts, Voice y Calendario.
ICS Exportar como ICS Solo está disponible para el Calendario.
XML Exportar como XML Solo está disponible para la app de Gemini.
JSON Exportar como JSON Solo está disponible para Gemini en Workspace.

GroupsExportOptions

Son las opciones para las exportaciones de Grupos.

Representación JSON
{
  "exportFormat": enum (ExportFormat)
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes exportados.

DriveExportOptions

Opciones para las exportaciones de Drive.

Representación JSON
{
  "includeAccessInfo": boolean
}
Campos
includeAccessInfo

boolean

Para incluir información sobre el nivel de acceso de los usuarios con acceso indirecto a los archivos, establece el valor en true.

HangoutsChatExportOptions

Opciones para las exportaciones de Chat.

Representación JSON
{
  "exportFormat": enum (ExportFormat)
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes exportados.

VoiceExportOptions

Son las opciones para las exportaciones de Voice.

Representación JSON
{
  "exportFormat": enum (ExportFormat)
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes de texto exportados.

CalendarExportOptions

Son las opciones para las exportaciones del Calendario.

Representación JSON
{
  "exportFormat": enum (ExportFormat)
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes de texto exportados.

GeminiExportOptions

Las opciones para las exportaciones de la app de Gemini

Representación JSON
{
  "exportFormat": enum (ExportFormat)
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes exportados.

GeminiInWorkspaceExportOptions

Son las opciones para las exportaciones de Gemini en Workspace.

Representación JSON
{
  "exportFormat": enum (ExportFormat)
}
Campos
exportFormat

enum (ExportFormat)

Es el formato de archivo de los mensajes exportados.

ExportRegion

La región de datos para la exportación.

Enums
EXPORT_REGION_UNSPECIFIED No se especificó la región. La configuración predeterminada es ANY.
ANY Cualquier región.
US Región de Estados Unidos.
EUROPE Región de Europa.

ExportStatus

Es el estado de la exportación.

Enums
EXPORT_STATUS_UNSPECIFIED El estado no se especifica.
COMPLETED Se completó la exportación.
FAILED No se pudo realizar la exportación.
IN_PROGRESS La exportación está en curso.

ExportStats

Información de progreso de una exportación.

Representación JSON
{
  "exportedArtifactCount": string,
  "totalArtifactCount": string,
  "sizeInBytes": string
}
Campos
exportedArtifactCount

string (int64 format)

Es la cantidad de mensajes o archivos que ya se procesaron para la exportación.

totalArtifactCount

string (int64 format)

La cantidad de mensajes o archivos que se exportarán.

sizeInBytes

string (int64 format)

Es el tamaño de la exportación en bytes.

CloudStorageSink

Es el receptor de exportación para los archivos de Cloud Storage.

Representación JSON
{
  "files": [
    {
      object (CloudStorageFile)
    }
  ]
}
Campos
files[]

object (CloudStorageFile)

Solo salida. Los archivos exportados en Cloud Storage.

CloudStorageFile

El archivo de exportación en Cloud Storage

Representación JSON
{
  "bucketName": string,
  "objectName": string,
  "size": string,
  "md5Hash": string
}
Campos
bucketName

string

Es el nombre del bucket de Cloud Storage para el archivo de exportación. Puedes usar este valor en la API de JSON o la API de XML de Cloud Storage, pero no para enumerar el contenido del bucket. En su lugar, puedes obtener archivos de exportación individuales por nombre de objeto.

objectName

string

Es el nombre del objeto de Cloud Storage para el archivo de exportación. Puedes usar este valor en la API de JSON o la API de XML de Cloud Storage.

size

string (int64 format)

Es el tamaño del archivo de exportación.

md5Hash

string

Es el hash MD5 del archivo.

Métodos

create

Crea una exportación.

delete

Borra una exportación.

get

Obtiene una exportación.

list

Muestra los detalles de las exportaciones en el asunto especificado.