REST Resource: projects.histories.executions

{
  "executionId": string,
  "state": enum (State),
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "outcome": {
    object (Outcome)
  },
  "dimensionDefinitions": [
    {
      object (MatrixDimensionDefinition)
    }
  ],
  "specification": {
    object (Specification)
  },
  "testExecutionMatrixId": string
}

string

A unique identifier within a History for this Execution.

Returns INVALID_ARGUMENT if this field is set or overwritten by the caller.

• In response always set
• In create/update request: never set

enum (State)

The initial state is IN_PROGRESS.

The only legal state transitions is from IN_PROGRESS to COMPLETE.

A PRECONDITION_FAILED will be returned if an invalid transition is requested.

The state can only be set to COMPLETE once. A FAILED_PRECONDITION will be returned if the state is set to COMPLETE multiple times.

If the state is set to COMPLETE, all the in-progress steps within the execution will be set as COMPLETE. If the outcome of the step is not set, the outcome will be set to INCONCLUSIVE.

• In response always set
• In create/update request: optional

object (Timestamp)

The time when the Execution was created.

This value will be set automatically when executions.create is called.

• In response: always set
• In create/update request: never set

object (Timestamp)

The time when the Execution status transitioned to COMPLETE.

This value will be set automatically when state transitions to COMPLETE.

• In response: set if the execution state is COMPLETE.
• In create/update request: never set

object (Outcome)

Classify the result, for example into SUCCESS or FAILURE

• In response: present if set by create/update request
• In create/update request: optional

object (MatrixDimensionDefinition)

The dimensions along which different steps in this execution may vary. This must remain fixed over the life of the execution.

Returns INVALID_ARGUMENT if this field is set in an update request.

Returns INVALID_ARGUMENT if the same name occurs in more than one dimension_definition.

Returns INVALID_ARGUMENT if the size of the list is over 100.

• In response: present if set by create
• In create request: optional
• In update request: never set

object (Specification)

Lightweight information about execution request.

• In response: present if set by create
• In create: optional
• In update: optional

string

TestExecution Matrix ID that the TestExecutionService uses.

• In response: present if set by create
• In create: optional
• In update: never set

{

  // Union field specification can be only one of the following:
  "androidTest": {
    object (AndroidTest)
  },
  "iosTest": {
    object (IosTest)
  }
  // End of list of possible types for union field specification.
}

object (AndroidTest)

An Android mobile test execution specification.

object (IosTest)

An iOS mobile test execution specification.

{
  "androidAppInfo": {
    object (AndroidAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "androidInstrumentationTest": {
    object (AndroidInstrumentationTest)
  },
  "androidRoboTest": {
    object (AndroidRoboTest)
  },
  "androidTestLoop": {
    object (AndroidTestLoop)
  }
  // End of list of possible types for union field test.
}

object (AndroidAppInfo)

Information about the application under test.

object (Duration)

Max time a test is allowed to run before it is automatically cancelled.

object (AndroidInstrumentationTest)

An Android instrumentation test.

object (AndroidRoboTest)

An Android robo test.

object (AndroidTestLoop)

An Android test loop.

{
  "name": string,
  "packageName": string,
  "versionName": string,
  "versionCode": string
}

string

The name of the app. Optional

string

The package name of the app. Required.

string

The version name of the app. Optional.

string

The internal version code of the app. Optional.

{
  "testPackageId": string,
  "testRunnerClass": string,
  "testTargets": [
    string
  ],
  "useOrchestrator": boolean
}

string

The java package for the test to be executed. Required

string

The InstrumentationTestRunner class. Required

string

Each target must be fully qualified with the package name or class name, in one of these formats: - "package packageName" - "class packageName.class_name" - "class packageName.class_name#method_name"

If empty, all targets in the module will be run.

boolean

The flag indicates whether Android Test Orchestrator will be used to run test or not.

{
  "appInitialActivity": string,
  "bootstrapPackageId": string,
  "bootstrapRunnerClass": string,
  "maxDepth": integer,
  "maxSteps": integer
}

string

The initial activity that should be used to start the app. Optional

string

The java package for the bootstrap. Optional

string

The runner class for the bootstrap. Optional

integer

The max depth of the traversal stack Robo can explore. Optional

integer

The max number of steps/actions Robo can execute. Default is no limit (0). Optional

{
  "iosAppInfo": {
    object (IosAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "iosXcTest": {
    object (IosXcTest)
  },
  "iosTestLoop": {
    object (IosTestLoop)
  },
  "iosRoboTest": {
    object (IosRoboTest)
  }
  // End of list of possible types for union field test.
}

object (IosAppInfo)

Information about the application under test.

object (Duration)

Max time a test is allowed to run before it is automatically cancelled.

object (IosXcTest)

An iOS XCTest.

object (IosTestLoop)

An iOS test loop.

object (IosRoboTest)

An iOS Robo test.

{
  "name": string
}

string

The name of the app. Required

{
  "bundleId": string,
  "xcodeVersion": string
}

string

Bundle ID of the app.

string

Xcode version that the test was run with.

{
  "bundleId": string
}

string

Bundle ID of the app.