註冊派對

本頁面會引導您完成下列步驟，註冊及取消註冊參與者，以便建立預測結果：

確認您已準備好註冊政黨
準備派對登記表
使用 projects.locations.instances.importRegisteredParties 方法註冊或取消註冊當事人
驗證方法回應
(選用) 匯出已註冊當事人表格

事前準備

開始之前，您需要有 AML AI 執行個體。

如要讓模型建立風險評分預測，請先註冊當事人。建議您在具備下列條件時註冊當事人：

一或多個資料集
經過調整、訓練及回溯測試的模型

何時登記派對

如要為當事人建立預測，您必須先註冊當事人，才能使用資料集。訓練、調整或回溯測試時，不需要註冊。

在正式或測試 (平行) 階段，預測結果可用於調查客戶是否涉及洗錢。您也可以根據預測結果，建立自己的管理和模型分析程序。

註冊方須為每位註冊方支付額外月費 (詳情請參閱定價頁面)。

如何準備政黨登記表

如要瞭解如何註冊參與者，請參閱定價頁面。

準備好要為當事人註冊的業務線表格。如果您已註冊部分當事人，這個當事人註冊表可能包含「當事人」表中的部分當事人，您想將這些當事人用於預測結果。

零售當事人結構定義

欄	類型	說明
`party_id`	`STRING`	執行個體資料集中的當事人專屬 ID
`party_size`	`STRING`	NULL；系統會忽略零售派對註冊的內容

商業當事人結構定義

欄類型說明

party_id STRING 執行個體資料集中的當事人專屬 ID

party_size

STRING

要求的訂位人數。等級是根據當事人在前 365 天的平均每月交易次數而定：

SMALL 適用於每月平均交易次數少於 500 次的小型商業機構
LARGE 適用於每月平均交易次數大於或等於 500 次的大型商業機構

所有值都區分大小寫。

如何登記政黨

每個 AML AI 執行個體都必須個別註冊參與者。注意事項：

零售和商業合作夥伴必須分別註冊。使用個別的 API 呼叫和個別的當事人註冊表。如果政黨同時出現在兩個清單中，則視為個別登記。
如要進行預測，所有參與者都必須向與所用引擎版本相關聯的業務線註冊。如果資料集包含任何未在同一業務線註冊的當事人，您就無法建立預測結果。
提供的當事人登記表可用於附加至執行個體中現有的登記當事人清單，或取代執行個體中提供的業務線所有登記當事人。
註冊後，一段時間內無法取消註冊 (請參閱價格頁面)。因此，您可以將 validateOnly 欄位設為 TRUE。您可以在這個欄位中查看方法的淨效應和回應，不必變更已註冊的當事人。驗證完成後，您可以重新執行作業，並將 validateOnly 參數設為 FALSE。
請務必檢查註冊要求的相關回應，確保所有參與者都已成功註冊，即使先前的 validateOnly 要求成功也一樣。
如果是商業合作夥伴註冊，合作夥伴註冊表格的 party_size 欄位中，如果值不是 SMALL 或 LARGE，就會觸發錯誤 (Invalid party_size present in table)。已註冊的合作夥伴不會更新。
如果是零售商註冊，系統會忽略 party_size 欄位，並註冊所提供註冊表格中的所有零售商。

如要匯入已註冊的當事人，請使用 projects.locations.instances.importRegisteredParties 方法。

(您也可以在「建立及管理執行個體」中查看下列資訊)。

這項工作需要的權限

如要執行這項工作，必須獲得下列權限：

權限

financialservices.v1instances.importRegisteredParties

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：IAM 設定中列出的專案 ID Google Cloud
LOCATION：執行個體的位置；請使用其中一個支援的區域
顯示地區
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID：使用者定義的執行個體 ID
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME：BigQuery 資料集，內含描述已註冊當事人的資料表
PARTY_REGISTRATION_TABLE：列出已註冊當事人的表格
注意：您可以提供多個列出已註冊當事人的表格。請為 partyTables 陣列中的每個資料表使用 "bq://{project}.{bqDatasetID}.{bqTableID}" 格式。
UPDATE_MODE：使用 REPLACE 將可移除的當事人取代為新當事人，或使用 APPEND 將新當事人新增至已註冊當事人資料表
LINE_OF_BUSINESS：這個欄位必須與lineOfBusiness引擎版本中引擎設定使用的值相符；商業銀行客戶 (法人和自然人) 請使用 COMMERCIAL，零售銀行客戶請使用 RETAIL

