SanitizationResult

Resultado de la limpieza después de aplicar todos los filtros en el contenido de entrada.

Representación JSON 
{
  "filterMatchState": enum (FilterMatchState),
  "filterResults": {
    string: {
      object (FilterResult)
    },
    ...
  },
  "invocationResult": enum (InvocationResult),
  "sanitizationMetadata": {
    object (SanitizationMetadata)
  }
}
Campos
filterMatchState

enum (FilterMatchState)

Solo salida. Estado general de coincidencia de filtros para la limpieza. El estado puede tener menos de dos valores.

1) NO_MATCH_FOUND: No hay filtros en la configuración que satisfagan los criterios de coincidencia. En otras palabras, la entrada pasó todos los filtros.

2) MATCH_FOUND: Al menos un filtro de la configuración satisface la coincidencia. En otras palabras, la entrada no pasó uno o más filtros.
filterResults

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

Solo salida. Resultados de todos los filtros en los que la clave es el nombre del filtro, ya sea "csam", "malicious_uris", "rai" ,"pi_and_jailbreak" o "sdp".

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
invocationResult

enum (InvocationResult)

Solo salida. Es un campo que indica el resultado de la invocación, independientemente del estado de coincidencia. Puede tener los siguientes tres valores: SUCCESS: Todos los filtros se ejecutaron correctamente. PARTIAL: Se omitieron algunos filtros o no se pudieron ejecutar. ERROR: Se omitieron todos los filtros o no se pudo ejecutar.
sanitizationMetadata

object (SanitizationMetadata)

Solo salida. Metadatos relacionados con la limpieza.

FilterMatchState

Es la opción para especificar el estado de concordancia del filtro.

Enums
FILTER_MATCH_STATE_UNSPECIFIED Sin usar
NO_MATCH_FOUND No se cumplen los criterios de coincidencia para los filtros.
MATCH_FOUND Se cumplen los criterios de coincidencia para el filtro.

FilterResult

Es el resultado del filtro obtenido después de las operaciones de limpieza.

Representación 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.
}
Campos
Campo de unión filter_result. Encapsula uno de los resultados de filtros relacionados con la IA responsable, la protección de datos sensibles, la inserción de instrucciones y el jailbreak, el URI malicioso, el CSAM y el análisis de virus. filter_result puede ser solo uno de los siguientes:
raiFilterResult

object (RaiFilterResult)

Resultados del filtro de IA responsable
sdpFilterResult

object (SdpFilterResult)

Resultados de la Protección de datos sensibles
piAndJailbreakFilterResult

object (PiAndJailbreakFilterResult)

Resultados del filtro de inyección de instrucciones y jailbreak
maliciousUriFilterResult

object (MaliciousUriFilterResult)

Resultados del filtro de URI malicioso
csamFilterFilterResult

object (CsamFilterResult)

Resultados del filtro de CSAM
virusScanFilterResult

object (VirusScanFilterResult)

Resultados del análisis de virus.

RaiFilterResult

Resultado de la IA responsable.

Representación JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "raiFilterTypeResults": {
    string: {
      object (RaiFilterTypeResult)
    },
    ...
  }
}
Campos
executionState

enum (FilterExecutionState)

Solo salida. Informa si el filtro de RAI se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales que corresponden al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Es el estado general de coincidencia del filtro para la RAI. El valor es MATCH_FOUND si al menos un nivel de confianza del filtro de RAI es igual o superior al nivel de confianza definido en la configuración.
raiFilterTypeResults

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

Es el mapa de los resultados del filtro de RAI, en el que la clave es el tipo de filtro de RAI, ya sea "sexually_explicit", "hate_speech", "harassment" o "dangerous".

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FilterExecutionState

Es una enumeración que informa si un filtro específico se ejecutó correctamente o no.

Enums
FILTER_EXECUTION_STATE_UNSPECIFIED Sin usar
EXECUTION_SUCCESS Se ejecutó correctamente el filtro
EXECUTION_SKIPPED Se omitió la ejecución del filtro. Esto puede ocurrir debido a un error del servidor o a un problema de permisos.

MessageItem

Es un elemento de mensaje para informar información, advertencias o mensajes de error.

Representación JSON 
{
  "messageType": enum (MessageType),
  "message": string
}
Campos
messageType

enum (MessageType)

Tipo de mensaje.
message

string

El contenido del mensaje

MessageType

Es la opción para especificar el tipo de mensaje.

Enums
MESSAGE_TYPE_UNSPECIFIED Sin usar
INFO Mensaje relacionado con la información.
WARNING Mensaje relacionado con una advertencia.
ERROR Mensaje de error

RaiFilterTypeResult

Resultado detallado del filtro para cada uno de los tipos de filtros de IA responsable.

