SanitizationResult

Hasil pembersihan setelah menerapkan semua filter pada konten input.

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

enum (FilterMatchState)

Hanya output. Status pencocokan filter secara keseluruhan untuk Pembersihan. Status dapat memiliki dua nilai di bawah.

1) NO_MATCH_FOUND: Tidak ada filter dalam konfigurasi yang memenuhi kriteria pencocokan. Dengan kata lain, input lolos dari semua filter.

2) MATCH_FOUND: Setidaknya satu filter dalam konfigurasi memenuhi pencocokan. Dengan kata lain, input tidak lulus satu atau beberapa filter.
filterResults

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

Hanya output. Hasil untuk semua filter dengan kunci adalah nama filter - "csam", "malicious_uris", "rai", "pi_and_jailbreak" ,"sdp".

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
invocationResult

enum (InvocationResult)

Hanya output. Kolom yang menunjukkan hasil pemanggilan, terlepas dari status kecocokan. Dapat memiliki tiga nilai berikut: BERHASIL: Semua filter berhasil dieksekusi. SEBAGIAN: Beberapa filter dilewati atau gagal dieksekusi. KEGAGALAN: Semua filter dilewati atau gagal dieksekusi.
sanitizationMetadata

object (SanitizationMetadata)

Hanya output. Metadata yang terkait dengan Sanitasi.

FilterMatchState

Opsi untuk menentukan status pencocokan filter.

Enum
FILTER_MATCH_STATE_UNSPECIFIED Tidak terpakai
NO_MATCH_FOUND Kriteria pencocokan tidak tercapai untuk filter.
MATCH_FOUND Kriteria pencocokan tercapai untuk filter.

FilterResult

Hasil Filter yang diperoleh setelah operasi Sanitasi.

Representasi 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.
}
Kolom
Kolom union filter_result. Mengenkapsulasi salah satu hasil filter terkait Responsible AI, Sensitive Data Protection, Prompt Injection dan Jailbreak, Malicious URI, CSAM, Virus Scan. filter_result hanya ada berupa salah satu diantara berikut:
raiFilterResult

object (RaiFilterResult)

Hasil filter Responsible AI.
sdpFilterResult

object (SdpFilterResult)

Hasil Sensitive Data Protection.
piAndJailbreakFilterResult

object (PiAndJailbreakFilterResult)

Injeksi perintah dan hasil filter Jailbreak.
maliciousUriFilterResult

object (MaliciousUriFilterResult)

Hasil filter URI berbahaya.
csamFilterFilterResult

object (CsamFilterResult)

Hasil filter CSAM.
virusScanFilterResult

object (VirusScanFilterResult)

Hasil pemindaian virus.

RaiFilterResult

Hasil Responsible AI.

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah filter RAI berhasil dieksekusi atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status pencocokan filter secara keseluruhan untuk RAI. Nilainya adalah MATCH_FOUND jika setidaknya satu tingkat keyakinan filter RAI sama dengan atau lebih tinggi dari tingkat keyakinan yang ditentukan dalam konfigurasi.
raiFilterTypeResults

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

Peta hasil filter RAI dengan kunci adalah jenis filter RAI - "sexually_explicit", "hate_speech", "harassment", "dangerous".

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FilterExecutionState

Enum yang melaporkan apakah filter tertentu berhasil dieksekusi atau tidak.

Enum
FILTER_EXECUTION_STATE_UNSPECIFIED Tidak terpakai
EXECUTION_SUCCESS Filter berhasil dieksekusi
EXECUTION_SKIPPED Eksekusi filter dilewati. Hal ini dapat terjadi karena error sisi server atau masalah izin.

MessageItem

Item pesan untuk melaporkan informasi, peringatan, atau pesan error.

Representasi JSON 
{
  "messageType": enum (MessageType),
  "message": string
}
Kolom
messageType

enum (MessageType)

Jenis pesan.
message

string

Konten pesan.

MessageType

Opsi untuk menentukan jenis pesan.

Enum
MESSAGE_TYPE_UNSPECIFIED Tidak terpakai
INFO Pesan terkait informasi.
WARNING Pesan terkait peringatan.
ERROR Pesan kesalahan.

RaiFilterTypeResult

Hasil Filter mendetail untuk setiap Jenis Filter responsible AI.

Representasi JSON 
{
  "filterType": enum (RaiFilterType),
  "confidenceLevel": enum (DetectionConfidenceLevel),
  "matchState": enum (FilterMatchState)
}
Kolom
filterType

