Query

A definição de consulta usada para pesquisa e exportação.

Representação JSON 
{
  "corpus": enum (CorpusType),
  "dataScope": enum (DataScope),
  "searchMethod": enum (SearchMethod),
  "method": enum (SearchMethod),
  "terms": string,
  "startTime": string,
  "endTime": string,
  "teamDriveInfo": {
    object (TeamDriveInfo)
  },
  "timeZone": string,

  "accountInfo": {
    object (AccountInfo)
  },
  "orgUnitInfo": {
    object (OrgUnitInfo)
  },
  "sharedDriveInfo": {
    object (SharedDriveInfo)
  },
  "hangoutsChatInfo": {
    object (HangoutsChatInfo)
  },
  "sitesUrlInfo": {
    object (SitesUrlInfo)
  },
  "driveDocumentInfo": {
    object (DriveDocumentInfo)
  }

  "mailOptions": {
    object (MailOptions)
  },
  "driveOptions": {
    object (DriveOptions)
  },
  "hangoutsChatOptions": {
    object (HangoutsChatOptions)
  },
  "voiceOptions": {
    object (VoiceOptions)
  },
  "calendarOptions": {
    object (CalendarOptions)
  },
  "geminiOptions": {
    object (GeminiOptions)
  },
  "geminiInWorkspaceOptions": {
    object (GeminiInWorkspaceOptions)
  }
}
Campos
corpus

enum (CorpusType)

O serviço do Google Workspace que será pesquisado.
dataScope

enum (DataScope)

A fonte de dados a ser pesquisada.
searchMethod
(deprecated)

enum (SearchMethod)

O método de pesquisa a ser usado.
method

enum (SearchMethod)

A entidade a ser pesquisada. Esse campo substitui searchMethod para oferecer suporte a drives compartilhados. Quando searchMethod é TEAM_DRIVE, a resposta desse campo é SHARED_DRIVE.
terms

string

Operadores de pesquisa específicos do serviço para filtrar os resultados da pesquisa.
startTime

string (Timestamp format)

O horário de início da consulta de pesquisa. Especifique em GMT. O valor é arredondado para 0h na data especificada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

O horário de término da consulta de pesquisa. Especifique em GMT. O valor é arredondado para as 12h da data especificada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
teamDriveInfo
(deprecated)

object (TeamDriveInfo)

Obrigatório quando SearchMethod é TEAM_DRIVE.
timeZone

string

O nome do fuso horário. Ele precisa ser um nome de fuso horário da IANA, como "America/Los_Angeles". Para uma lista de nomes de fusos horários, consulte Fuso horário. Para mais informações sobre como o Vault usa fusos horários, consulte a Central de Ajuda do Vault.
Especifica os detalhes das entidades a serem pesquisadas, quando necessário. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
accountInfo

object (AccountInfo)

Obrigatório quando SearchMethod é ACCOUNT.
orgUnitInfo

object (OrgUnitInfo)

Obrigatório quando SearchMethod é ORG_UNIT.
sharedDriveInfo

object (SharedDriveInfo)

Obrigatório quando SearchMethod é SHARED_DRIVE.
hangoutsChatInfo

object (HangoutsChatInfo)

Obrigatório quando SearchMethod é ROOM. (somente leitura)
sitesUrlInfo

object (SitesUrlInfo)

Obrigatório quando SearchMethod é SITES_URL.
driveDocumentInfo

object (DriveDocumentInfo)

Obrigatório quando SearchMethod é DRIVE_DOCUMENT.
Fim dos campos mutuamente exclusivos.
Outras opções de pesquisa para serviços específicos. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
mailOptions

object (MailOptions)

Defina as opções de pesquisa específicas do Gmail.
driveOptions

object (DriveOptions)

Defina opções específicas de pesquisa no Drive.
hangoutsChatOptions

object (HangoutsChatOptions)

Defina as opções de pesquisa específicas do Chat. (somente leitura)
voiceOptions

object (VoiceOptions)

Defina as opções específicas da pesquisa por voz.
calendarOptions

object (CalendarOptions)

Defina as opções de pesquisa específicas do Agenda.
geminiOptions

object (GeminiOptions)

Defina as opções de pesquisa específicas do app Gemini.
geminiInWorkspaceOptions

object (GeminiInWorkspaceOptions)

Defina as opções de pesquisa do Gemini no Workspace.
Fim dos campos mutuamente exclusivos.

DataScope

A fonte de dados a ser pesquisada.

Tipos enumerados
DATA_SCOPE_UNSPECIFIED Nenhuma fonte de dados foi especificada.
ALL_DATA Todos os dados disponíveis.
HELD_DATA Apenas dados em guarda de documentos.
UNPROCESSED_DATA Somente os dados que ainda não foram processados pelo Vault. (Apenas Gmail e Grupos)

