SanitizationResult

Risultato della sanitizzazione dopo l'applicazione di tutti i filtri ai contenuti di input.

Rappresentazione JSON 
{
  "filterMatchState": enum (FilterMatchState),
  "filterResults": {
    string: {
      object (FilterResult)
    },
    ...
  },
  "invocationResult": enum (InvocationResult),
  "sanitizationMetadata": {
    object (SanitizationMetadata)
  }
}
Campi
filterMatchState

enum (FilterMatchState)

Solo output. Stato complessivo della corrispondenza dei filtri per la sanitizzazione. Lo stato può avere due valori riportati di seguito.

1) NO_MATCH_FOUND: nessun filtro nella configurazione soddisfa i criteri di corrispondenza. In altre parole, l'input ha superato tutti i filtri.

2) MATCH_FOUND: almeno un filtro nella configurazione soddisfa la corrispondenza. In altre parole, l'input non ha superato uno o più filtri.
filterResults

map (key: string, value: object (FilterResult))

Solo output. Risultati per tutti i filtri in cui la chiave è il nome del filtro: "csam", "malicious_uris", "rai", "pi_and_jailbreak" ,"sdp".

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
invocationResult

enum (InvocationResult)

Solo output. Un campo che indica l'esito dell'invocazione, indipendentemente dallo stato della corrispondenza. Può avere i seguenti tre valori: SUCCESS: tutti i filtri sono stati eseguiti correttamente. PARZIALE: alcuni filtri sono stati ignorati o l'esecuzione non è andata a buon fine. ERRORE: tutti i filtri sono stati ignorati o l'esecuzione non è riuscita.
sanitizationMetadata

object (SanitizationMetadata)

Solo output. Metadati relativi alla sanitizzazione.

FilterMatchState

Opzione per specificare lo stato della corrispondenza del filtro.

Enum
FILTER_MATCH_STATE_UNSPECIFIED Non utilizzato
NO_MATCH_FOUND I criteri di corrispondenza non vengono raggiunti per i filtri.
MATCH_FOUND I criteri di corrispondenza vengono soddisfatti per il filtro.

FilterResult

Risultato del filtro ottenuto dopo le operazioni di bonifica.

Rappresentazione JSON 
{

  // Union field filter_result can be only one of the following:
  "raiFilterResult": {
    object (RaiFilterResult)
  },
  "sdpFilterResult": {
    object (SdpFilterResult)
  },
  "piAndJailbreakFilterResult": {
    object (PiAndJailbreakFilterResult)
  },
  "maliciousUriFilterResult": {
    object (MaliciousUriFilterResult)
  },
  "csamFilterFilterResult": {
    object (CsamFilterResult)
  },
  "virusScanFilterResult": {
    object (VirusScanFilterResult)
  }
  // End of list of possible types for union field filter_result.
}
Campi
Campo unione filter_result. Incapsula uno dei risultati del filtro relativi ad AI responsabile, Protezione dei dati sensibili, Prompt injection e jailbreak, URI dannosi, materiale pedopornografico, Scansione virus. filter_result può essere solo uno dei seguenti:
raiFilterResult

object (RaiFilterResult)

Risultati del filtro AI responsabile.
sdpFilterResult

object (SdpFilterResult)

Risultati di Sensitive Data Protection.
piAndJailbreakFilterResult

object (PiAndJailbreakFilterResult)

Risultati del filtro Prompt injection e jailbreak.
maliciousUriFilterResult

object (MaliciousUriFilterResult)

Risultati del filtro URI dannoso.
csamFilterFilterResult

object (CsamFilterResult)

Risultati del filtro CSAM.
virusScanFilterResult

object (VirusScanFilterResult)

Risultati della scansione antivirus.

RaiFilterResult

Risultato dell'IA responsabile.

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "raiFilterTypeResults": {
    string: {
      object (RaiFilterTypeResult)
    },
    ...
  }
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se il filtro RAI è stato eseguito correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene ignorato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato complessivo della corrispondenza del filtro per l'AI responsabile. Il valore è MATCH_FOUND se almeno un livello di confidenza del filtro RAI è uguale o superiore a quello definito nella configurazione.
raiFilterTypeResults

map (key: string, value: object (RaiFilterTypeResult))

La mappa dei risultati del filtro RAI, in cui la chiave è il tipo di filtro RAI: "sexually_explicit", "hate_speech", "harassment", "dangerous".

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FilterExecutionState

Enum che indica se un filtro specifico è stato eseguito correttamente o meno.

Enum
FILTER_EXECUTION_STATE_UNSPECIFIED Non utilizzato
EXECUTION_SUCCESS Filtro eseguito correttamente
EXECUTION_SKIPPED L'esecuzione del filtro è stata saltata. Ciò può accadere a causa di un errore lato server o di un problema di autorizzazione.

MessageItem

Elemento messaggio per segnalare informazioni, avvisi o messaggi di errore.

Rappresentazione JSON 
{
  "messageType": enum (MessageType),
  "message": string
}
Campi
messageType

enum (MessageType)

Tipo di messaggio.
message

string

I contenuti del messaggio.