enum (RaiFilterType)

Jenis filter responsible AI.
confidenceLevel

enum (DetectionConfidenceLevel)

Tingkat keyakinan yang diidentifikasi untuk filter RAI ini.
matchState

enum (FilterMatchState)

Hanya output. Status kecocokan untuk filter RAI ini.

SdpFilterResult

Hasil filter Perlindungan Data Sensitif.

Representasi 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.
}
Kolom
Kolom union result. Hasil Pemeriksaan Perlindungan Data Sensitif atau hasil De-identifikasi. result hanya ada berupa salah satu diantara berikut:
inspectResult

object (SdpInspectResult)

Hasil Pemeriksaan Perlindungan Data Sensitif jika pemeriksaan dilakukan.
deidentifyResult

object (SdpDeidentifyResult)

Hasil De-identifikasi Perlindungan Data Sensitif jika de-identifikasi dilakukan.

SdpInspectResult

Hasil Pemeriksaan Perlindungan Data Sensitif.

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah pemeriksaan Sensitive Data Protection berhasil dijalankan atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status pencocokan untuk Inspeksi SDP. Nilainya adalah MATCH_FOUND jika setidaknya satu temuan Sensitive Data Protection diidentifikasi.
findings[]

object (SdpFinding)

Daftar temuan Sensitive Data Protection.
findingsTruncated

boolean

Jika benar, ada kemungkinan bahwa lebih banyak temuan diidentifikasi dan temuan yang ditampilkan adalah subset dari semua temuan. Daftar temuan mungkin terpotong karena item input terlalu besar, atau karena server mencapai jumlah maksimum resource yang diizinkan untuk satu panggilan API.

SdpFinding

Menemukan yang sesuai dengan filter Perlindungan Data Sensitif.

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

string

Nama jenis info Perlindungan Data Sensitif untuk temuan ini.
likelihood

enum (SdpFindingLikelihood)

Probabilitas keyakinan yang diidentifikasi untuk infoType.
location

object (SdpFindingLocation)

Lokasi untuk temuan ini.

SdpFindingLikelihood

Untuk mengetahui informasi selengkapnya tentang setiap tingkat kemungkinan Perlindungan Data Sensitif, lihat https://cloud.google.com/sensitive-data-protection/docs/likelihood.

Enum
SDP_FINDING_LIKELIHOOD_UNSPECIFIED Nilai default; sama dengan POSSIBLE.
VERY_UNLIKELY Peluang tertinggi untuk positif palsu.
UNLIKELY Peluang tinggi untuk positif palsu.
POSSIBLE Beberapa sinyal yang cocok. Nilai default.
LIKELY Peluang positif palsu rendah.
VERY_LIKELY Tingkat keyakinan tinggi. Peluang positif palsu terendah.

SdpFindingLocation

Lokasi Temuan Perlindungan Data Sensitif ini dalam konten input.

Representasi JSON 
{
  "byteRange": {
    object (RangeInfo)
  },
  "codepointRange": {
    object (RangeInfo)
  }
}
Kolom
byteRange

object (RangeInfo)

Offset byte berbasis nol yang membatasi temuan. Ini relatif terhadap elemen penampung temuan. Perhatikan bahwa jika konten bukan tekstual, ini akan mereferensikan representasi tekstual konten yang dienkode UTF-8.
codepointRange

object (RangeInfo)

Offset karakter Unicode yang membatasi temuan. Ini relatif terhadap elemen penampung temuan. Diberikan jika kontennya berupa teks.

RangeInfo

Interval rentang setengah terbuka [start, end)

Representasi JSON 
{
  "start": string,
  "end": string
}
Kolom
start

string (int64 format)

Untuk proto3, nilai tidak dapat ditetapkan ke 0 kecuali jika kolom bersifat opsional. Ref: https://protobuf.dev/programming-guides/proto3/#default Indeks karakter pertama (inklusif).
end

string (int64 format)

Indeks karakter terakhir (eksklusif).

SdpDeidentifyResult

Hasil De-identifikasi Perlindungan Data Sensitif.

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah de-identifikasi Sensitive Data Protection berhasil dijalankan atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status kecocokan untuk De-identifikasi Perlindungan Data Sensitif. Nilainya adalah MATCH_FOUND jika konten dide-identifikasi.
data

object (DataItem)

Data yang telah dide-identifikasi.
transformedBytes

