Query

La definizione della query utilizzata per la ricerca e l'esportazione.

Rappresentazione 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)
  }
}
Campi
corpus

enum (CorpusType)

Il servizio Google Workspace in cui eseguire la ricerca.
dataScope

enum (DataScope)

L'origine dati in cui eseguire la ricerca.
searchMethod
(deprecated)

enum (SearchMethod)

Il metodo di ricerca da utilizzare.
method

enum (SearchMethod)

L'entità in cui cercare. Questo campo sostituisce searchMethod per supportare i Drive condivisi. Quando searchMethod è TEAM_DRIVE, la risposta di questo campo è SHARED_DRIVE.
terms

string

Operatori di ricerca specifici per il servizio per filtrare i risultati di ricerca.
startTime

string (Timestamp format)

L'ora di inizio della query di ricerca. Specifica il fuso orario GMT. Il valore viene arrotondato alle 00:00 della data specificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

L'ora di fine della query di ricerca. Specifica il fuso orario GMT. Il valore viene arrotondato alle 00:00 della data specificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
teamDriveInfo
(deprecated)

object (TeamDriveInfo)

Obbligatorio quando SearchMethod è TEAM_DRIVE.
timeZone

string

Il nome del fuso orario. Deve essere un nome di fuso orario IANA, ad esempio "America/Los_Angeles". Per un elenco dei nomi dei fusi orari, consulta Fuso orario. Per ulteriori informazioni su come Vault utilizza i fusi orari, consulta il Centro assistenza Vault.
Specifica i dettagli delle entità da cercare, se necessario. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
accountInfo

object (AccountInfo)

Obbligatorio quando SearchMethod è ACCOUNT.
orgUnitInfo

object (OrgUnitInfo)

Obbligatorio quando SearchMethod è ORG_UNIT.
sharedDriveInfo

object (SharedDriveInfo)

Obbligatorio quando SearchMethod è SHARED_DRIVE.
hangoutsChatInfo

object (HangoutsChatInfo)

Obbligatorio quando SearchMethod è ROOM. (sola lettura)
sitesUrlInfo

object (SitesUrlInfo)

Obbligatorio quando SearchMethod è SITES_URL.
driveDocumentInfo

object (DriveDocumentInfo)

Obbligatorio quando SearchMethod è DRIVE_DOCUMENT.
Fine dei campi che si escludono a vicenda.
Opzioni di ricerca aggiuntive per servizi specifici. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
mailOptions

object (MailOptions)

Imposta le opzioni specifiche per la ricerca in Gmail.
driveOptions

object (DriveOptions)

Imposta le opzioni specifiche per la ricerca di Drive.
hangoutsChatOptions

object (HangoutsChatOptions)

Imposta le opzioni specifiche per la ricerca in Chat. (sola lettura)
voiceOptions

object (VoiceOptions)

Imposta le opzioni specifiche per la ricerca vocale.
calendarOptions

object (CalendarOptions)

Imposta le opzioni specifiche per la ricerca in Calendar.
geminiOptions

object (GeminiOptions)

Imposta le opzioni specifiche per la ricerca dell'app Gemini.
geminiInWorkspaceOptions

object (GeminiInWorkspaceOptions)

Imposta le opzioni specifiche per la ricerca di Gemini in Workspace.
Fine dei campi che si escludono a vicenda.

DataScope

L'origine dati da cercare.

Enum
DATA_SCOPE_UNSPECIFIED Nessuna origine dati specificata.
ALL_DATA Tutti i dati disponibili.
HELD_DATA Solo i dati bloccati.
UNPROCESSED_DATA Solo i dati non ancora elaborati da Vault. (Solo Gmail e Gruppi)

SearchMethod

Il tipo di entità per la ricerca.

Enum
SEARCH_METHOD_UNSPECIFIED È necessario specificare un metodo di ricerca, altrimenti la richiesta viene rifiutata.
ACCOUNT Cerca i dati degli account specificati in AccountInfo.
ORG_UNIT Cerca i dati di tutti gli account nell'unità organizzativa specificata in OrgUnitInfo.
TEAM_DRIVE

Cerca i dati nel Drive del team specificato in teamDriveInfo.
ENTIRE_ORG Cerca nei dati di tutti gli account dell'organizzazione. Supportato solo per Gmail. Se specificato, non è necessario specificare AccountInfo o OrgUnitInfo.
ROOM Cerca i messaggi negli spazi di Chat specificati in HangoutsChatInfo.
SITES_URL Cerca i siti in base agli URL dei siti pubblicati specificati in SitesUrlInfo.
SHARED_DRIVE Cerca i file nei Drive condivisi specificati in SharedDriveInfo.
DRIVE_DOCUMENT Recupera i documenti specificati in DriveDocumentInfo.

