OMGeeky/google-apis-rs
1
0
Fork 0
mirror of https://github.com/OMGeeky/google-apis-rs.git synced 2026-01-19 01:40:05 +01:00
Code Issues Packages Projects Releases Wiki Activity

update all APIs

Browse Source 
Like documented in the README

```
rm -f .api.deps .cli.deps && FETCH_APIS=1 make update-json -j8
```
This commit is contained in:
Sebastian Thiel
2024-03-05 18:54:36 +01:00
parent 8a12e9d47e
commit ca974aa0a5
347 changed files with 202580 additions and 50157 deletions
Download Patch File Download Diff File Expand all files Collapse all files

607
etc/api/testing/v1/testing-api.json
View File

@@ -114,7 +114,13 @@
"httpMethod": "POST",
"id": "testing.applicationDetailService.getApkDetails",
"parameterOrder": [],
"parameters": {},
"parameters": {
"bundleLocation.gcsPath": {
"description": "A path to a file in Google Cloud Storage. Example: gs://build-app-1414623860166/app%40debug-unaligned.apk These paths are expected to be url encoded (percent encoding)",
"location": "query",
"type": "string"
}
},
"path": "v1/applicationDetailService/getApkDetails",
"request": {
"$ref": "FileReference"
@@ -130,6 +136,166 @@
},
"projects": {
"resources": {
"deviceSessions": {
"methods": {
"cancel": {
"description": "POST /v1/projects/{project_id}/deviceSessions/{device_session_id}:cancel Changes the DeviceSession to state FINISHED and terminates all connections. Canceled sessions are not deleted and can be retrieved or listed by the user until they expire based on the 28 day deletion policy.",
"flatPath": "v1/projects/{projectsId}/deviceSessions/{deviceSessionsId}:cancel",
"httpMethod": "POST",
"id": "testing.projects.deviceSessions.cancel",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. Name of the DeviceSession, e.g. \"projects/{project_id}/deviceSessions/{session_id}\"",
"location": "path",
"pattern": "^projects/[^/]+/deviceSessions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}:cancel",
"request": {
"$ref": "CancelDeviceSessionRequest"
},
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"create": {
"description": "POST /v1/projects/{project_id}/deviceSessions",
"flatPath": "v1/projects/{projectsId}/deviceSessions",
"httpMethod": "POST",
"id": "testing.projects.deviceSessions.create",
"parameterOrder": [
"parent"
],
"parameters": {
"parent": {
"description": "Required. The Compute Engine project under which this device will be allocated. \"projects/{project_id}\"",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+parent}/deviceSessions",
"request": {
"$ref": "DeviceSession"
},
"response": {
"$ref": "DeviceSession"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"get": {
"description": "GET /v1/projects/{project_id}/deviceSessions/{device_session_id} Return a DeviceSession, which documents the allocation status and whether the device is allocated. Clients making requests from this API must poll GetDeviceSession.",
"flatPath": "v1/projects/{projectsId}/deviceSessions/{deviceSessionsId}",
"httpMethod": "GET",
"id": "testing.projects.deviceSessions.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. Name of the DeviceSession, e.g. \"projects/{project_id}/deviceSessions/{session_id}\"",
"location": "path",
"pattern": "^projects/[^/]+/deviceSessions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}",
"response": {
"$ref": "DeviceSession"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "GET /v1/projects/{project_id}/deviceSessions Lists device Sessions owned by the project user.",
"flatPath": "v1/projects/{projectsId}/deviceSessions",
"httpMethod": "GET",
"id": "testing.projects.deviceSessions.list",
"parameterOrder": [
"parent"
],
"parameters": {
"filter": {
"description": "Optional. If specified, responses will be filtered by the given filter. Allowed fields are: session_state.",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Optional. The maximum number of DeviceSessions to return.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Optional. A continuation token for paging.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The name of the parent to request, e.g. \"projects/{project_id}\"",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+parent}/deviceSessions",
"response": {
"$ref": "ListDeviceSessionsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"patch": {
"description": "PATCH /v1/projects/{projectId}/deviceSessions/deviceSessionId}:updateDeviceSession Updates the current device session to the fields described by the update_mask.",
"flatPath": "v1/projects/{projectsId}/deviceSessions/{deviceSessionsId}",
"httpMethod": "PATCH",
"id": "testing.projects.deviceSessions.patch",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Optional. Name of the DeviceSession, e.g. \"projects/{project_id}/deviceSessions/{session_id}\"",
"location": "path",
"pattern": "^projects/[^/]+/deviceSessions/[^/]+$",
"required": true,
"type": "string"
},
"updateMask": {
"description": "Required. The list of fields to update.",
"format": "google-fieldmask",
"location": "query",
"type": "string"
}
},
"path": "v1/{+name}",
"request": {
"$ref": "DeviceSession"
},
"response": {
"$ref": "DeviceSession"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
},
"testMatrices": {
"methods": {
"cancel": {
@@ -164,7 +330,7 @@
]
},
"create": {
"description": "Creates and runs a matrix of tests according to the given specifications. Unsupported environments will be returned in the state UNSUPPORTED. A test matrix is limited to use at most 2000 devices in parallel. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed or if the matrix tries to use too many simultaneous devices.",
"description": "Creates and runs a matrix of tests according to the given specifications. Unsupported environments will be returned in the state UNSUPPORTED. A test matrix is limited to use at most 2000 devices in parallel. The returned matrix will not yet contain the executions that will be created for this matrix. Execution creation happens later on and will require a call to GetTestMatrix. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed or if the matrix tries to use too many simultaneous devices.",
"flatPath": "v1/projects/{projectId}/testMatrices",
"httpMethod": "POST",
"id": "testing.projects.testMatrices.create",
@@ -196,7 +362,7 @@
]
},
"get": {
"description": "Checks the status of a test matrix. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the Test Matrix does not exist",
"description": "Checks the status of a test matrix and the executions once they are created. The test matrix will contain the list of test executions to run if and only if the resultStorage.toolResultsExecution fields have been populated. Note: Flaky test executions may be added to the matrix at a later stage. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the Test Matrix does not exist",
"flatPath": "v1/projects/{projectId}/testMatrices/{testMatrixId}",
"httpMethod": "GET",
"id": "testing.projects.testMatrices.get",
@@ -282,7 +448,7 @@
}
}
},
"revision": "20230119",
"revision": "20240227",
"rootUrl": "https://testing.googleapis.com/",
"schemas": {
"Account": {
@@ -509,6 +675,13 @@
"description": "The human-readable marketing name for this device model. Examples: \"Nexus 5\", \"Galaxy S5\".",
"type": "string"
},
"perVersionInfo": {
"description": "Version-specific information of an Android model.",
"items": {
"$ref": "PerAndroidVersionInfo"
},
"type": "array"
},
"screenDensity": {
"description": "Screen density in DPI. This corresponds to ro.sf.lcd_density",
"format": "int32",
@@ -573,11 +746,13 @@
"type": "string"
},
"maxDepth": {
"deprecated": true,
"description": "The max depth of the traversal stack Robo can explore. Needs to be at least 2 to make Robo explore the app beyond the first activity. Default is 50.",
"format": "int32",
"type": "integer"
},
"maxSteps": {
"deprecated": true,
"description": "The max number of steps Robo can execute. Default is no limit.",
"format": "int32",
"type": "integer"
@@ -727,7 +902,7 @@
"type": "object"
},
"ApkDetail": {
"description": "Android application details based on application manifest and apk archive contents.",
"description": "Android application details based on application manifest and archive contents.",
"id": "ApkDetail",
"properties": {
"apkManifest": {
@@ -771,6 +946,13 @@
"description": "Full Java-style package name for this application, e.g. \"com.example.foo\".",
"type": "string"
},
"services": {
"description": "Services contained in the tag.",
"items": {
"$ref": "Service"
},
"type": "array"
},
"targetSdkVersion": {
"description": "Specifies the API Level on which the application is designed to run.",
"format": "int32",
@@ -813,6 +995,12 @@
},
"type": "object"
},
"CancelDeviceSessionRequest": {
"description": "The request object for cancelling a Device Session.",
"id": "CancelDeviceSessionRequest",
"properties": {},
"type": "object"
},
"CancelTestMatrixResponse": {
"description": "Response containing the current state of the specified test matrix.",
"id": "CancelTestMatrixResponse",
@@ -965,6 +1153,102 @@
},
"type": "object"
},
"DeviceSession": {
"description": "Protobuf message describing the device message, used from several RPCs.",
"id": "DeviceSession",
"properties": {
"activeStartTime": {
"description": "Output only. The timestamp that the session first became ACTIVE.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"androidDevice": {
"$ref": "AndroidDevice",
"description": "Required. The requested device"
},
"createTime": {
"description": "Output only. The time that the Session was created.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"displayName": {
"description": "Output only. The title of the DeviceSession to be presented in the UI.",
"readOnly": true,
"type": "string"
},
"expireTime": {
"description": "Optional. If the device is still in use at this time, any connections will be ended and the SessionState will transition from ACTIVE to FINISHED.",
"format": "google-datetime",
"type": "string"
},
"inactivityTimeout": {
"description": "Output only. The interval of time that this device must be interacted with before it transitions from ACTIVE to TIMEOUT_INACTIVITY.",
"format": "google-duration",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Optional. Name of the DeviceSession, e.g. \"projects/{project_id}/deviceSessions/{session_id}\"",
"type": "string"
},
"state": {
"description": "Output only. Current state of the DeviceSession.",
"enum": [
"SESSION_STATE_UNSPECIFIED",
"REQUESTED",
"PENDING",
"ACTIVE",
"EXPIRED",
"FINISHED",
"UNAVAILABLE",
"ERROR"
],
"enumDescriptions": [
"Default value. This value is unused.",
"Initial state of a session request. The session is being validated for correctness and a device is not yet requested.",
"The session has been validated and is in the queue for a device.",
"The session has been granted and the device is accepting connections.",
"The session duration exceeded the device\u2019s reservation time period and timed out automatically.",
"The user is finished with the session and it was canceled by the user while the request was still getting allocated or after allocation and during device usage period.",
"Unable to complete the session because the device was unavailable and it failed to allocate through the scheduler. For example, a device not in the catalog was requested or the request expired in the allocation queue.",
"Unable to complete the session for an internal reason, such as an infrastructure failure."
],
"readOnly": true,
"type": "string"
},
"stateHistories": {
"description": "Output only. The historical state transitions of the session_state message including the current session state.",
"items": {
"$ref": "SessionStateEvent"
},
"readOnly": true,
"type": "array"
},
"ttl": {
"description": "Optional. The amount of time that a device will be initially allocated for. This can eventually be extended with the UpdateDeviceSession RPC. Default: 30 minutes.",
"format": "google-duration",
"type": "string"
}
},
"type": "object"
},
"DirectAccessVersionInfo": {
"description": "Denotes whether Direct Access is supported, and by which client versions. DirectAccessService is currently available as a preview to select developers. You can register today on behalf of you and your team at https://developer.android.com/studio/preview/android-device-streaming",
"id": "DirectAccessVersionInfo",
"properties": {
"directAccessSupported": {
"description": "Whether direct access is supported at all. Clients are expected to filter down the device list to only android models and versions which support Direct Access when that is the user intent.",
"type": "boolean"
},
"minimumAndroidStudioVersion": {
"description": "Output only. Indicates client-device compatibility, where a device is known to work only with certain workarounds implemented in the Android Studio client. Expected format \"major.minor.micro.patch\", e.g. \"5921.22.2211.8881706\".",
"type": "string"
}
},
"type": "object"
},
"Distribution": {
"description": "Data about the relative number of devices running a given configuration of the Android platform.",
"id": "Distribution",
@@ -982,6 +1266,12 @@
},
"type": "object"
},
"Empty": {
"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
"id": "Empty",
"properties": {},
"type": "object"
},
"Environment": {
"description": "The environment in which the test is run.",
"id": "Environment",
@@ -1043,12 +1333,12 @@
"type": "object"
},
"GetApkDetailsResponse": {
"description": "Response containing the details of the specified Android application APK.",
"description": "Response containing the details of the specified Android application.",
"id": "GetApkDetailsResponse",
"properties": {
"apkDetail": {
"$ref": "ApkDetail",
"description": "Details of the Android APK."
"description": "Details of the Android App."
}
},
"type": "object"
@@ -1218,6 +1508,13 @@
"description": "The human-readable name for this device model. Examples: \"iPhone 4s\", \"iPad Mini 2\".",
"type": "string"
},
"perVersionInfo": {
"description": "Version-specific information of an iOS model.",
"items": {
"$ref": "PerIosVersionInfo"
},
"type": "array"
},
"screenDensity": {
"description": "Screen density in DPI.",
"format": "int32",
@@ -1250,6 +1547,25 @@
},
"type": "object"
},
"IosRoboTest": {
"description": "A test that explores an iOS application on an iOS device.",
"id": "IosRoboTest",
"properties": {
"appBundleId": {
"description": "The bundle ID for the app-under-test. This is determined by examining the application's \"Info.plist\" file.",
"type": "string"
},
"appIpa": {
"$ref": "FileReference",
"description": "Required. The ipa stored at this file should be used to run the test."
},
"roboScript": {
"$ref": "FileReference",
"description": "An optional Roboscript to customize the crawl. See https://firebase.google.com/docs/test-lab/android/robo-scripts-reference for more information about Roboscripts."
}
},
"type": "object"
},
"IosRuntimeConfiguration": {
"description": "iOS configuration that can be selected at the time a test is run.",
"id": "IosRuntimeConfiguration",
@@ -1394,6 +1710,24 @@
"properties": {},
"type": "object"
},
"ListDeviceSessionsResponse": {
"description": "A list of device sessions.",
"id": "ListDeviceSessionsResponse",
"properties": {
"deviceSessions": {
"description": "The sessions matching the specified filter in the given cloud project.",
"items": {
"$ref": "DeviceSession"
},
"type": "array"
},
"nextPageToken": {
"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"Locale": {
"description": "A location/region designation for language.",
"id": "Locale",
@@ -1425,7 +1759,7 @@
"id": "ManualSharding",
"properties": {
"testTargetsForShard": {
"description": "Required. Group of packages, classes, and/or test methods to be run for each manually-created shard. You must specify at least one shard if this field is present. When you select one or more physical devices, the number of repeated test_targets_for_shard must be <= 50. When you select one or more ARM virtual devices, it must be <= 100. When you select only x86 virtual devices, it must be <= 500.",
"description": "Required. Group of packages, classes, and/or test methods to be run for each manually-created shard. You must specify at least one shard if this field is present. When you select one or more physical devices, the number of repeated test_targets_for_shard must be <= 50. When you select one or more ARM virtual devices, it must be <= 200. When you select only x86 virtual devices, it must be <= 500.",
"items": {
"$ref": "TestTargetsForShard"
},
@@ -1434,6 +1768,23 @@
},
"type": "object"
},
"MatrixErrorDetail": {
"description": "Describes a single error or issue with a matrix.",
"id": "MatrixErrorDetail",
"properties": {
"message": {
"description": "Output only. A human-readable message about how the error in the TestMatrix. Expands on the `reason` field with additional details and possible options to fix the issue.",
"readOnly": true,
"type": "string"
},
"reason": {
"description": "Output only. The reason for the error. This is a constant value in UPPER_SNAKE_CASE that identifies the cause of the error.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"Metadata": {
"description": "A tag within a manifest. https://developer.android.com/guide/topics/manifest/meta-data-element.html",
"id": "Metadata",
@@ -1479,6 +1830,12 @@
},
"type": "object"
},
"NoActivityIntent": {
"description": "Skips the starting activity",
"id": "NoActivityIntent",
"properties": {},
"type": "object"
},
"ObbFile": {
"description": "An opaque binary blob file to install on the device before the test starts.",
"id": "ObbFile",
@@ -1516,6 +1873,75 @@
},
"type": "object"
},
"PerAndroidVersionInfo": {
"description": "A version-specific information of an Android model.",
"id": "PerAndroidVersionInfo",
"properties": {
"deviceCapacity": {
"description": "The number of online devices for an Android version.",
"enum": [
"DEVICE_CAPACITY_UNSPECIFIED",
"DEVICE_CAPACITY_HIGH",
"DEVICE_CAPACITY_MEDIUM",
"DEVICE_CAPACITY_LOW",
"DEVICE_CAPACITY_NONE"
],
"enumDescriptions": [
"The value of device capacity is unknown or unset.",
"Devices that are high in capacity (The lab has a large number of these devices). These devices are generally suggested for running a large number of simultaneous tests (e.g. more than 100 tests). Please note that high capacity devices do not guarantee short wait times due to several factors: 1. Traffic (how heavily they are used at any given moment) 2. High capacity devices are prioritized for certain usages, which may cause user tests to be slower than selecting other similar device types.",
"Devices that are medium in capacity (The lab has a decent number of these devices, though not as many as high capacity devices). These devices are suitable for fewer test runs (e.g. fewer than 100 tests) and only for low shard counts (e.g. less than 10 shards).",
"Devices that are low in capacity (The lab has a small number of these devices). These devices may be used if users need to test on this specific device model and version. Please note that due to low capacity, the tests may take much longer to finish, especially if a large number of tests are invoked at once. These devices are not suitable for test sharding.",
"Devices that are completely missing from the lab. These devices are unavailable either temporarily or permanently and should not be requested. If the device is also marked as deprecated, this state is very likely permanent."
],
"type": "string"
},
"directAccessVersionInfo": {
"$ref": "DirectAccessVersionInfo",
"description": "Output only. Identifies supported clients for DirectAccess for this Android version.",
"readOnly": true
},
"interactiveDeviceAvailabilityEstimate": {
"description": "Output only. The estimated wait time for a single interactive device session using Direct Access.",
"format": "google-duration",
"readOnly": true,
"type": "string"
},
"versionId": {
"description": "An Android version.",
"type": "string"
}
},
"type": "object"
},
"PerIosVersionInfo": {
"description": "A version-specific information of an iOS model.",
"id": "PerIosVersionInfo",
"properties": {
"deviceCapacity": {
"description": "The number of online devices for an iOS version.",
"enum": [
"DEVICE_CAPACITY_UNSPECIFIED",
"DEVICE_CAPACITY_HIGH",
"DEVICE_CAPACITY_MEDIUM",
"DEVICE_CAPACITY_LOW",
"DEVICE_CAPACITY_NONE"
],
"enumDescriptions": [
"The value of device capacity is unknown or unset.",
"Devices that are high in capacity (The lab has a large number of these devices). These devices are generally suggested for running a large number of simultaneous tests (e.g. more than 100 tests). Please note that high capacity devices do not guarantee short wait times due to several factors: 1. Traffic (how heavily they are used at any given moment) 2. High capacity devices are prioritized for certain usages, which may cause user tests to be slower than selecting other similar device types.",
"Devices that are medium in capacity (The lab has a decent number of these devices, though not as many as high capacity devices). These devices are suitable for fewer test runs (e.g. fewer than 100 tests) and only for low shard counts (e.g. less than 10 shards).",
"Devices that are low in capacity (The lab has a small number of these devices). These devices may be used if users need to test on this specific device model and version. Please note that due to low capacity, the tests may take much longer to finish, especially if a large number of tests are invoked at once. These devices are not suitable for test sharding.",
"Devices that are completely missing from the lab. These devices are unavailable either temporarily or permanently and should not be requested. If the device is also marked as deprecated, this state is very likely permanent."
],
"type": "string"
},
"versionId": {
"description": "An iOS version.",
"type": "string"
}
},
"type": "object"
},
"ProvidedSoftwareCatalog": {
"description": "The currently provided software environment on the devices under test.",
"id": "ProvidedSoftwareCatalog",
@@ -1525,6 +1951,7 @@
"type": "string"
},
"orchestratorVersion": {
"deprecated": true,
"description": "Deprecated: Use AndroidX Test Orchestrator going forward. A string representing the current version of Android Test Orchestrator that is used in the environment. The package is available at https://maven.google.com/web/index.html#com.android.support.test:orchestrator.",
"type": "string"
}
@@ -1608,6 +2035,10 @@
"$ref": "LauncherActivityIntent",
"description": "An intent that starts the main launcher activity."
},
"noActivity": {
"$ref": "NoActivityIntent",
"description": "Skips the starting activity"
},
"startActivity": {
"$ref": "StartActivityIntent",
"description": "An intent that starts an activity with specific details."
@@ -1620,23 +2051,93 @@
},
"type": "object"
},
"Service": {
"description": "The section of an tag. https://developer.android.com/guide/topics/manifest/service-element",
"id": "Service",
"properties": {
"intentFilter": {
"description": "Intent filters in the service",
"items": {
"$ref": "IntentFilter"
},
"type": "array"
},
"name": {
"description": "The android:name value",
"type": "string"
}
},
"type": "object"
},
"SessionStateEvent": {
"description": "A message encapsulating a series of Session states and the time that the DeviceSession first entered those states.",
"id": "SessionStateEvent",
"properties": {
"eventTime": {
"description": "Output only. The time that the session_state first encountered that state.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"sessionState": {
"description": "Output only. The session_state tracked by this event",
"enum": [
"SESSION_STATE_UNSPECIFIED",
"REQUESTED",
"PENDING",
"ACTIVE",
"EXPIRED",
"FINISHED",
"UNAVAILABLE",
"ERROR"
],
"enumDescriptions": [
"Default value. This value is unused.",
"Initial state of a session request. The session is being validated for correctness and a device is not yet requested.",
"The session has been validated and is in the queue for a device.",
"The session has been granted and the device is accepting connections.",
"The session duration exceeded the device\u2019s reservation time period and timed out automatically.",
"The user is finished with the session and it was canceled by the user while the request was still getting allocated or after allocation and during device usage period.",
"Unable to complete the session because the device was unavailable and it failed to allocate through the scheduler. For example, a device not in the catalog was requested or the request expired in the allocation queue.",
"Unable to complete the session for an internal reason, such as an infrastructure failure."
],
"readOnly": true,
"type": "string"
},
"stateMessage": {
"description": "Output only. A human-readable message to explain the state.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"Shard": {
"description": "Output only. Details about the shard.",
"id": "Shard",
"properties": {
"estimatedShardDuration": {
"description": "Output only. The estimated shard duration based on previous test case timing records, if available.",
"format": "google-duration",
"readOnly": true,
"type": "string"
},
"numShards": {
"description": "Output only. The total number of shards.",
"format": "int32",
"readOnly": true,
"type": "integer"
},
"shardIndex": {
"description": "Output only. The index of the shard among all the shards.",
"format": "int32",
"readOnly": true,
"type": "integer"
},
"testTargetsForShard": {
"$ref": "TestTargetsForShard",
"description": "Output only. Test targets for each shard. Only set for manual sharding."
"description": "Output only. Test targets for each shard. Only set for manual sharding.",
"readOnly": true
}
},
"type": "object"
@@ -1649,6 +2150,10 @@
"$ref": "ManualSharding",
"description": "Shards test cases into the specified groups of packages, classes, and/or methods."
},
"smartSharding": {
"$ref": "SmartSharding",
"description": "Shards test based on previous test case timing records."
},
"uniformSharding": {
"$ref": "UniformSharding",
"description": "Uniformly shards test cases given a total number of shards."
@@ -1656,6 +2161,18 @@
},
"type": "object"
},
"SmartSharding": {
"description": "Shards test based on previous test case timing records.",
"id": "SmartSharding",
"properties": {
"targetedShardDuration": {
"description": "The amount of time tests within a shard should take. Default: 300 seconds (5 minutes). The minimum allowed: 120 seconds (2 minutes). The shard count is dynamically set based on time, up to the maximum shard limit (described below). To guarantee at least one test case for each shard, the number of shards will not exceed the number of test cases. Shard duration will be exceeded if: - The maximum shard limit is reached and there is more calculated test time remaining to allocate into shards. - Any individual test is estimated to be longer than the targeted shard duration. Shard duration is not guaranteed because smart sharding uses test case history and default durations which may not be accurate. The rules for finding the test case timing records are: - If the service has processed a test case in the last 30 days, the record of the latest successful test case will be used. - For new test cases, the average duration of other known test cases will be used. - If there are no previous test case timing records available, the default test case duration is 15 seconds. Because the actual shard duration can exceed the targeted shard duration, we recommend that you set the targeted value at least 5 minutes less than the maximum allowed test timeout (45 minutes for physical devices and 60 minutes for virtual), or that you use the custom test timeout value that you set. This approach avoids cancelling the shard before all tests can finish. Note that there is a limit for maximum number of shards. When you select one or more physical devices, the number of shards must be <= 50. When you select one or more ARM virtual devices, it must be <= 200. When you select only x86 virtual devices, it must be <= 500. To guarantee at least one test case for per shard, the number of shards will not exceed the number of test cases. Each shard created counts toward daily test quota.",
"format": "google-duration",
"type": "string"
}
},
"type": "object"
},
"StartActivityIntent": {
"description": "A starting intent specified by an action, uri, and categories.",
"id": "StartActivityIntent",
@@ -1682,6 +2199,7 @@
"id": "SystraceSetup",
"properties": {
"durationSeconds": {
"deprecated": true,
"description": "Systrace duration in seconds. Should be between 1 and 30 seconds. 0 disables systrace.",
"format": "int32",
"type": "integer"
@@ -1820,6 +2338,14 @@
"$ref": "EnvironmentMatrix",
"description": "Required. The devices the tests are being executed on."
},
"extendedInvalidMatrixDetails": {
"description": "Output only. Details about why a matrix was deemed invalid. If multiple checks can be safely performed, they will be reported but no assumptions should be made about the length of this list.",
"items": {
"$ref": "MatrixErrorDetail"
},
"readOnly": true,
"type": "array"
},
"failFast": {
"description": "If true, only a single attempt at most will be made to run each execution/shard in the matrix. Flaky test attempts are not affected. Normally, 2 or more attempts are made if a potential infrastructure issue is detected. This feature is for latency sensitive workloads. The incidence of execution failures may be significantly greater for fail-fast matrices and support is more limited because of that expectation.",
"type": "boolean"
@@ -1872,6 +2398,47 @@
"SERVICE_NOT_ACTIVATED",
"UNKNOWN_PERMISSION_ERROR"
],
"enumDeprecated": [
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
true,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false
],
"enumDescriptions": [
"Do not use. For proto versioning only.",
"The matrix is INVALID, but there are no further details available.",
@@ -1884,7 +2451,7 @@
"The test apk does not declare an instrumentation.",
"The input app apk does not have a signature.",
"The test runner class specified by user or in the test APK's manifest file is not compatible with Android Test Orchestrator. Orchestrator is only compatible with AndroidJUnitRunner version 1.1 or higher. Orchestrator can be disabled by using DO_NOT_USE_ORCHESTRATOR OrchestratorOption.",
"The test APK does not contain the test runner class specified by user or in the manifest file. This can be caused by either of the following reasons: - the user provided a runner class name that's incorrect, or - the test runner isn't built into the test APK (might be in the app APK instead).",
"The test APK does not contain the test runner class specified by the user or in the manifest file. This can be caused by one of the following reasons: - the user provided a runner class name that's incorrect, or - the test runner isn't built into the test APK (might be in the app APK instead).",
"A main launcher activity could not be found.",
"The app declares one or more permissions that are not allowed.",
"There is a conflict in the provided robo_directives.",
@@ -1927,7 +2494,7 @@
"enumDescriptions": [
"Do not use. For proto versioning only.",
"The test matrix run was successful, for instance: - All the test cases passed. - Robo did not detect a crash of the application under test.",
"A run failed, for instance: - One or more test case failed. - A test timed out. - The application under test crashed.",
"A run failed, for instance: - One or more test cases failed. - A test timed out. - The application under test crashed.",
"Something unexpected happened. The run should still be considered unsuccessful but this is likely a transient problem and re-running the test might be successful.",
"All tests were skipped, for instance: - All device configurations were incompatible."
],
@@ -2003,7 +2570,7 @@
"description": "The device will be logged in on this account for the duration of the test."
},
"additionalApks": {
"description": "APKs to install in addition to those being directly tested. Currently capped at 100.",
"description": "APKs to install in addition to those being directly tested. These will be installed after the app under test. Currently capped at 100.",
"items": {
"$ref": "Apk"
},
@@ -2034,13 +2601,21 @@
},
"type": "array"
},
"initialSetupApks": {
"description": "Optional. Initial setup APKs to install before the app under test is installed. Currently capped at 100.",
"items": {
"$ref": "Apk"
},
"type": "array"
},
"networkProfile": {
"description": "The network traffic profile used for running the test. Available network profiles can be queried by using the NETWORK_CONFIGURATION environment type when calling TestEnvironmentDiscoveryService.GetTestEnvironmentCatalog.",
"type": "string"
},
"systrace": {
"$ref": "SystraceSetup",
"description": "Deprecated: Systrace uses Python 2 which has been sunset 2020-01-01. Support of Systrace may stop at any time, at which point no Systrace file will be provided in the results. Systrace configuration for the run. If set a systrace will be taken, starting on test start and lasting for the configured duration. The systrace file thus obtained is put in the results bucket together with the other artifacts from the run."
"deprecated": true,
"description": "Systrace configuration for the run. Deprecated: Systrace used Python 2 which was sunsetted on 2020-01-01. Systrace is no longer supported in the Cloud Testing API, and no Systrace file will be provided in the results."
}
},
"type": "object"
@@ -2069,6 +2644,10 @@
"description": "Disables video recording. May reduce test latency.",
"type": "boolean"
},
"iosRoboTest": {
"$ref": "IosRoboTest",
"description": "An iOS Robo test."
},
"iosTestLoop": {
"$ref": "IosTestLoop",
"description": "An iOS application with a test loop."
@@ -2201,7 +2780,7 @@
"id": "UniformSharding",
"properties": {
"numShards": {
"description": "Required. The total number of shards to create. This must always be a positive number that is no greater than the total number of test cases. When you select one or more physical devices, the number of shards must be <= 50. When you select one or more ARM virtual devices, it must be <= 100. When you select only x86 virtual devices, it must be <= 500.",
"description": "Required. The total number of shards to create. This must always be a positive number that is no greater than the total number of test cases. When you select one or more physical devices, the number of shards must be <= 50. When you select one or more ARM virtual devices, it must be <= 200. When you select only x86 virtual devices, it must be <= 500.",
"format": "int32",
"type": "integer"
}