Representación JSON 
{
  "filterType": enum (RaiFilterType),
  "confidenceLevel": enum (DetectionConfidenceLevel),
  "matchState": enum (FilterMatchState)
}
Campos
filterType

enum (RaiFilterType)

Tipo de filtro de IA responsable.
confidenceLevel

enum (DetectionConfidenceLevel)

Es el nivel de confianza identificado para este filtro de RAI.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para este filtro de RAI.

SdpFilterResult

Resultado del filtro de Protección de datos sensibles.

Representación 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.
}
Campos
Campo de unión result. Cualquiera de los resultados de la inspección de Protección de datos sensibles o de la desidentificación. result puede ser solo uno de los siguientes:
inspectResult

object (SdpInspectResult)

Resultado de la inspección de Protección de datos sensibles si se realiza la inspección
deidentifyResult

object (SdpDeidentifyResult)

Resultado de la desidentificación de la Protección de datos sensibles si se realiza la desidentificación

SdpInspectResult

Resultado de la inspección de Protección de datos sensibles.

Representación JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "findings": [
    {
      object (SdpFinding)
    }
  ],
  "findingsTruncated": boolean
}
Campos
executionState

enum (FilterExecutionState)

Solo salida. Informa si la inspección de Sensitive Data Protection se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales que corresponden al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para la inspección de SDP. El valor es MATCH_FOUND si se identifica al menos un hallazgo de Protección de datos sensibles.
findings[]

object (SdpFinding)

Es la lista de los resultados de la Protección de datos sensibles.
findingsTruncated

boolean

Si es verdadero, es posible que se hayan identificado más hallazgos y que los resultados que se muestran sean un subconjunto de todos los hallazgos. Es posible que la lista de resultados se haya truncado porque los elementos de entrada eran demasiado grandes o porque el servidor alcanzó la cantidad máxima de recursos permitidos para una sola llamada a la API.

SdpFinding

Búsqueda correspondiente al filtro de Protección de datos sensibles.

Representación JSON 
{
  "infoType": string,
  "likelihood": enum (SdpFindingLikelihood),
  "location": {
    object (SdpFindingLocation)
  }
}
Campos
infoType

string

Es el nombre del infotipo de protección de datos sensibles para este hallazgo.
likelihood

enum (SdpFindingLikelihood)

Probabilidad de confianza identificada para infoType.
location

object (SdpFindingLocation)

Es la ubicación de este hallazgo.

SdpFindingLikelihood

Para obtener más información sobre cada nivel de probabilidad de la protección de datos sensibles, consulta https://cloud.google.com/sensitive-data-protection/docs/likelihood.

Enums
SDP_FINDING_LIKELIHOOD_UNSPECIFIED Valor predeterminado; igual que POSSIBLE.
VERY_UNLIKELY Mayor probabilidad de un falso positivo.
UNLIKELY Alta probabilidad de un falso positivo.
POSSIBLE Algunos indicadores coincidentes Es el valor predeterminado.
LIKELY Baja probabilidad de un falso positivo.
VERY_LIKELY El nivel de confianza es alto. Tiene la menor probabilidad de generar un falso positivo.

SdpFindingLocation

Ubicación de este hallazgo de Protección de datos sensibles dentro del contenido de entrada.

Representación JSON 
{
  "byteRange": {
    object (RangeInfo)
  },
  "codepointRange": {
    object (RangeInfo)
  }
}
Campos
byteRange

object (RangeInfo)

Desplazamientos de bytes basados en cero que delimitan el hallazgo Se relacionan con el elemento que contiene el hallazgo. Ten en cuenta que, cuando el contenido no es textual, hace referencia a la representación textual codificada en UTF-8.
codepointRange

object (RangeInfo)

Desplazamientos de caracteres Unicode que delimitan el hallazgo. Se relacionan con el elemento que contiene el hallazgo. Se proporciona cuando el contenido es texto.

RangeInfo

Intervalo de intervalo medio abierto [inicio, fin)

Representación JSON 
{
  "start": string,
  "end": string
}
Campos
start

string (int64 format)

Para proto3, el valor no se puede establecer en 0, a menos que el campo sea opcional. Ref.: https://protobuf.dev/programming-guides/proto3/#default Índice del primer carácter (inclusive).
end

string (int64 format)

Es el índice del último carácter (exclusivo).

SdpDeidentifyResult

Resultado de la desidentificación de la Protección de datos sensibles.

Representación JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "data": {
    object (DataItem)
  },
  "transformedBytes": string
}
Campos
executionState

enum (FilterExecutionState)

Solo salida. Informa si la desidentificación de Sensitive Data Protection se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales que corresponden al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para la desidentificación de Sensitive Data Protection. El valor es MATCH_FOUND si el contenido está desidentificado.
data

