Members
(static) Annotation :number
Enum that reprensents the types of annotations.
Properties:
| Name | Type | Description |
|---|---|---|
ANNOTATION_UNSPECIFIED |
number |
Default unspecified type. |
LEGITIMATE |
number |
Provides information that the event turned out to be legitimate. |
FRAUDULENT |
number |
Provides information that the event turned out to be fraudulent. |
(static) ClassificationReason :number
LINT.IfChange(classification_reason) Reasons contributing to the risk analysis verdict.
Properties:
| Name | Type | Description |
|---|---|---|
CLASSIFICATION_REASON_UNSPECIFIED |
number |
Default unspecified type. |
AUTOMATION |
number |
The event appeared to be automated. |
UNEXPECTED_ENVIRONMENT |
number |
The event was not made from the proper context on the real site. |
UNEXPECTED_USAGE_PATTERNS |
number |
Browsing behavior leading up to the event was generated was out of the ordinary. |
PROVISIONAL_RISK_ANALYSIS |
number |
Too little traffic has been received from this site thus far to generate quality risk analysis. |
(static) InvalidReason :number
Enum that represents the types of invalid token reasons.
Properties:
| Name | Type | Description |
|---|---|---|
INVALID_REASON_UNSPECIFIED |
number |
Default unspecified type. |
UNKNOWN_INVALID_REASON |
number |
If the failure reason was not accounted for. |
MALFORMED |
number |
The provided user verification token was malformed. |
EXPIRED |
number |
The user verification token had expired. |
DUPE |
number |
The user verification had already been seen. |
SITE_MISMATCH |
number |
The user verification token did not match the provided site secret. This may be a configuration error (e.g. development keys used in production) or end users trying to use verification tokens from other sites. |
MISSING |
number |
The user verification token was not present. It is a required input. |
Type Definitions
AnnotateAssessmentRequest
The request message to annotate an Assessment.
Properties:
| Name | Type | Description |
|---|---|---|
name |
string |
Required. The resource name of the Assessment, in the format "projects/{project_number}/assessments/{assessment_id}". |
annotation |
number |
The annotation that will be assigned to the Event. The number should be among the values of Annotation |
- Source:
- See:
AnnotateAssessmentResponse
Empty response for AnnotateAssessment.
- Source:
- See:
Assessment
A recaptcha assessment resource.
Properties:
| Name | Type | Description |
|---|---|---|
name |
string |
Output only. The resource name for the Assessment in the format "projects/{project_number}/assessments/{assessment_id}". |
event |
Object |
The event being assessed. This object should have the same structure as Event |
score |
number |
Output only. Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic). |
tokenProperties |
Object |
Output only. Properties of the provided event token. This object should have the same structure as TokenProperties |
reasons |
Array.<number> |
Output only. Reasons contributing to the risk analysis verdict. The number should be among the values of ClassificationReason |
- Source:
- See:
CreateAssessmentRequest
The create assessment request message.
Properties:
| Name | Type | Description |
|---|---|---|
parent |
string |
Required. The name of the project in which the assessment will be created, in the format "projects/{project_number}". |
assessment |
Object |
The asessment details. This object should have the same structure as Assessment |
- Source:
- See:
Event
Properties:
| Name | Type | Description |
|---|---|---|
token |
string |
The user response token provided by the reCAPTCHA client-side integration on your site. |
siteKey |
string |
The site key that was used to invoke reCAPTCHA on your site and generate the token. |
- Source:
- See:
TokenProperties
Properties:
| Name | Type | Description |
|---|---|---|
valid |
boolean |
Output only. Whether the provided user response token is valid. |
invalidReason |
number |
Output only. Reason associated with the response when valid = false. The number should be among the values of InvalidReason |
createTime |
Object |
Output only. The timestamp corresponding to the generation of the token. This object should have the same structure as Timestamp |
hostname |
string |
Output only. The hostname of the page on which the token was generated. |
action |
string |
Output only. Action name provided at token generation. |