SearchMethod

O tipo de entidade da pesquisa.

Tipos enumerados
SEARCH_METHOD_UNSPECIFIED Um método de pesquisa precisa ser especificado, caso contrário, ele será rejeitado.
ACCOUNT Pesquise os dados das contas especificadas em AccountInfo.
ORG_UNIT Pesquise os dados de todas as contas na unidade organizacional especificada em OrgUnitInfo.
TEAM_DRIVE

Pesquise os dados no drive de equipe especificado em teamDriveInfo.
ENTIRE_ORG Pesquise os dados de todas as contas na organização. Compatível apenas com o Gmail. Quando especificado, não é necessário especificar AccountInfo ou OrgUnitInfo.
ROOM Pesquise mensagens nos espaços do Chat especificados em HangoutsChatInfo.
SITES_URL Pesquise sites pelos URLs publicados especificados em SitesUrlInfo.
SHARED_DRIVE Pesquise os arquivos nos drives compartilhados especificados em SharedDriveInfo.
DRIVE_DOCUMENT Recupera os documentos especificados em DriveDocumentInfo.

AccountInfo

As contas a serem pesquisadas

Representação JSON 
{
  "emails": [
    string
  ]
}
Campos
emails[]

string

Um conjunto de contas para pesquisar.

OrgUnitInfo

A unidade organizacional a ser pesquisada.

Representação JSON 
{
  "orgUnitId": string
}
Campos
orgUnitId

string

O nome da unidade organizacional a ser pesquisada, conforme fornecido pela API Directory do SDK Admin.

SharedDriveInfo

Os drives compartilhados que serão pesquisados.

Representação JSON 
{
  "sharedDriveIds": [
    string
  ]
}
Campos
sharedDriveIds[]

string

Uma lista de IDs de drives compartilhados, conforme fornecido pela API Drive.

HangoutsChatInfo

Os espaços do Chat que serão pesquisados

Representação JSON 
{
  "roomId": [
    string
  ]
}
Campos
roomId[]

string

Uma lista de IDs de espaços do Chat, conforme fornecido pela API Chat. Há um limite de exportação de 500 espaços do Chat por solicitação.

SitesUrlInfo

Os URLs publicados do novo Google Sites para pesquisar

Representação JSON 
{
  "urls": [
    string
  ]
}
Campos
urls[]

string

Uma lista de URLs de sites publicados.

DriveDocumentInfo

Os documentos do Drive que serão pesquisados.

Representação JSON 
{

  "documentIds": {
    object (DriveDocumentIds)
  }
}
Campos
O formato para recuperar os documentos do Drive. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
documentIds

object (DriveDocumentIds)

Especifique os documentos do Drive pelo ID.
Fim dos campos mutuamente exclusivos.

DriveDocumentIds

Especifique os documentos do Drive pelo ID.

Representação JSON 
{
  "ids": [
    string
  ]
}
Campos
ids[]

string

Obrigatório. Uma lista de IDs de documentos do Drive.

TeamDriveInfo

Drives de equipe para pesquisar

Representação JSON 
{
  "teamDriveIds": [
    string
  ]
}
Campos
teamDriveIds[]
(deprecated)

string

Lista de IDs de drive de equipe, conforme fornecido pela API Drive.

MailOptions

Mais opções para a pesquisa do Gmail

Representação JSON 
{
  "excludeDrafts": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
Campos
excludeDrafts

boolean

Defina como true para excluir rascunhos.
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

Especifica se os resultados devem incluir conteúdo criptografado, não criptografado ou ambos. O padrão é incluir ambos.

ClientSideEncryptedOption

Se a organização usa a criptografia do lado do cliente do Google Workspace, o status de criptografia do conteúdo

Tipos enumerados
CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED Status da criptografia não especificado. Os resultados incluem conteúdo criptografado do lado do cliente e não criptografado.
CLIENT_SIDE_ENCRYPTED_OPTION_ANY Incluir conteúdo criptografado do lado do cliente e não criptografado nos resultados.
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED Inclua apenas conteúdo criptografado do lado do cliente.
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED Inclua apenas conteúdo não criptografado.

DriveOptions

Outras opções para a pesquisa do Drive.

Representação JSON 
{
  "versionDate": string,
  "includeTeamDrives": boolean,
  "includeSharedDrives": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption),
  "sharedDrivesOption": enum (SharedDrivesOption)
}
Campos
versionDate

string (Timestamp format)

Pesquise a versão atual do arquivo do Drive, mas exporte o conteúdo da última versão salva antes da 0h00 (UTC) na data indicada. Insira a data em UTC.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
includeTeamDrives
(deprecated)