JSON 要求主體：

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

如要傳送要求，請選擇以下其中一個選項：

curl

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login 透過使用者帳戶登入 gcloud CLI，或是使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

cat > request.json << 'EOF'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

接著，請執行下列指令來傳送 REST 要求：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties"

PowerShell

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

@'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

接著，請執行下列指令來傳送 REST 要求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

如要瞭解如何取得長時間執行的作業 (LRO) 結果，請參閱管理長時間執行的作業。

註冊回應

LRO 完成後，回應會指出作業新增、移除或更新的當事人數量。

回覆欄位	類型	說明
`partiesAdded`	`integer`	這項作業新增的參與者人數
`partiesRemoved`	`integer`	這項作業移除的當事人人數
`partiesTotal`	`integer`	更新作業完成後，在此執行個體中註冊的當事人總數
`partiesUptiered`	`integer`	從小型升級為大型的商業當事人總數
`partiesDowntiered`	`integer`	從大型降級為小型商業派對的總數
`partiesFailedToDowntier`	`integer`	從大型降級至小型失敗的商業機構總數
`partiesFailedToRemove`	`integer`	這項作業無法移除的當事人數量

如何取消註冊當事人

系統會針對每個 AML AI 執行個體取消註冊當事人，方法是使用相同的 projects.locations.instances.importRegisteredParties 方法，並取代現有的當事人清單。將 mode 欄位設為 REPLACE。這項設定會取消註冊任何已註冊的當事人 (適用於所提供的業務線)，但這些當事人不屬於所提供的當事人註冊表。

取消註冊回應

作業完成後，請檢查 API 回應，確認作業是否達到預期結果，例如新增或移除的參與者人數，以及註冊參與者總數。

API 回應也會傳回因限制而無法移除的當事人數量；舉例來說，必須經過最少天數，才能取消註冊客戶。

匯出已註冊的當事人

如要匯出已註冊的當事人，請使用 projects.locations.instances.exportRegisteredParties 方法。

(您也可以在「建立及管理執行個體」中查看下列資訊)。

這項工作需要的權限

如要執行這項工作，必須獲得下列權限：

權限

financialservices.v1instances.exportRegisteredParties

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：IAM 設定中列出的專案 ID Google Cloud
LOCATION：執行個體的位置；請使用其中一個支援的區域
顯示地區
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID：使用者定義的執行個體 ID
BQ_OUTPUT_DATASET_NAME：要匯出資料表的 BigQuery 資料集，該資料表會說明已註冊的當事人
PARTY_REGISTRATION_TABLE：要將已註冊的當事人寫入的資料表
WRITE_DISPOSITION：如果目標資料表已存在，則會執行的動作；請使用下列其中一個值：
- WRITE_EMPTY：只有在 BigQuery 資料表為空白時，才能匯出資料。
- WRITE_TRUNCATE：先清除 BigQuery 資料表中的所有現有資料，再寫入資料表。
LINE_OF_BUSINESS：商業銀行客戶 (法人和自然人) 請使用 COMMERCIAL，零售銀行客戶請使用 RETAIL

JSON 要求主體：

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

cat > request.json << 'EOF'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

接著，請執行下列指令來傳送 REST 要求：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties"

PowerShell

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

@'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

接著，請執行下列指令來傳送 REST 要求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

如要瞭解如何取得長時間執行的作業 (LRO) 結果，請參閱管理長時間執行的作業。

這個方法會輸出具有下列結構定義的 BigQuery 資料表：

欄	類型	說明
`party_id`	`STRING`	執行個體資料集中的當事人專屬 ID
`party_size`	`STRING`	指定商業客戶的層級 (大型與小型)。這個欄位不適用於零售客戶。所有零售顧客的 `NULL` `SMALL` 適用於每月平均交易次數少於 500 次的小型商業機構 `LARGE` 適用於每月平均交易次數大於或等於 500 次的大型商業機構所有值都區分大小寫。
`earliest_remove_time`	`STRING`	最早可移除派對的時間
`party_with_prediction_intent`	`STRING`	指標：建議是否自註冊以來預測過政黨
`registration_or_uptier_time`	`STRING`	合作夥伴的註冊或升級時間

註冊派對 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

何時登記派對

如何準備政黨登記表

零售當事人結構定義

商業當事人結構定義

如何登記政黨

這項工作需要的權限

curl

PowerShell

註冊回應

如何取消註冊當事人

取消註冊回應

匯出已註冊的當事人

這項工作需要的權限

curl

PowerShell

註冊派對