feat(recaptchaenterprise): update the api

#### recaptchaenterprise:v1 The following keys were added: - schemas.GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest.properties.transactionEvent.$ref (Total Keys: 1) - schemas.GoogleCloudRecaptchaenterpriseV1TransactionEvent (Total Keys: 8)
googleapis · Feb 1, 2023 · 1fb028c · 1fb028c
1 parent 43e09ec
commit 1fb028c
Show file tree

Hide file tree

Showing 2 changed files with 87 additions and 10 deletions.
diff --git a/docs/dyn/recaptchaenterprise_v1.projects.assessments.html b/docs/dyn/recaptchaenterprise_v1.projects.assessments.html
@@ -99,6 +99,12 @@ <h3>Method Details</h3>
   &quot;reasons&quot;: [ # Optional. Optional reasons for the annotation that will be assigned to the Event.
     &quot;A String&quot;,
   ],
+  &quot;transactionEvent&quot;: { # Describes an event in the lifecycle of a payment transaction. # Optional. If the Assessment is part of a Payment Transaction, provide details on Payment Lifecycle Events that occur in the Transaction.
+    &quot;eventTime&quot;: &quot;A String&quot;, # Optional. Timestamp when this transaction event occurred; otherwise assumed to be the time of the API call.
+    &quot;eventType&quot;: &quot;A String&quot;, # Optional. The type of this transaction event.
+    &quot;reason&quot;: &quot;A String&quot;, # Optional. The reason or standardized code which corresponds with this transaction event, if one exists. E.g. a CHARGEBACK Event with code 4553.
+    &quot;value&quot;: 3.14, # Optional. The value that corresponds with this transaction event, if one exists. E.g. A refund event where $5.00 was refunded. Currency is obtained from the original transaction data.
+  },
 }
 
   x__xgafv: string, V1 error format.
@@ -127,7 +133,7 @@ <h3>Method Details</h3>
   body: object, The request body.
     The object takes the form of:
 