boolean

Defina como verdadeiro para incluir o Drive de equipe.
includeSharedDrives
(deprecated)

boolean

Defina como true para incluir drives compartilhados.
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

Defina se os resultados incluem apenas conteúdo criptografado com a criptografia do lado do cliente do Google Workspace, apenas conteúdo não criptografado ou ambos. O padrão é ambos. No momento, o Drive é compatível.
sharedDrivesOption

enum (SharedDrivesOption)

Opcional. Opções para incluir ou excluir documentos em drives compartilhados. Recomendamos usar esse campo em vez de includeSharedDrives. Esse campo substitui includeSharedDrives e includeTeamDrives quando definido.

SharedDrivesOption

Opção sobre o tipo de documento de drive compartilhado a ser incluído.

Tipos enumerados
SHARED_DRIVES_OPTION_UNSPECIFIED Nenhuma opção de drive compartilhado foi especificada.
NOT_INCLUDED Se um recurso estiver em um drive compartilhado, ele não será incluído na pesquisa.
INCLUDED_IF_ACCOUNT_IS_NOT_A_MEMBER Os recursos do drive compartilhado só são incluídos quando a conta é colaboradora de um recurso, mas não é participante do drive compartilhado. Isso corresponde à opção Incluído apenas se os documentos forem compartilhados diretamente (e não por conta da participação no drive compartilhado) na interface do Vault. (Anteriormente, "includeSharedDrives" desativado)
INCLUDED Os recursos em drives compartilhados são incluídos na pesquisa. (anteriormente "includeSharedDrives" em)

HangoutsChatOptions

Mais opções para a pesquisa do Google Chat

Representação JSON 
{
  "includeRooms": boolean
}
Campos
includeRooms

boolean

Para pesquisas por conta ou unidade organizacional, defina como true para incluir salas.

VoiceOptions

Outras opções para a pesquisa por voz

Representação JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Campos
coveredData[]

enum (VoiceCoveredData)

Tipos de dados para pesquisar

CalendarOptions

Outras opções de pesquisa no Google Agenda

Representação JSON 
{
  "locationQuery": [
    string
  ],
  "peopleQuery": [
    string
  ],
  "minusWords": [
    string
  ],
  "responseStatuses": [
    enum (AttendeeResponse)
  ],
  "versionDate": string
}
Campos
locationQuery[]

string

Corresponde apenas aos eventos em que o local contém todas as palavras do conjunto fornecido. Se a string tiver frases entre aspas, esse método só vai corresponder aos eventos em que o local tiver a frase exata. As entradas no conjunto são consideradas em "and".

Exemplo de divisão de palavras: ["Nova Zelândia"] x ["Nova","Zelândia"] "Nova Zelândia": correspondência com ambos "Nova e melhor Zelândia": correspondência apenas com o último
peopleQuery[]

string

Corresponde apenas aos eventos em que os convidados contêm todas as palavras do conjunto fornecido. As entradas no conjunto são consideradas em "and".
minusWords[]

string

Corresponde apenas aos eventos que não contêm nenhuma das palavras do conjunto fornecido no título, na descrição, no local ou nos convidados. As entradas no conjunto são consideradas em "ou".
responseStatuses[]

enum (AttendeeResponse)

Corresponde apenas a eventos em que o custodiante deu uma dessas respostas. Se o conjunto estiver vazio ou contiver ATTENDEE_RESPONSE_UNSPECIFIED, não haverá filtragem nas respostas.
versionDate

string (Timestamp format)

Pesquise a versão atual do evento da Agenda, mas exporte o conteúdo da última versão salva antes da 0h00 (UTC) na data indicada. Insira a data em UTC.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

AttendeeResponse

Resposta do usuário a um convite.

Tipos enumerados
ATTENDEE_RESPONSE_UNSPECIFIED Resposta do convidado não especificada. Se essa opção for definida, nenhuma filtragem será feita nas respostas, e todas as outras respostas de convidados que fazem parte das opções de consulta serão ignoradas.
ATTENDEE_RESPONSE_NEEDS_ACTION O participante foi convidado, mas ainda não respondeu.
ATTENDEE_RESPONSE_ACCEPTED O participante planeja comparecer.
ATTENDEE_RESPONSE_DECLINED O participante não planeja comparecer.
ATTENDEE_RESPONSE_TENTATIVE O participante espera poder comparecer.

GeminiOptions

Esse tipo não tem campos.

Outras opções para a pesquisa no app do Gemini

GeminiInWorkspaceOptions

Esse tipo não tem campos.

Outras opções para a pesquisa do Gemini no Workspace