Add subtest for synthetics multistep tests (#3555)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v1/openapi.yaml

@@ -14766,6 +14766,61 @@ components:
       oneOf:
       - $ref: '#/components/schemas/SyntheticsAPITestStep'
       - $ref: '#/components/schemas/SyntheticsAPIWaitStep'
+      - $ref: '#/components/schemas/SyntheticsAPISubtestStep'
+    SyntheticsAPISubtestStep:
+      description: The subtest step used in a Synthetics multi-step API test.
+      properties:
+        allowFailure:
+          description: Determines whether or not to continue with test if this step
+            fails.
+          type: boolean
+        alwaysExecute:
+          description: A boolean set to always execute this step even if the previous
+            step failed or was skipped.
+          type: boolean
+        exitIfSucceed:
+          description: Determines whether or not to exit the test if the step succeeds.
+          type: boolean
+        extractedValuesFromScript:
+          description: Generate variables using JavaScript.
+          type: string
+        id:
+          description: ID of the step.
+          example: abc-def-123
+          readOnly: true
+          type: string
+        isCritical:
+          description: 'Determines whether or not to consider the entire test as failed
+            if this step fails.
+
+            Can be used only if `allowFailure` is `true`.'
+          type: boolean
+        name:
+          description: The name of the step.
+          example: Example step name
+          type: string
+        retry:
+          $ref: '#/components/schemas/SyntheticsTestOptionsRetry'
+        subtestPublicId:
+          description: Public ID of the test to be played as part of a `playSubTest`
+            step type.
+          example: ''
+          type: string
+        subtype:
+          $ref: '#/components/schemas/SyntheticsAPISubtestStepSubtype'
+      required:
+      - name
+      - subtype
+      - subtestPublicId
+      type: object
+    SyntheticsAPISubtestStepSubtype:
+      description: The subtype of the Synthetic multi-step API subtest step.
+      enum:
+      - playSubTest
+      example: playSubTest
+      type: string
+      x-enum-varnames:
+      - PLAY_SUB_TEST
     SyntheticsAPITest:
       description: Object containing details about a Synthetic API test.
       properties:

api/datadogV1/model_synthetics_api_step.go

@@ -10,8 +10,9 @@ import (
 
 // SyntheticsAPIStep - The steps used in a Synthetic multi-step API test.
 type SyntheticsAPIStep struct {
-	SyntheticsAPITestStep *SyntheticsAPITestStep
-	SyntheticsAPIWaitStep *SyntheticsAPIWaitStep
+	SyntheticsAPITestStep    *SyntheticsAPITestStep
+	SyntheticsAPIWaitStep    *SyntheticsAPIWaitStep
+	SyntheticsAPISubtestStep *SyntheticsAPISubtestStep
 
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
 	UnparsedObject interface{}
@@ -27,6 +28,11 @@ func SyntheticsAPIWaitStepAsSyntheticsAPIStep(v *SyntheticsAPIWaitStep) Syntheti
 	return SyntheticsAPIStep{SyntheticsAPIWaitStep: v}
 }
 
+// SyntheticsAPISubtestStepAsSyntheticsAPIStep is a convenience function that returns SyntheticsAPISubtestStep wrapped in SyntheticsAPIStep.
+func SyntheticsAPISubtestStepAsSyntheticsAPIStep(v *SyntheticsAPISubtestStep) SyntheticsAPIStep {
+	return SyntheticsAPIStep{SyntheticsAPISubtestStep: v}
+}
+
 // UnmarshalJSON turns data into one of the pointers in the struct.
 func (obj *SyntheticsAPIStep) UnmarshalJSON(data []byte) error {
 	var err error
@@ -65,10 +71,28 @@ func (obj *SyntheticsAPIStep) UnmarshalJSON(data []byte) error {
 		obj.SyntheticsAPIWaitStep = nil
 	}
 
+	// try to unmarshal data into SyntheticsAPISubtestStep
+	err = datadog.Unmarshal(data, &obj.SyntheticsAPISubtestStep)
+	if err == nil {
+		if obj.SyntheticsAPISubtestStep != nil && obj.SyntheticsAPISubtestStep.UnparsedObject == nil {
+			jsonSyntheticsAPISubtestStep, _ := datadog.Marshal(obj.SyntheticsAPISubtestStep)
+			if string(jsonSyntheticsAPISubtestStep) == "{}" { // empty struct
+				obj.SyntheticsAPISubtestStep = nil
+			} else {
+				match++
+			}
+		} else {
+			obj.SyntheticsAPISubtestStep = nil
+		}
+	} else {
+		obj.SyntheticsAPISubtestStep = nil
+	}
+
 	if match != 1 { // more than 1 match
 		// reset to nil
 		obj.SyntheticsAPITestStep = nil
 		obj.SyntheticsAPIWaitStep = nil
+		obj.SyntheticsAPISubtestStep = nil
 		return datadog.Unmarshal(data, &obj.UnparsedObject)
 	}
 	return nil // exactly one match
@@ -84,6 +108,10 @@ func (obj SyntheticsAPIStep) MarshalJSON() ([]byte, error) {
 		return datadog.Marshal(&obj.SyntheticsAPIWaitStep)
 	}
 
+	if obj.SyntheticsAPISubtestStep != nil {
+		return datadog.Marshal(&obj.SyntheticsAPISubtestStep)
+	}
+
 	if obj.UnparsedObject != nil {
 		return datadog.Marshal(obj.UnparsedObject)
 	}
@@ -100,6 +128,10 @@ func (obj *SyntheticsAPIStep) GetActualInstance() interface{} {
 		return obj.SyntheticsAPIWaitStep
 	}
 
+	if obj.SyntheticsAPISubtestStep != nil {
+		return obj.SyntheticsAPISubtestStep
+	}
+
 	// all schemas are nil
 	return nil
 }