string (int64 format)

Total ukuran dalam byte yang ditransformasi selama deidentifikasi.

PiAndJailbreakFilterResult

Injeksi perintah dan Hasil Filter Jailbreak.

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah injeksi Perintah dan filter Jailbreak berhasil dieksekusi atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status pencocokan untuk Injeksi perintah dan Jailbreak.
confidenceLevel

enum (DetectionConfidenceLevel)

Tingkat keyakinan yang diidentifikasi untuk Injeksi perintah dan Jailbreak.

MaliciousUriFilterResult

Hasil Filter URI Berbahaya.

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah filter URI Berbahaya berhasil dieksekusi atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status pencocokan untuk URI Berbahaya ini. Nilainya adalah MATCH_FOUND jika setidaknya satu URI Berbahaya ditemukan.
maliciousUriMatchedItems[]

object (MaliciousUriMatchedItem)

Daftar URI Berbahaya yang ditemukan dalam data.

MaliciousUriMatchedItem

Informasi terkait URI berbahaya dan lokasinya dalam konten input.

Representasi JSON 
{
  "uri": string,
  "locations": [
    {
      object (RangeInfo)
    }
  ]
}
Kolom
uri

string

URI berbahaya.
locations[]

object (RangeInfo)

Daftar lokasi tempat URI Berbahaya diidentifikasi. Kolom locations hanya didukung untuk konten teks biasa, yaitu ByteItemType.PLAINTEXT_UTF8

CsamFilterResult

Hasil Filter CSAM (Materi Pelecehan terhadap Anak-Anak)

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah filter CSAM berhasil dieksekusi atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status pencocokan untuk CSAM.

VirusScanFilterResult

Hasil pemindaian virus.

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

enum (FilterExecutionState)

Hanya output. Melaporkan apakah Pemindaian Virus berhasil dijalankan atau tidak.
messageItems[]

object (MessageItem)

Pesan opsional yang sesuai dengan hasil. Pesan dapat memberikan peringatan atau detail error. Misalnya, jika status eksekusi dilewati, kolom ini akan memberikan alasan/penjelasan terkait.
matchState

enum (FilterMatchState)

Hanya output. Status pencocokan untuk Virus. Nilainya adalah MATCH_FOUND jika data terinfeksi virus.
scannedContentType

enum (ScannedContentType)

Jenis konten yang dipindai.
virusDetails[]

object (VirusDetail)

Daftar Virus yang diidentifikasi. Kolom ini akan kosong jika tidak ada virus yang terdeteksi.
scannedSize

string (int64 format)

Ukuran konten yang dipindai dalam byte.

ScannedContentType

Jenis konten yang dipindai.

Enum
SCANNED_CONTENT_TYPE_UNSPECIFIED Tidak terpakai
UNKNOWN Konten tidak diketahui
PLAINTEXT Teks biasa
PDF Pemindaian PDF hanya untuk PDF yang didukung.

VirusDetail

Detail virus yang teridentifikasi

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

string

Nama vendor yang menghasilkan identifikasi virus ini.
names[]

string

Nama Virus ini.
threatType

enum (ThreatType)

Jenis ancaman virus yang teridentifikasi

ThreatType

Menentukan semua jenis ancaman virus

Enum
THREAT_TYPE_UNSPECIFIED Tidak terpakai
UNKNOWN Tidak dapat mengategorikan ancaman
VIRUS_OR_WORM Ancaman Virus atau Worm.
MALICIOUS_PROGRAM Program berbahaya. Misalnya, Spyware, Trojan.
POTENTIALLY_HARMFUL_CONTENT Konten yang berpotensi berbahaya. Misalnya, Kode yang dimasukkan, Makro
POTENTIALLY_UNWANTED_CONTENT Konten yang berpotensi tidak diinginkan. Misalnya, Adware.

InvocationResult

Kolom yang menunjukkan hasil pemanggilan, terlepas dari status kecocokan.

Enum
INVOCATION_RESULT_UNSPECIFIED Tidak digunakan. Nilai default.
SUCCESS Semua filter berhasil dipanggil.
PARTIAL Beberapa filter dilewati atau gagal.
FAILURE Semua filter dilewati atau gagal.

SanitizationMetadata

Pesan yang menjelaskan metadata Sanitasi.

Representasi JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Kolom
errorCode

string (int64 format)

Kode error, jika ada.
errorMessage

string

Pesan error, jika ada.