-{ # A recaptcha assessment resource.
+{ # A reCAPTCHA Enterprise assessment resource.
   &quot;accountDefenderAssessment&quot;: { # Account defender risk assessment. # Assessment returned by account defender when a hashed_account_id is provided.
     &quot;labels&quot;: [ # Labels for this request.
       &quot;A String&quot;,
@@ -149,8 +155,8 @@ <h3>Method Details</h3>
   &quot;event&quot;: { # The event being assessed.
     &quot;expectedAction&quot;: &quot;A String&quot;, # Optional. The expected action for this type of event. This should be the same action provided at token generation time on client-side platforms already integrated with recaptcha enterprise.
     &quot;hashedAccountId&quot;: &quot;A String&quot;, # Optional. Unique stable hashed user identifier for the request. The identifier must be hashed using hmac-sha256 with stable secret.
-    &quot;siteKey&quot;: &quot;A String&quot;, # Optional. The site key that was used to invoke reCAPTCHA on your site and generate the token.
-    &quot;token&quot;: &quot;A String&quot;, # Optional. The user response token provided by the reCAPTCHA client-side integration on your site.
+    &quot;siteKey&quot;: &quot;A String&quot;, # Optional. The site key that was used to invoke reCAPTCHA Enterprise on your site and generate the token.
+    &quot;token&quot;: &quot;A String&quot;, # Optional. The user response token provided by the reCAPTCHA Enterprise client-side integration on your site.
     &quot;userAgent&quot;: &quot;A String&quot;, # Optional. The user agent present in the request from the user&#x27;s device related to this event.
     &quot;userIpAddress&quot;: &quot;A String&quot;, # Optional. The IP address in the request from the user&#x27;s device related to this event.
   },
@@ -188,7 +194,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # A recaptcha assessment resource.
+    { # A reCAPTCHA Enterprise assessment resource.
   &quot;accountDefenderAssessment&quot;: { # Account defender risk assessment. # Assessment returned by account defender when a hashed_account_id is provided.
     &quot;labels&quot;: [ # Labels for this request.
       &quot;A String&quot;,
@@ -210,8 +216,8 @@ <h3>Method Details</h3>
   &quot;event&quot;: { # The event being assessed.
     &quot;expectedAction&quot;: &quot;A String&quot;, # Optional. The expected action for this type of event. This should be the same action provided at token generation time on client-side platforms already integrated with recaptcha enterprise.
     &quot;hashedAccountId&quot;: &quot;A String&quot;, # Optional. Unique stable hashed user identifier for the request. The identifier must be hashed using hmac-sha256 with stable secret.
-    &quot;siteKey&quot;: &quot;A String&quot;, # Optional. The site key that was used to invoke reCAPTCHA on your site and generate the token.
-    &quot;token&quot;: &quot;A String&quot;, # Optional. The user response token provided by the reCAPTCHA client-side integration on your site.
+    &quot;siteKey&quot;: &quot;A String&quot;, # Optional. The site key that was used to invoke reCAPTCHA Enterprise on your site and generate the token.
+    &quot;token&quot;: &quot;A String&quot;, # Optional. The user response token provided by the reCAPTCHA Enterprise client-side integration on your site.
     &quot;userAgent&quot;: &quot;A String&quot;, # Optional. The user agent present in the request from the user&#x27;s device related to this event.
     &quot;userIpAddress&quot;: &quot;A String&quot;, # Optional. The IP address in the request from the user&#x27;s device related to this event.
   },

diff --git a/googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json b/googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json
@@ -514,7 +514,7 @@
       }
     }
   },
-  "revision": "20230121",
+  "revision": "20230129",
   "rootUrl": "https://recaptchaenterprise.googleapis.com/",
   "schemas": {
     "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": {
@@ -681,6 +681,10 @@
             "type": "string"
           },
           "type": "array"
+        },
+        "transactionEvent": {
+          "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionEvent",
+          "description": "Optional. If the Assessment is part of a Payment Transaction, provide details on Payment Lifecycle Events that occur in the Transaction."
         }
       },
       "type": "object"
@@ -692,7 +696,7 @@
       "type": "object"
     },
     "GoogleCloudRecaptchaenterpriseV1Assessment": {
-      "description": "A recaptcha assessment resource.",
+      "description": "A reCAPTCHA Enterprise assessment resource.",
       "id": "GoogleCloudRecaptchaenterpriseV1Assessment",
       "properties": {
         "accountDefenderAssessment": {
@@ -795,11 +799,11 @@
           "type": "string"
         },
         "siteKey": {
-          "description": "Optional. The site key that was used to invoke reCAPTCHA on your site and generate the token.",
+          "description": "Optional. The site key that was used to invoke reCAPTCHA Enterprise on your site and generate the token.",
           "type": "string"
         },
         "token": {
-          "description": "Optional. The user response token provided by the reCAPTCHA client-side integration on your site.",
+          "description": "Optional. The user response token provided by the reCAPTCHA Enterprise client-side integration on your site.",
           "type": "string"
         },
         "userAgent": {
@@ -1230,6 +1234,73 @@
       },
       "type": "object"
     },
+    "GoogleCloudRecaptchaenterpriseV1TransactionEvent": {
+      "description": "Describes an event in the lifecycle of a payment transaction.",
+      "id": "GoogleCloudRecaptchaenterpriseV1TransactionEvent",
+      "properties": {
+        "eventTime": {
+          "description": "Optional. Timestamp when this transaction event occurred; otherwise assumed to be the time of the API call.",
+          "format": "google-datetime",
+          "type": "string"
+        },
+        "eventType": {
+          "description": "Optional. The type of this transaction event.",
+          "enum": [
+            "TRANSACTION_EVENT_TYPE_UNSPECIFIED",
+            "MERCHANT_APPROVE",
+            "MERCHANT_DENY",
+            "MANUAL_REVIEW",
+            "AUTHORIZATION",
+            "AUTHORIZATION_DECLINE",
+            "PAYMENT_CAPTURE",
+            "PAYMENT_CAPTURE_DECLINE",
+            "CANCEL",
+            "CHARGEBACK_INQUIRY",
+            "CHARGEBACK_ALERT",
+            "FRAUD_NOTIFICATION",
+            "CHARGEBACK",
+            "CHARGEBACK_REPRESENTMENT",
+            "CHARGEBACK_REVERSE",
+            "REFUND_REQUEST",
+            "REFUND_DECLINE",
+            "REFUND",
+            "REFUND_REVERSE"
+          ],
+          "enumDescriptions": [
+            "Default, unspecified event type.",
+            "Indicates that the transaction is approved by the merchant's risk engine. The accompanying reasons can include 'INHOUSE', 'ACCERTIFY', or 'RECAPTCHA'.",
+            "Indicates that the transaction is denied and concluded due to risks detected by the merchant's risk engine. The accompanying reasons can include 'INHOUSE', 'ACCERTIFY', 'MANUAL_REVIEW', or 'RECAPTCHA'.",
+            "Indicates that the transaction is being evaluated by a human, due to suspicion or risk.",
+            "Indicates that the authorization attempt with the card issuer succeeded.",
+            "Indicates that the authorization attempt with the card issuer failed. The accompanying reasons can include Visa's '54' indicating that the card is expired or '82' indicating that the CVV is incorrect.",
+            "Indicates that the transaction is completed because the funds were settled.",
+            "Indicates that the transaction could not be completed because the funds were not settled.",
+            "Indicates that the transaction has been canceled. Specify the reason for the cancellation. For example, 'INSUFFICIENT_INVENTORY'.",
+            "Indicates that the merchant has received a chargeback inquiry for the transaction, requesting additional information before a chargeback is officially issued and a formal chargeback notification is sent.",
+            "Indicates that the merchant has received a chargeback alert for the transaction. The process of resolving the dispute without involving the payment network is started.",
+            "Indicates that a fraud notification is issued for the transaction, sent by the payment instrument's issuing bank because the transaction appears to be fraudulent. We recommend including TC40 or SAFE data in the `reason` field for this event type. For partial chargebacks, we recommend that you include an amount in the `value` field.",
+            "Indicates that the merchant is informed by the payment network that the transaction has entered the chargeback process. Reason code examples include Discover's '4553' and '6041'. For partial chargebacks, we recommend that you include an amount in the `value` field.",
+            "Indicates that the transaction has entered the chargeback process, and that the merchant has chosen to enter representment. Reason examples include Discover's '4553' and '6041'. For partial chargebacks, we recommend that you include an amount in the `value` field.",
+            "Indicates that the transaction has had a chargeback which was illegitimate and was reversed as a result. For partial chargebacks, we recommend that you include an amount in the `value` field.",
+            "Indicates that the merchant has received a refund for a completed transaction. For partial refunds, we recommend that you include an amount in the `value` field. Reason example: 'TAX_EXEMPT' (partial refund of exempt tax)",
+            "Indicates that the merchant has received a refund request for this transaction, but that they have declined it. For partial refunds, we recommend that you include an amount in the `value` field. Reason example: 'TAX_EXEMPT' (partial refund of exempt tax)",
+            "Indicates that the completed transaction was refunded by the merchant. For partial refunds, we recommend that you include an amount in the `value` field. Reason example: 'TAX_EXEMPT' (partial refund of exempt tax)",
+            "Indicates that the completed transaction was refunded by the merchant, and that this refund was reversed. For partial refunds, we recommend that you include an amount in the `value` field."
+          ],
+          "type": "string"
+        },
+        "reason": {
+          "description": "Optional. The reason or standardized code which corresponds with this transaction event, if one exists. E.g. a CHARGEBACK Event with code 4553.",
+          "type": "string"
+        },
+        "value": {
+          "description": "Optional. The value that corresponds with this transaction event, if one exists. E.g. A refund event where $5.00 was refunded. Currency is obtained from the original transaction data.",
+          "format": "double",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudRecaptchaenterpriseV1WafSettings": {
       "description": "Settings specific to keys that can be used for WAF (Web Application Firewall).",
       "id": "GoogleCloudRecaptchaenterpriseV1WafSettings",