Diese Seite wurde von der Cloud Translation API übersetzt.

Kunden registrieren

Auf dieser Seite werden Sie durch die folgenden Schritte geführt, um Parteien zu registrieren und ihre Registrierung aufzuheben, um Vorhersageergebnisse zu erstellen:

Bereite dich für die Registrierung von Parteien vor
Tabellen für die Parteiregistrierung vorbereiten
Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um Parteien zu registrieren oder ihre Registrierung aufzuheben.
Methodenantwort validieren
Tabelle mit registrierten Parteien exportieren (optional)

Hinweise

Bevor Sie beginnen, benötigen Sie eine AML AI-Instanz.

Damit ein Modell Risikobewertungsvorhersagen erstellen kann, müssen Sie zuerst Parteien registrieren. Wir empfehlen die Registrierung von Parteien, wenn Sie bereits Folgendes haben:

Ein oder mehrere Datasets
Abgestimmtes, trainiertes und rückgetestetes Modell

Wann werden Parteien registriert?

Bevor Sie Vorhersagen für eine Party in einem Ihrer Datasets erstellen können, müssen Sie die Partei registrieren. Für Training, Feinabstimmung oder Backtests ist keine Registrierung erforderlich.

Die Vorhersageergebnisse werden zur Untersuchung von Kunden bezüglich Geldwäsche entweder in einer Produktions- oder in einer Test-/parallelen Phase verwendet.

Registrierende Parteien verursachen zusätzliche monatliche Kosten pro registrierter Partei. Weitere Informationen finden Sie auf der Seite „Preise“.

Tabellen für die Parteiregistrierung vorbereiten

Informationen zur Registrierung von Parteien finden Sie auf der Preisseite.

Bereiten Sie eine Tabelle für den Geschäftsbereich vor, für den Sie Parteien registrieren möchten. Diese Tabelle zur Parteiregistrierung kann eine Teilmenge der Tabelle Party sein.

Schema für Einzelhandelsparteien

Spalte	Typ	Beschreibung
`party_id`	`STRING`	Eindeutige Kennung der Partei in den Datasets der Instanz
`party_size`	`STRING`	NULL; Inhalte werden bei Einzelhandelsregistrierungen ignoriert

Schema für kommerzielle Parteien

Spalte Typ Beschreibung

party_id STRING Eindeutige Kennung der Partei in den Datasets der Instanz

party_size

STRING

Angeforderte Gruppengröße. Die Stufe basiert auf der durchschnittlichen Anzahl monatlicher Transaktionen für die Partei in den letzten 365 Tagen:

SMALL für kleine kommerzielle Parteien mit weniger als 500 durchschnittlichen monatlichen Transaktionen
LARGE für große kommerzielle Parteien mit durchschnittlich mehr als 500 monatlichen Transaktionen

Bei allen Werten wird zwischen Groß- und Kleinschreibung unterschieden.

Parteien registrieren

Parteien werden für jede AML AI-Instanz separat registriert. Wichtige Hinweise:

Einzelhandels- und gewerbliche Parteien müssen separat registriert werden. Verwenden Sie separate API-Aufrufe und Registrierungstabellen von Drittanbietern. Wenn eine Partei in beiden Listen enthalten ist, wird sie als separate Registrierungen betrachtet.
Für Vorhersagen müssen alle Parteien bei der Branche registriert sein, die der verwendeten Suchmaschinenversion zugeordnet ist. Sie können keine Vorhersageergebnisse erstellen, wenn ein Dataset verwendet wird, das eine Partei enthält, die nicht in derselben Branche registriert ist.
Die angegebene Tabelle für die Registrierung von Parteien wird verwendet, um entweder die vorhandene Liste der registrierten Parteien in der Instanz zu ergänzen oder alle registrierten Parteien für den angegebenen Geschäftszweig in der Instanz zu ersetzen.
Nach der Registrierung kann eine Partei einige Zeit lang nicht abgemeldet werden. Weitere Informationen finden Sie auf der Seite „Preise“. Aus diesem Grund können Sie das Feld validateOnly auf TRUE setzen. In diesem Feld können Sie den Nettoeffekt und die Antwort der Methode sehen, ohne die registrierten Parteien zu ändern. Nach der Validierung können Sie den Vorgang noch einmal ausführen und den Parameter validateOnly auf FALSE setzen.
Prüfe immer die Antwort auf eine Registrierungsanfrage, um sicherzugehen, dass alle Parteien registriert wurden, auch wenn eine vorherige validateOnly-Anfrage erfolgreich war.
Bei kommerziellen Parteien führt ein anderer Wert als SMALL oder LARGE im Feld party_size in der Tabelle zur Parteiregistrierung zu einem Fehler (Invalid party_size present in table). Registrierte Parteien werden nicht aktualisiert.
Bei Registrierungen von Einzelhandelsparteien wird das Feld party_size ignoriert und alle Parteien in der angegebenen Tabelle für die Registrierung von Parteien werden registriert.

Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um registrierte Parteien zu importieren.