MessageType

Opzione per specificare il tipo di messaggio.

Enum
MESSAGE_TYPE_UNSPECIFIED Non utilizzato
INFO Messaggio relativo alle informazioni.
WARNING Messaggio relativo all'avviso.
ERROR Messaggio di errore.

RaiFilterTypeResult

Risultato del filtro dettagliato per ciascuno dei tipi di filtro AI responsabile.

Rappresentazione JSON 
{
  "filterType": enum (RaiFilterType),
  "confidenceLevel": enum (DetectionConfidenceLevel),
  "matchState": enum (FilterMatchState)
}
Campi
filterType

enum (RaiFilterType)

Tipo di filtro AI responsabile.
confidenceLevel

enum (DetectionConfidenceLevel)

Livello di confidenza identificato per questo filtro AI responsabile.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per questo filtro RAI.

SdpFilterResult

Risultato del filtro Sensitive Data Protection.

Rappresentazione JSON 
{

  // Union field result can be only one of the following:
  "inspectResult": {
    object (SdpInspectResult)
  },
  "deidentifyResult": {
    object (SdpDeidentifyResult)
  }
  // End of list of possible types for union field result.
}
Campi
Campo unione result. Uno dei risultati di ispezione o anonimizzazione di Sensitive Data Protection. result può essere solo uno dei seguenti:
inspectResult

object (SdpInspectResult)

Risultato dell'ispezione di Sensitive Data Protection se viene eseguita.
deidentifyResult

object (SdpDeidentifyResult)

Risultato dell'anonimizzazione di Sensitive Data Protection se viene eseguita l'anonimizzazione.

SdpInspectResult

Risultato dell'ispezione di Sensitive Data Protection.

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "findings": [
    {
      object (SdpFinding)
    }
  ],
  "findingsTruncated": boolean
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se l'ispezione di Sensitive Data Protection è stata eseguita correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene ignorato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per l'ispezione SDP. Il valore è MATCH_FOUND se viene identificato almeno un rilevamento di Sensitive Data Protection.
findings[]

object (SdpFinding)

Elenco dei risultati di Sensitive Data Protection.
findingsTruncated

boolean

Se il valore è true, è possibile che siano stati identificati più risultati e che quelli restituiti siano un sottoinsieme di tutti i risultati. L'elenco dei risultati potrebbe essere troncato perché gli elementi di input erano troppo grandi o perché il server ha raggiunto la quantità massima di risorse consentite per una singola chiamata API.

SdpFinding

Risultato corrispondente al filtro Sensitive Data Protection.

Rappresentazione JSON 
{
  "infoType": string,
  "likelihood": enum (SdpFindingLikelihood),
  "location": {
    object (SdpFindingLocation)
  }
}
Campi
infoType

string

Nome del tipo di informazioni di Sensitive Data Protection per questo rilevamento.
likelihood

enum (SdpFindingLikelihood)

Probabilità di confidenza identificata per infoType.
location

object (SdpFindingLocation)

Posizione del risultato.

SdpFindingLikelihood

Per ulteriori informazioni su ciascun livello di probabilità di Sensitive Data Protection, consulta https://cloud.google.com/sensitive-data-protection/docs/likelihood.

Enum
SDP_FINDING_LIKELIHOOD_UNSPECIFIED Valore predefinito; uguale a POSSIBLE.
VERY_UNLIKELY Probabilità più elevata di un falso positivo.
UNLIKELY Elevata probabilità di un falso positivo.
POSSIBLE Alcuni indicatori corrispondenti. Il valore predefinito.
LIKELY Bassa probabilità di un falso positivo.
VERY_LIKELY Il livello di confidenza è elevato. Possibilità più bassa di un falso positivo.

SdpFindingLocation

Posizione di questo rilevamento relativo alla protezione dei dati sensibili all'interno dei contenuti inseriti.

Rappresentazione JSON 
{
  "byteRange": {
    object (RangeInfo)
  },
  "codepointRange": {
    object (RangeInfo)
  }
}
Campi
byteRange

object (RangeInfo)

Offset in byte a partire da zero che delimitano il rilevamento. Sono relativi all'elemento contenente del rilevamento. Tieni presente che, se i contenuti non sono di testo, si fa riferimento alla rappresentazione testuale codificata in UTF-8 dei contenuti.
codepointRange

object (RangeInfo)

Gli offset dei caratteri Unicode che delimitano il risultato. Sono relativi all'elemento contenitore del rilevamento. Fornito quando i contenuti sono di testo.

RangeInfo

Intervallo di intervallo semiaperto [inizio, fine)

Rappresentazione JSON 
{
  "start": string,
  "end": string
}
Campi
start

string (int64 format)

Per proto3, il valore non può essere impostato su 0, a meno che il campo non sia facoltativo. Rif.: https://protobuf.dev/programming-guides/proto3/#default Indice del primo carattere (incluso).
end

string (int64 format)

Indice dell'ultimo carattere (esclusivo).

SdpDeidentifyResult