object (DataItem)

Datos desidentificados
transformedBytes

string (int64 format)

Es el tamaño total en bytes que se transformó durante la anonimización.

PiAndJailbreakFilterResult

Resultado del filtro de inyección de instrucciones y jailbreak.

Representación JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
Campos
executionState

enum (FilterExecutionState)

Solo salida. Informa si el filtro de inyección de instrucciones y jailbreak se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales correspondientes al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para la inyección de instrucciones y el jailbreak.
confidenceLevel

enum (DetectionConfidenceLevel)

Nivel de confianza identificado para la inyección de instrucciones y el jailbreak.

MaliciousUriFilterResult

Resultado del filtro de URI malicioso

Representación JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "maliciousUriMatchedItems": [
    {
      object (MaliciousUriMatchedItem)
    }
  ]
}
Campos
executionState

enum (FilterExecutionState)

Solo salida. Informa si el filtro de URI malicioso se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales correspondientes al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para este URI malicioso. El valor es MATCH_FOUND si se encuentra al menos un URI malicioso.
maliciousUriMatchedItems[]

object (MaliciousUriMatchedItem)

Es la lista de URIs maliciosos que se encontraron en los datos.

MaliciousUriMatchedItem

Información sobre el URI malicioso y su ubicación dentro del contenido de entrada.

Representación JSON 
{
  "uri": string,
  "locations": [
    {
      object (RangeInfo)
    }
  ]
}
Campos
uri

string

URI malicioso.
locations[]

object (RangeInfo)

Es la lista de ubicaciones en las que se identifica el URI malicioso. El campo locations solo es compatible con el contenido de texto sin formato, es decir, ByteItemType.PLAINTEXT_UTF8.

CsamFilterResult

Resultado del filtro de CSAM (material de abuso sexual infantil)

Representación JSON 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState)
}
Campos
executionState

enum (FilterExecutionState)

Solo salida. Informa si el filtro de CSAM se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales correspondientes al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para CSAM.

VirusScanFilterResult

Resultados del análisis de virus

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

enum (FilterExecutionState)

Solo salida. Informa si el análisis de virus se ejecutó correctamente o no.
messageItems[]

object (MessageItem)

Son mensajes opcionales correspondientes al resultado. Un mensaje puede proporcionar advertencias o detalles de errores. Por ejemplo, si se omite el estado de ejecución, este campo proporciona el motivo o la explicación relacionados.
matchState

enum (FilterMatchState)

Solo salida. Estado de coincidencia para Virus. El valor es MATCH_FOUND si los datos están infectados con un virus.
scannedContentType

enum (ScannedContentType)

Tipo de contenido analizado.
virusDetails[]

object (VirusDetail)

Es la lista de los virus identificados. Este campo estará vacío si no se detectó ningún virus.
scannedSize

string (int64 format)

Es el tamaño del contenido analizado, expresado en bytes.

ScannedContentType

Tipo de contenido analizado.

Enums
SCANNED_CONTENT_TYPE_UNSPECIFIED Sin usar
UNKNOWN Contenido desconocido
PLAINTEXT Texto sin formato
PDF Solo se admite el escaneo de PDF para PDF.

VirusDetail

Detalles de un virus identificado

Representación JSON 
{
  "vendor": string,
  "names": [
    string
  ],
  "threatType": enum (ThreatType)
}
Campos
vendor

string

Es el nombre del proveedor que produjo esta identificación de virus.
names[]

string

Nombres de este virus.
threatType

enum (ThreatType)

Tipo de amenaza del virus identificado

ThreatType

Define todos los tipos de amenazas de un virus.

Enums
THREAT_TYPE_UNSPECIFIED Sin usar
UNKNOWN No se puede categorizar la amenaza
VIRUS_OR_WORM Amenaza de virus o gusano
MALICIOUS_PROGRAM Programa malicioso p. ej., software espía o troyano
POTENTIALLY_HARMFUL_CONTENT Contenido potencialmente dañino p.ej., Código insertado, Macro
POTENTIALLY_UNWANTED_CONTENT Contenido potencialmente no deseado P. ej., software publicitario

InvocationResult

Es un campo que indica el resultado de la invocación, independientemente del estado de coincidencia.

Enums
INVOCATION_RESULT_UNSPECIFIED No usuado. Valor predeterminado
SUCCESS Se invocaron correctamente todos los filtros.
PARTIAL Se omitieron algunos filtros o no se pudieron aplicar.
FAILURE Se omitieron o fallaron todos los filtros.

SanitizationMetadata

Mensaje que describe los metadatos de limpieza.

Representación JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Campos
errorCode

string (int64 format)

Código de error, si corresponde
errorMessage

string

Mensaje de error, si corresponde