Die folgenden Informationen stehen auch unter Instanzen erstellen und verwalten zur Verfügung.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
LOCATION: der Standort der Instanz. Verwenden Sie eine der unterstützten Regionen:
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: die benutzerdefinierte Kennung für die Instanz
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: ein BigQuery-Dataset mit einer Tabelle, die die registrierten Parteien beschreibt
REGISTERED_PARTIES_TABLE: die Tabelle mit den registrierten Parteien
Hinweis: Sie können mehrere Tabellen angeben, in denen die registrierten Parteien aufgeführt sind. Verwenden Sie für jede Tabelle im partyTables-Array das Format "bq://{project}.{bqDatasetID}.{bqTableID}".
UPDATE_MODE: Verwenden Sie REPLACE, um Parteien, die aus der Tabelle der registrierten Parteien entfernt werden können, durch neue Parteien zu ersetzen, oder APPEND, um der Tabelle der registrierten Parteien neue Parteien hinzuzufügen
LINE_OF_BUSINESS: Dieses Feld muss mit dem Wert lineOfBusiness in der Engine-Version übereinstimmen, die von der Engine-Konfiguration verwendet wird. Verwenden Sie COMMERCIAL für kommerzielle Bankkunden (Rechtssubjekte und natürliche Rechtssubjekte) oder RETAIL für Privatbankkunden.

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Informationen zum Abrufen des Ergebnisses eines Vorgangs mit langer Ausführungszeit finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Antwort auf die Registrierung

Wenn der Vorgang abgeschlossen ist, gibt die Antwort die Anzahl der Parteien an, die durch den Vorgang hinzugefügt, entfernt oder aktualisiert wurden.

Antwortfeld	Typ	Beschreibung
`partiesAdded`	`integer`	Anzahl der durch diesen Vorgang hinzugefügten Parteien
`partiesRemoved`	`integer`	Anzahl der Parteien, die durch diesen Vorgang entfernt wurden
`partiesTotal`	`integer`	Gesamtzahl der Parteien, die in dieser Instanz registriert sind, nachdem der Aktualisierungsvorgang abgeschlossen wurde
`partiesUptiered`	`integer`	Gesamtzahl der kommerziellen Parteien, die von klein auf groß aufgeteilt sind
`partiesDowntiered`	`integer`	Gesamtzahl der kommerziellen Parteien, die von groß zu klein unterteilt sind
`partiesFailedToDowntier`	`integer`	Gesamtzahl der kommerziellen Parteien, die nicht von groß auf klein heruntergestuft wurden
`partiesFailedToRemove`	`integer`	Anzahl der Parteien, die durch diesen Vorgang nicht entfernt werden konnten

Registrierung von Parteien aufheben

Die Registrierung von Parteien wird pro AML AI-Instanz mit derselben projects.locations.instances.importRegisteredParties-Methode aufgehoben und die vorhandene Liste der Parteien ersetzt. Legen Sie das Feld mode auf REPLACE fest. Mit dieser Einstellung werden alle derzeit registrierten Parteien (für die angegebene Branche) abgemeldet, die nicht in der Registrierungstabelle für bereitgestellte Parteien enthalten sind.

Antworten zur Abmeldung

Prüfen Sie nach Abschluss des Vorgangs in der API-Antwort, ob der Vorgang zum gewünschten Ergebnis geführt hat (in Bezug auf die Anzahl der hinzugefügten oder entfernten Parteien und die Gesamtzahl der registrierten Parteien).

Die API-Antwort gibt auch die Anzahl der Parteien zurück, die aufgrund von Einschränkungen nicht entfernt werden konnten (z. B. aufgrund der Mindestanzahl von Tagen, bis eine Partei abgemeldet werden kann).

Registrierte Parteien exportieren

Verwenden Sie die Methode projects.locations.instances.exportRegisteredParties, um registrierte Parteien zu exportieren.

Die folgenden Informationen stehen auch unter Instanzen erstellen und verwalten zur Verfügung.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
LOCATION: der Standort der Instanz. Verwenden Sie eine der unterstützten Regionen:
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: die benutzerdefinierte Kennung für die Instanz
BQ_OUTPUT_DATASET_NAME: ein BigQuery-Dataset, in das eine Tabelle exportiert werden soll, die die registrierten Parteien beschreibt
REGISTERED_PARTIES_TABLE: Tabelle, in die die registrierten Parteien geschrieben werden sollen
WRITE_DISPOSITION: Die Aktion, die ausgeführt wird, wenn die Zieltabelle bereits vorhanden ist. Verwenden Sie einen der folgenden Werte:
- WRITE_EMPTY: Nur Daten exportieren, wenn die Zieltabelle leer ist.
- WRITE_TRUNCATE: Alle vorhandenen Daten in der BigQuery-Tabelle werden gelöscht, bevor in die Tabelle geschrieben wird.
LINE_OF_BUSINESS: Verwenden Sie COMMERCIAL für Geschäftsbanken (Rechtssubjekte und natürliche Rechtssubjekte) oder RETAIL für Privatbankkunden.

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Informationen zum Abrufen des Ergebnisses eines Vorgangs mit langer Ausführungszeit finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Diese Methode gibt eine BigQuery-Tabelle mit dem folgenden Schema aus:

Spalte	Typ	Beschreibung
`party_id`	`STRING`	Eindeutige Kennung der Partei in den Datasets der Instanz
`party_size`	`STRING`	Gibt die Stufe für kommerzielle Kunden an (groß oder klein). Dieses Feld gilt nicht für Einzelhandelskunden. `NULL` für alle Einzelhandelskunden `SMALL` für kleine kommerzielle Parteien mit weniger als 500 durchschnittlichen monatlichen Transaktionen `LARGE` für große kommerzielle Parteien mit durchschnittlich mehr als 500 monatlichen Transaktionen Bei allen Werten wird zwischen Groß- und Kleinschreibung unterschieden.
`earliest_remove_time`	`STRING`	Zeitpunkt, zu dem die Partei frühestens entfernt werden kann
`party_with_prediction_intent`	`STRING`	Anzeige, die anzeigt, ob eine Partei seit der Registrierung vorhergesagt wurde
`registration_or_uptier_time`	`STRING`	Der Zeitpunkt, zu dem die Partei registriert oder hochgestuft wurde