AccountInfo

Gli account in cui eseguire la ricerca

Rappresentazione JSON 
{
  "emails": [
    string
  ]
}
Campi
emails[]

string

Un insieme di account in cui eseguire la ricerca.

OrgUnitInfo

L'unità organizzativa da cercare

Rappresentazione JSON 
{
  "orgUnitId": string
}
Campi
orgUnitId

string

Il nome dell'unità organizzativa da cercare, come fornito dall'API Directory dell'SDK Admin.

SharedDriveInfo

I Drive condivisi in cui eseguire la ricerca

Rappresentazione JSON 
{
  "sharedDriveIds": [
    string
  ]
}
Campi
sharedDriveIds[]

string

Un elenco di ID Drive condivisi, forniti dall'API Drive.

HangoutsChatInfo

Gli spazi di Chat in cui eseguire la ricerca

Rappresentazione JSON 
{
  "roomId": [
    string
  ]
}
Campi
roomId[]

string

Un elenco di ID degli spazi di Chat, fornito dall'API Chat. Esiste un limite di esportazione di 500 spazi di Chat per richiesta.

SitesUrlInfo

Gli URL dei siti pubblicati della nuova versione di Google Sites da cercare

Rappresentazione JSON 
{
  "urls": [
    string
  ]
}
Campi
urls[]

string

Un elenco di URL dei siti pubblicati.

DriveDocumentInfo

I documenti di Drive in cui eseguire la ricerca.

Rappresentazione JSON 
{

  "documentIds": {
    object (DriveDocumentIds)
  }
}
Campi
Il formato per recuperare i documenti di Drive. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
documentIds

object (DriveDocumentIds)

Specifica i documenti di Drive in base all'ID documento.
Fine dei campi che si escludono a vicenda.

DriveDocumentIds

Specifica i documenti di Drive in base all'ID documento.

Rappresentazione JSON 
{
  "ids": [
    string
  ]
}
Campi
ids[]

string

Obbligatorio. Un elenco di ID documento di Drive.

TeamDriveInfo

Drive del team in cui eseguire la ricerca

Rappresentazione JSON 
{
  "teamDriveIds": [
    string
  ]
}
Campi
teamDriveIds[]
(deprecated)

string

Elenco degli ID dei Drive del team, come fornito dall'API Drive.

MailOptions

Opzioni aggiuntive per la ricerca in Gmail

Rappresentazione JSON 
{
  "excludeDrafts": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
Campi
excludeDrafts

boolean

Imposta su true per escludere le bozze.
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

Specifica se i risultati devono includere contenuti criptati, non criptati o entrambi. Per impostazione predefinita, sono inclusi entrambi.

ClientSideEncryptedOption

Se la tua organizzazione utilizza la crittografia lato client di Google Workspace, lo stato di crittografia dei contenuti

Enum
CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED Stato della crittografia non specificato. I risultati includono contenuti con e senza crittografia lato client.
CLIENT_SIDE_ENCRYPTED_OPTION_ANY Includi nei risultati sia i contenuti con crittografia lato client sia quelli non criptati.
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED Includi solo i contenuti con crittografia lato client.
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED Includere solo contenuti non criptati.

DriveOptions

Opzioni aggiuntive per la ricerca su Drive.

Rappresentazione JSON 
{
  "versionDate": string,
  "includeTeamDrives": boolean,
  "includeSharedDrives": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption),
  "sharedDrivesOption": enum (SharedDrivesOption)
}
Campi
versionDate

string (Timestamp format)

Cerca la versione corrente del file di Drive, ma esporta i contenuti dell'ultima versione salvata prima delle ore 00:00 UTC della data specificata. Inserisci la data in UTC.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
includeTeamDrives
(deprecated)

boolean

Imposta su true per includere il Drive del team.
includeSharedDrives
(deprecated)

boolean

Imposta su true per includere i Drive condivisi.
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

Imposta se i risultati devono includere solo i contenuti criptati con la crittografia lato client di Google Workspace, solo i contenuti non criptati o entrambi. Il valore predefinito è "both". Al momento è supportato per Drive.
sharedDrivesOption

