注册您的客户

此页面会引导您按照以下步骤注册和取消注册 以便生成预测结果：

  1. 确保您已做好注册聚会的准备
  2. 准备政党登记表
  3. 使用 projects.locations.instances.importRegisteredParties 方法 方
  4. 验证方法响应
  5. （可选）导出注册方表格

准备工作

在开始之前，您需要 AML AI 实例。

如需使模型能够创建风险得分预测，您必须先注册 各方。我们建议您在拥有 以下：

何时注册合作方

您必须先在您的任一账号中为派对创建联想查询， 数据集、 您需要登记该派对。培训无需注册， 调整或回测。

预测结果用于调查以下国家/地区的客户进行洗钱活动： 生产或测试/并行阶段。

每个注册方每月都会产生额外的费用（请参阅 如需了解详情，请参阅“价格”页面）。

如何准备政党登记表

如需了解如何注册各方，请参阅价格页面。

为您要注册接收方的业务领域准备表格。 如果已经有人注册了 一些团体，那么此团体登记表 其中包含您要从Party（方）表中填写的 希望用于预测结果。

零售方架构

列类型说明
party_idSTRING实例数据集中一方的唯一标识符
party_sizeSTRINGNULL;内容会被忽略，供零售方注册使用

商业方架构

列类型说明
party_idSTRING实例数据集中一方的唯一标识符
party_sizeSTRING 请求的就餐人数。该层级根据 在过去 365 天内的用户： <ph type="x-smartling-placeholder">
    </ph>
  • 对于平均每月交易次数低于 500 笔的小型商业交易方，SMALL
  • LARGE（适用于平均每月交易次数大于或等于 500 笔）的大型商业方

所有值都区分大小写。

如何登记各方

各方需要分别为每个 AML AI 实例注册。注意事项：

  • 零售和商业方必须单独注册。单独使用 API 调用和单独的注册方表格。如果任一方同时参与 ，因此它们会被视为单独的注册。
  • 预测要求所有相关方注册 与所用引擎版本相关联的业务线。您不能 如果使用的数据集包含任何未涵盖的一方，则会创建预测结果 使用同一业务线进行注册。
  • 提供的注册方注册表用于附加到 实例中现有的注册方列表，或替换所有 。
  • 派对注册后，一段时间内无法注销（请参阅 “价格”页面）。因此，您可以将 validateOnly 字段设为 TRUE。通过此字段，您可以查看 方法，而无需更改注册方。验证完成后，您可以 重新运行该操作并将 validateOnly 参数设置为 FALSE。
  • 请务必检查注册请求的响应，确保每一方 即使之前的 validateOnly 请求也已成功注册 成功。
  • 对于商业方注册，此值应不是 SMALL 或 LARGE 方注册表中的party_size字段触发了错误 (Invalid party_size present in table).注册方不 已更新。
  • 对于零售方注册，party_size 字段会被忽略，并且所有 方注册。

要导入注册方，请使用 projects.locations.instances.importRegisteredParties 方法。

（ 创建和管理实例。）

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
  • LOCATION：实例的位置；使用以下任一 该 支持的区域
    显示位置
    • us-central1
    • us-east1
    • asia-south1
    • europe-west1
    • europe-west2
    • europe-west4
    • northamerica-northeast1
    • southamerica-east1
  • INSTANCE_ID：用户定义的实例标识符
  • BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME：a 包含描述注册方的表的 BigQuery 数据集
  • PARTY_REGISTRATION_TABLE：需要 列出注册方
  • 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

将请求正文保存在名为 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

将请求正文保存在名为 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 完成后，响应会显示 由操作添加、移除或更新的值。

响应字段类型说明
partiesAddedinteger 此操作添加的参与方数量
partiesRemovedinteger 此操作移除的正文数量
partiesTotalinteger 更新操作完成后，在此实例中注册的方总数 已完成
partiesUptieredinteger 从小到大增加的商业方总数
partiesDowntieredinteger 按照从大到小的顺序排列的商业方总数
partiesFailedToDowntierinteger 未能从大到小的商业方总数
partiesFailedToRemoveinteger 此操作未能移除的各方数

如何取消注册各方

对于每个 AML AI 实例，使用同一个 projects.locations.instances.importRegisteredParties 方法并替换现有的合作方列表。将 mode 字段设置为 REPLACE.此设置将取消注册任何当前注册的方（ 提供的业务范围以外的客户） 注册表。

注销响应

操作完成后，查看 API 响应 检查相应操作是否带来了预期结果，就数量 注册方总数，以及注册方总数。

API 响应还会返回无法删除的合作方的数量 （例如，由于要 方可以取消注册）。

导出注册方

如需导出注册方，请使用 projects.locations.instances.exportRegisteredParties 方法。

（ 创建和管理实例。）

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
  • LOCATION：实例的位置；使用以下任一 该 支持的区域
    显示位置
    • us-central1
    • us-east1
    • asia-south1
    • europe-west1
    • europe-west2
    • europe-west4
    • northamerica-northeast1
    • southamerica-east1
  • INSTANCE_ID：用户定义的实例标识符
  • BQ_OUTPUT_DATASET_NAME：a 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

将请求正文保存在名为 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_idSTRING实例数据集中一方的唯一标识符
party_sizeSTRING 为商业客户指定层级（大或小）。此字段不适用 零售客户。
  • 所有零售客户均可享受 NULL 优惠
  • 对于平均每月交易次数低于 500 笔的小型商业交易方，SMALL
  • LARGE（适用于平均每月交易次数大于或等于 500 笔）的大型商业方

所有值都区分大小写。

earliest_remove_timeSTRING可以删除当事方的最早时间
party_with_prediction_intentSTRING表明自注册以来是否预计会参加该派对的指示符
registration_or_uptier_timeSTRING方注册或升级的时间