assessments

Creates, updates, deletes, gets or lists an assessments resource.

Overview

Name	assessments
Type	Resource
Id	google.recaptchaenterprise.assessments

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create	insert	projectsId		Creates an Assessment of the likelihood an event is legitimate.
annotate	exec	projectsId, assessmentsId		Annotates a previously created Assessment to provide additional information on whether the event turned out to be authentic or fraudulent.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
assessmentsId	string
projectsId	string

INSERT examples

create

Creates an Assessment of the likelihood an event is legitimate.

INSERT INTO google.recaptchaenterprise.assessments (
data__assessmentEnvironment,
data__accountVerification,
data__privatePasswordLeakVerification,
data__event,
projectsId
)
SELECT 
'{{ assessmentEnvironment }}',
'{{ accountVerification }}',
'{{ privatePasswordLeakVerification }}',
'{{ event }}',
'{{ projectsId }}'
RETURNING
name,
accountDefenderAssessment,
accountVerification,
assessmentEnvironment,
event,
firewallPolicyAssessment,
fraudPreventionAssessment,
fraudSignals,
phoneFraudAssessment,
policyEvaluation,
privatePasswordLeakVerification,
riskAnalysis,
tokenProperties
;

Manifest

# Description fields are for documentation purposes
- name: assessments
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the assessments resource.
  - name: assessmentEnvironment
    description: |
      Optional. The environment creating the assessment. This describes your environment (the system invoking CreateAssessment), NOT the environment of your user.
    value:
      client: "{{ client }}"
      version: "{{ version }}"
  - name: accountVerification
    description: |
      Optional. Account verification information for identity verification. The assessment event must include a token and site key to use this feature.
    value:
      languageCode: "{{ languageCode }}"
      latestVerificationResult: "{{ latestVerificationResult }}"
      username: "{{ username }}"
      endpoints:
        - lastVerificationTime: "{{ lastVerificationTime }}"
          emailAddress: "{{ emailAddress }}"
          phoneNumber: "{{ phoneNumber }}"
          requestToken: "{{ requestToken }}"
  - name: privatePasswordLeakVerification
    description: |
      Optional. The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials.
    value:
      encryptedUserCredentialsHash: "{{ encryptedUserCredentialsHash }}"
      encryptedLeakMatchPrefixes:
        - "{{ encryptedLeakMatchPrefixes }}"
      lookupHashPrefix: "{{ lookupHashPrefix }}"
      reencryptedUserCredentialsHash: "{{ reencryptedUserCredentialsHash }}"
  - name: event
    description: |
      Optional. The event being assessed.
    value:
      hashedAccountId: "{{ hashedAccountId }}"
      ja3: "{{ ja3 }}"
      userAgent: "{{ userAgent }}"
      transactionData:
        paymentMethod: "{{ paymentMethod }}"
        items:
          - name: "{{ name }}"
            quantity: "{{ quantity }}"
            merchantAccountId: "{{ merchantAccountId }}"
            value: {{ value }}
        user:
          emailVerified: {{ emailVerified }}
          phoneNumber: "{{ phoneNumber }}"
          accountId: "{{ accountId }}"
          phoneVerified: {{ phoneVerified }}
          email: "{{ email }}"
          creationMs: "{{ creationMs }}"
        shippingAddress:
          address:
            - "{{ address }}"
          locality: "{{ locality }}"
          administrativeArea: "{{ administrativeArea }}"
          regionCode: "{{ regionCode }}"
          postalCode: "{{ postalCode }}"
          recipient: "{{ recipient }}"
        merchants:
          - emailVerified: {{ emailVerified }}
            phoneNumber: "{{ phoneNumber }}"
            accountId: "{{ accountId }}"
            phoneVerified: {{ phoneVerified }}
            email: "{{ email }}"
            creationMs: "{{ creationMs }}"
        currencyCode: "{{ currencyCode }}"
        transactionId: "{{ transactionId }}"
        gatewayInfo:
          gatewayResponseCode: "{{ gatewayResponseCode }}"
          cvvResponseCode: "{{ cvvResponseCode }}"
          avsResponseCode: "{{ avsResponseCode }}"
          name: "{{ name }}"
        cardBin: "{{ cardBin }}"
        cardLastFour: "{{ cardLastFour }}"
        billingAddress:
          address:
            - "{{ address }}"
          locality: "{{ locality }}"
          administrativeArea: "{{ administrativeArea }}"
          regionCode: "{{ regionCode }}"
          postalCode: "{{ postalCode }}"
          recipient: "{{ recipient }}"
        value: {{ value }}
        shippingValue: {{ shippingValue }}
      firewallPolicyEvaluation: {{ firewallPolicyEvaluation }}
      ja4: "{{ ja4 }}"
      expectedAction: "{{ expectedAction }}"
      requestedUri: "{{ requestedUri }}"
      siteKey: "{{ siteKey }}"
      express: {{ express }}
      headers:
        - "{{ headers }}"
      token: "{{ token }}"
      userInfo:
        createAccountTime: "{{ createAccountTime }}"
        userIds:
          - email: "{{ email }}"
            phoneNumber: "{{ phoneNumber }}"
            username: "{{ username }}"
        accountId: "{{ accountId }}"
      wafTokenAssessment: {{ wafTokenAssessment }}
      fraudPrevention: "{{ fraudPrevention }}"
      userIpAddress: "{{ userIpAddress }}"

Lifecycle Methods

annotate

Annotates a previously created Assessment to provide additional information on whether the event turned out to be authentic or fraudulent.

EXEC google.recaptchaenterprise.assessments.annotate 
@projectsId='{{ projectsId }}' --required, 
@assessmentsId='{{ assessmentsId }}' --required 
@@json=
'{
"reasons": "{{ reasons }}", 
"annotation": "{{ annotation }}", 
"hashedAccountId": "{{ hashedAccountId }}", 
"accountId": "{{ accountId }}", 
"phoneAuthenticationEvent": "{{ phoneAuthenticationEvent }}", 
"transactionEvent": "{{ transactionEvent }}"
}'
;