enum (SharedDrivesOption)

Facoltativo. Opzioni per includere o escludere i documenti nei Drive condivisi. Ti consigliamo di utilizzare questo campo anziché includeSharedDrives. Questo campo sostituisce includeSharedDrives e includeTeamDrives se impostato.

SharedDrivesOption

Opzione sul tipo di documenti del Drive condiviso da includere.

Enum
SHARED_DRIVES_OPTION_UNSPECIFIED Nessuna opzione di Drive condiviso specificata.
NOT_INCLUDED Se una risorsa si trova in un Drive condiviso, non viene inclusa nella ricerca.
INCLUDED_IF_ACCOUNT_IS_NOT_A_MEMBER Le risorse del Drive condiviso sono incluse solo nei casi in cui l'account è un collaboratore di una risorsa, ma non è un membro del Drive condiviso. Questo corrisponde all'opzione "Incluso solo se i documenti sono condivisi direttamente (non perché l'account è membro del Drive condiviso)" nell'interfaccia utente di Vault. (In precedenza "includeSharedDrives" off)
INCLUDED Le risorse nei Drive condivisi sono incluse nella ricerca. (In precedenza "includeSharedDrives" su)

HangoutsChatOptions

Opzioni aggiuntive per la ricerca in Google Chat

Rappresentazione JSON 
{
  "includeRooms": boolean
}
Campi
includeRooms

boolean

Per le ricerche in base ad account o unità organizzativa, imposta su true per includere le stanze virtuali.

VoiceOptions

Opzioni aggiuntive per la ricerca vocale

Rappresentazione JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Campi
coveredData[]

enum (VoiceCoveredData)

Tipi di dati da cercare

CalendarOptions

Opzioni aggiuntive per la ricerca di Calendar

Rappresentazione JSON 
{
  "locationQuery": [
    string
  ],
  "peopleQuery": [
    string
  ],
  "minusWords": [
    string
  ],
  "responseStatuses": [
    enum (AttendeeResponse)
  ],
  "versionDate": string
}
Campi
locationQuery[]

string

Trova corrispondenze solo per gli eventi la cui località contiene tutte le parole dell'insieme specificato. Se la stringa contiene frasi tra virgolette, questo metodo trova solo gli eventi la cui località contiene la frase esatta. Le voci nell'insieme sono considerate in "and".

Esempio di suddivisione delle parole: ["New Zealand"] rispetto a ["New","Zealand"] "New Zealand": corrispondenza con entrambi "New and better Zealand": corrispondenza solo con il secondo
peopleQuery[]

string

Trova corrispondenze solo per gli eventi i cui partecipanti contengono tutte le parole nell'insieme specificato. Le voci nell'insieme sono considerate in "and".
minusWords[]

string

Trova solo gli eventi che non contengono nessuna delle parole dell'insieme specificato nel titolo, nella descrizione, nel luogo o nei partecipanti. Le voci dell'insieme sono considerate in "or".
responseStatuses[]

enum (AttendeeResponse)

Restituisce solo gli eventi per cui il custode ha fornito una di queste risposte. Se l'insieme è vuoto o contiene ATTENDEE_RESPONSE_UNSPECIFIED, non verrà applicato alcun filtro alle risposte.
versionDate

string (Timestamp format)

Cerca la versione corrente dell'evento nel calendario, ma esporta i contenuti dell'ultima versione salvata prima delle ore 00:00 UTC della data specificata. Inserisci la data in UTC.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AttendeeResponse

Risposta dell'utente a un invito.

Enum
ATTENDEE_RESPONSE_UNSPECIFIED Risposta del partecipante non specificata. Se questa opzione è impostata, non verrà applicato Nessuno alle risposte e tutte le altre risposte dei partecipanti che fanno parte delle opzioni di query verranno ignorate.
ATTENDEE_RESPONSE_NEEDS_ACTION Il partecipante è stato invitato, ma non ha ancora risposto.
ATTENDEE_RESPONSE_ACCEPTED Il partecipante prevede di partecipare.
ATTENDEE_RESPONSE_DECLINED Il partecipante non prevede di partecipare.
ATTENDEE_RESPONSE_TENTATIVE Il partecipante prevede di partecipare.

GeminiOptions

Questo tipo non ha campi.

Opzioni aggiuntive per la ricerca nell'app Gemini

GeminiInWorkspaceOptions

Questo tipo non ha campi.

Opzioni aggiuntive per la ricerca di Gemini in Workspace