Risultato di anonimizzazione Sensitive Data Protection.

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "data": {
    object (DataItem)
  },
  "transformedBytes": string
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se l'anonimizzazione di Sensitive Data Protection è stata eseguita correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene ignorato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per l'anonimizzazione di Sensitive Data Protection. Il valore è MATCH_FOUND se i contenuti sono anonimizzati.
data

object (DataItem)

Dati anonimizzati.
transformedBytes

string (int64 format)

Dimensioni totali in byte che sono state trasformate durante la deidentificazione.

PiAndJailbreakFilterResult

Risultato del filtro Prompt injection e jailbreak.

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se il filtro prompt injection e jailbreak è stato eseguito correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene saltato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per prompt injection e jailbreak.
confidenceLevel

enum (DetectionConfidenceLevel)

Livello di confidenza identificato per l'iniezione di prompt e il jailbreak.

MaliciousUriFilterResult

Risultato del filtro URI dannoso.

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "maliciousUriMatchedItems": [
    {
      object (MaliciousUriMatchedItem)
    }
  ]
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se il filtro URI dannoso è stato eseguito correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene saltato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per questo URI dannoso. Il valore è MATCH_FOUND se viene trovato almeno un URI dannoso.
maliciousUriMatchedItems[]

object (MaliciousUriMatchedItem)

Elenco di URI dannosi trovati nei dati.

MaliciousUriMatchedItem

Informazioni sull'URI dannoso e sulla sua posizione all'interno dei contenuti inseriti.

Rappresentazione JSON 
{
  "uri": string,
  "locations": [
    {
      object (RangeInfo)
    }
  ]
}
Campi
uri

string

URI dannoso.
locations[]

object (RangeInfo)

Elenco di località in cui è stato identificato un URI dannoso. Il campo locations è supportato solo per i contenuti in testo normale, ad esempio ByteItemType.PLAINTEXT_UTF8

CsamFilterResult

Risultato del filtro per materiale pedopornografico

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState)
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se il filtro CSAM è stato eseguito correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene ignorato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per il materiale pedopornografico.

VirusScanFilterResult

Risultati della scansione antivirus.

Rappresentazione JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "scannedContentType": enum (ScannedContentType),
  "virusDetails": [
    {
      object (VirusDetail)
    }
  ],
  "scannedSize": string
}
Campi
executionState

enum (FilterExecutionState)

Solo output. Indica se la scansione antivirus è stata eseguita correttamente o meno.
messageItems[]

object (MessageItem)

Messaggi facoltativi corrispondenti al risultato. Un messaggio può fornire avvisi o dettagli sugli errori. Ad esempio, se lo stato di esecuzione viene ignorato, questo campo fornisce il motivo/la spiegazione correlata.
matchState

enum (FilterMatchState)

Solo output. Stato della corrispondenza per Virus. Il valore è MATCH_FOUND se i dati sono infettati da un virus.
scannedContentType

enum (ScannedContentType)

Tipo di contenuti sottoposti a scansione.
virusDetails[]

object (VirusDetail)

Elenco dei virus identificati. Questo campo sarà vuoto se non è stato rilevato alcun virus.
scannedSize

string (int64 format)

Dimensioni dei contenuti scansionati in byte.

ScannedContentType

Tipo di contenuti sottoposti a scansione.

Enum
SCANNED_CONTENT_TYPE_UNSPECIFIED Non utilizzato
UNKNOWN Contenuti sconosciuti
PLAINTEXT Testo normale
PDF L'analisi PDF è supportata solo per i file PDF.

VirusDetail

Dettagli di un virus identificato

Rappresentazione JSON 
{
  "vendor": string,
  "names": [
    string
  ],
  "threatType": enum (ThreatType)
}
Campi
vendor

string

Nome del fornitore che ha prodotto questa identificazione del virus.
names[]

string

Nomi di questo virus.
threatType

enum (ThreatType)

Tipo di minaccia del virus identificato

ThreatType

Definisce tutti i tipi di minacce di un virus

Enum
THREAT_TYPE_UNSPECIFIED Non utilizzato
UNKNOWN Impossibile classificare la minaccia
VIRUS_OR_WORM Minaccia di virus o worm.
MALICIOUS_PROGRAM Programma dannoso. Ad es. spyware, trojan.
POTENTIALLY_HARMFUL_CONTENT Contenuti potenzialmente dannosi. Ad es. codice inserito, macro
POTENTIALLY_UNWANTED_CONTENT Contenuti potenzialmente indesiderati. Ad esempio adware.

InvocationResult

Un campo che indica il risultato dell'invocazione, indipendentemente dallo stato della corrispondenza.

Enum
INVOCATION_RESULT_UNSPECIFIED Non utilizzato. Valore predefinito.
SUCCESS Tutti i filtri sono stati richiamati correttamente.
PARTIAL Alcuni filtri sono stati ignorati o non sono riusciti.
FAILURE Tutti i filtri sono stati ignorati o non sono riusciti.

SanitizationMetadata

Messaggio che descrive i metadati di sanitizzazione.

Rappresentazione JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Campi
errorCode

string (int64 format)

Codice di errore, se presente.
errorMessage

string

Messaggio di errore, se presente.