blob: b6ff3ebc5e4a6a1c465097094f634093c9fb86ae [file] [log] [blame]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="testing_v1.html">Cloud Testing API</a> . <a href="testing_v1.testEnvironmentCatalog.html">testEnvironmentCatalog</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#get">get(environmentType, projectId=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the catalog of supported test environments.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="get">get(environmentType, projectId=None, x__xgafv=None)</code>
<pre>Gets the catalog of supported test environments.
May return any of the following canonical error codes:
- INVALID_ARGUMENT - if the request is malformed
- NOT_FOUND - if the environment type does not exist
- INTERNAL - if an internal error occurred
Args:
environmentType: string, Required. The type of environment that should be listed. (required)
projectId: string, For authorization, the cloud project requesting the TestEnvironmentCatalog.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A description of a test environment.
&quot;networkConfigurationCatalog&quot;: { # Supported network configurations.
&quot;configurations&quot;: [
{
&quot;id&quot;: &quot;A String&quot;, # The unique opaque id for this network traffic configuration.
&quot;upRule&quot;: { # Network emulation parameters. # The emulation rule applying to the upload traffic.
&quot;delay&quot;: &quot;A String&quot;, # Packet delay, must be &gt;= 0.
&quot;packetLossRatio&quot;: 3.14, # Packet loss ratio (0.0 - 1.0).
&quot;bandwidth&quot;: 3.14, # Bandwidth in kbits/second.
&quot;packetDuplicationRatio&quot;: 3.14, # Packet duplication ratio (0.0 - 1.0).
&quot;burst&quot;: 3.14, # Burst size in kbits.
},
&quot;downRule&quot;: { # Network emulation parameters. # The emulation rule applying to the download traffic.
&quot;delay&quot;: &quot;A String&quot;, # Packet delay, must be &gt;= 0.
&quot;packetLossRatio&quot;: 3.14, # Packet loss ratio (0.0 - 1.0).
&quot;bandwidth&quot;: 3.14, # Bandwidth in kbits/second.
&quot;packetDuplicationRatio&quot;: 3.14, # Packet duplication ratio (0.0 - 1.0).
&quot;burst&quot;: 3.14, # Burst size in kbits.
},
},
],
},
&quot;deviceIpBlockCatalog&quot;: { # List of IP blocks used by the Firebase Test Lab # The IP blocks used by devices in the test environment.
&quot;ipBlocks&quot;: [ # The device IP blocks used by Firebase Test Lab
{ # A single device IP block
&quot;form&quot;: &quot;A String&quot;, # Whether this block is used by physical or virtual devices
&quot;block&quot;: &quot;A String&quot;, # An IP address block in CIDR notation eg: 34.68.194.64/29
&quot;addedDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date this block was added to Firebase Test Lab
# and time zone are either specified elsewhere or are not significant. The date
# is relative to the Proleptic Gregorian Calendar. This can represent:
#
# * A full date, with non-zero year, month and day values
# * A month and day value, with a zero year, e.g. an anniversary
# * A year on its own, with zero month and day values
# * A year and month value, with a zero day, e.g. a credit card expiration date
#
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
&quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
# a year.
&quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
# month and day.
&quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year by itself or a year and month where the day is not
# significant.
},
},
],
},
&quot;softwareCatalog&quot;: { # The currently provided software environment on the devices under test. # The software test environment provided by TestExecutionService.
&quot;orchestratorVersion&quot;: &quot;A String&quot;, # A string representing the current version of Android Test
# Orchestrator that is provided by TestExecutionService.
# Example: &quot;1.0.2 beta&quot;.
},
&quot;androidDeviceCatalog&quot;: { # The currently supported Android devices. # Supported Android devices.
&quot;models&quot;: [ # The set of supported Android device models.
{ # A description of an Android device tests may be run on.
&quot;thumbnailUrl&quot;: &quot;A String&quot;, # URL of a thumbnail image (photo) of the device.
# e.g. https://lh3.googleusercontent.com/90WcauuJiCYABEl8U0lcZeuS5STUbf2yW...
&quot;lowFpsVideoRecording&quot;: True or False, # True if and only if tests with this model are recorded by stitching
# together screenshots. See use_low_spec_video_recording in device config.
&quot;form&quot;: &quot;A String&quot;, # Whether this device is virtual or physical.
&quot;screenDensity&quot;: 42, # Screen density in DPI.
# This corresponds to ro.sf.lcd_density
&quot;codename&quot;: &quot;A String&quot;, # The name of the industrial design.
# This corresponds to android.os.Build.DEVICE.
&quot;id&quot;: &quot;A String&quot;, # The unique opaque id for this model.
# Use this for invoking the TestExecutionService.
&quot;screenY&quot;: 42, # Screen size in the vertical (Y) dimension measured in pixels.
&quot;screenX&quot;: 42, # Screen size in the horizontal (X) dimension measured in pixels.
&quot;manufacturer&quot;: &quot;A String&quot;, # The manufacturer of this device.
&quot;formFactor&quot;: &quot;A String&quot;, # Whether this device is a phone, tablet, wearable, etc.
&quot;name&quot;: &quot;A String&quot;, # The human-readable marketing name for this device model.
# Examples: &quot;Nexus 5&quot;, &quot;Galaxy S5&quot;.
&quot;supportedVersionIds&quot;: [ # The set of Android versions this device supports.
&quot;A String&quot;,
],
&quot;brand&quot;: &quot;A String&quot;, # The company that this device is branded with.
# Example: &quot;Google&quot;, &quot;Samsung&quot;.
&quot;supportedAbis&quot;: [ # The list of supported ABIs for this device.
# This corresponds to either android.os.Build.SUPPORTED_ABIS (for API level
# 21 and above) or android.os.Build.CPU_ABI/CPU_ABI2.
# The most preferred ABI is the first element in the list.
#
# Elements are optionally prefixed by &quot;version_id:&quot; (where version_id is
# the id of an AndroidVersion), denoting an ABI that is supported only on
# a particular version.
&quot;A String&quot;,
],
&quot;tags&quot;: [ # Tags for this dimension.
# Examples: &quot;default&quot;, &quot;preview&quot;, &quot;deprecated&quot;.
&quot;A String&quot;,
],
},
],
&quot;versions&quot;: [ # The set of supported Android OS versions.
{ # A version of the Android OS.
&quot;releaseDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date this Android version became available in the market.
# and time zone are either specified elsewhere or are not significant. The date
# is relative to the Proleptic Gregorian Calendar. This can represent:
#
# * A full date, with non-zero year, month and day values
# * A month and day value, with a zero year, e.g. an anniversary
# * A year on its own, with zero month and day values
# * A year and month value, with a zero day, e.g. a credit card expiration date
#
# Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
&quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
# a year.
&quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
# month and day.
&quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year by itself or a year and month where the day is not
# significant.
},
&quot;tags&quot;: [ # Tags for this dimension.
# Examples: &quot;default&quot;, &quot;preview&quot;, &quot;deprecated&quot;.
&quot;A String&quot;,
],
&quot;id&quot;: &quot;A String&quot;, # An opaque id for this Android version.
# Use this id to invoke the TestExecutionService.
&quot;versionString&quot;: &quot;A String&quot;, # A string representing this version of the Android OS.
# Examples: &quot;4.3&quot;, &quot;4.4&quot;.
&quot;codeName&quot;: &quot;A String&quot;, # The code name for this Android version.
# Examples: &quot;JellyBean&quot;, &quot;KitKat&quot;.
&quot;distribution&quot;: { # Data about the relative number of devices running a # Market share for this version.
# given configuration of the Android platform.
&quot;measurementTime&quot;: &quot;A String&quot;, # Output only. The time this distribution was measured.
&quot;marketShare&quot;: 3.14, # Output only. The estimated fraction (0-1) of the total market with this
# configuration.
},
&quot;apiLevel&quot;: 42, # The API level for this Android version.
# Examples: 18, 19.
},
],
&quot;runtimeConfiguration&quot;: { # Android configuration that can be selected at the time a test is run. # The set of supported runtime configurations.
&quot;locales&quot;: [ # The set of available locales.
{ # A location/region designation for language.
&quot;id&quot;: &quot;A String&quot;, # The id for this locale.
# Example: &quot;en_US&quot;.
&quot;region&quot;: &quot;A String&quot;, # A human-friendly string representing the region for this
# locale. Example: &quot;United States&quot;. Not present for every locale.
&quot;tags&quot;: [ # Tags for this dimension.
# Example: &quot;default&quot;.
&quot;A String&quot;,
],
&quot;name&quot;: &quot;A String&quot;, # A human-friendly name for this language/locale.
# Example: &quot;English&quot;.
},
],
&quot;orientations&quot;: [ # The set of available orientations.
{ # Screen orientation of the device.
&quot;name&quot;: &quot;A String&quot;, # A human-friendly name for this orientation.
# Example: &quot;portrait&quot;.
&quot;tags&quot;: [ # Tags for this dimension.
# Example: &quot;default&quot;.
&quot;A String&quot;,
],
&quot;id&quot;: &quot;A String&quot;, # The id for this orientation.
# Example: &quot;portrait&quot;.
},
],
},
},
&quot;iosDeviceCatalog&quot;: { # The currently supported iOS devices. # Supported iOS devices.
&quot;runtimeConfiguration&quot;: { # iOS configuration that can be selected at the time a test is run. # The set of supported runtime configurations.
&quot;orientations&quot;: [ # The set of available orientations.
{ # Screen orientation of the device.
&quot;name&quot;: &quot;A String&quot;, # A human-friendly name for this orientation.
# Example: &quot;portrait&quot;.
&quot;tags&quot;: [ # Tags for this dimension.
# Example: &quot;default&quot;.
&quot;A String&quot;,
],
&quot;id&quot;: &quot;A String&quot;, # The id for this orientation.
# Example: &quot;portrait&quot;.
},
],
&quot;locales&quot;: [ # The set of available locales.
{ # A location/region designation for language.
&quot;id&quot;: &quot;A String&quot;, # The id for this locale.
# Example: &quot;en_US&quot;.
&quot;region&quot;: &quot;A String&quot;, # A human-friendly string representing the region for this
# locale. Example: &quot;United States&quot;. Not present for every locale.
&quot;tags&quot;: [ # Tags for this dimension.
# Example: &quot;default&quot;.
&quot;A String&quot;,
],
&quot;name&quot;: &quot;A String&quot;, # A human-friendly name for this language/locale.
# Example: &quot;English&quot;.
},
],
},
&quot;xcodeVersions&quot;: [ # The set of supported Xcode versions.
{ # An Xcode version that an iOS version is compatible with.
&quot;version&quot;: &quot;A String&quot;, # The id for this version.
# Example: &quot;9.2&quot;.
&quot;tags&quot;: [ # Tags for this Xcode version.
# Example: &quot;default&quot;.
&quot;A String&quot;,
],
},
],
&quot;models&quot;: [ # The set of supported iOS device models.
{ # A description of an iOS device tests may be run on.
# Next tag: 13
&quot;name&quot;: &quot;A String&quot;, # The human-readable name for this device model.
# Examples: &quot;iPhone 4s&quot;, &quot;iPad Mini 2&quot;.
&quot;formFactor&quot;: &quot;A String&quot;, # Whether this device is a phone, tablet, wearable, etc.
&quot;supportedVersionIds&quot;: [ # The set of iOS major software versions this device supports.
&quot;A String&quot;,
],
&quot;tags&quot;: [ # Tags for this dimension.
# Examples: &quot;default&quot;, &quot;preview&quot;, &quot;deprecated&quot;.
&quot;A String&quot;,
],
&quot;screenDensity&quot;: 42, # Screen density in DPI.
&quot;screenX&quot;: 42, # Screen size in the horizontal (X) dimension measured in pixels.
&quot;id&quot;: &quot;A String&quot;, # The unique opaque id for this model.
# Use this for invoking the TestExecutionService.
&quot;screenY&quot;: 42, # Screen size in the vertical (Y) dimension measured in pixels.
&quot;deviceCapabilities&quot;: [ # Device capabilities.
# Copied from
# https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html
&quot;A String&quot;,
],
},
],
&quot;versions&quot;: [ # The set of supported iOS software versions.
{ # An iOS version.
&quot;id&quot;: &quot;A String&quot;, # An opaque id for this iOS version.
# Use this id to invoke the TestExecutionService.
&quot;majorVersion&quot;: 42, # An integer representing the major iOS version.
# Examples: &quot;8&quot;, &quot;9&quot;.
&quot;supportedXcodeVersionIds&quot;: [ # The available Xcode versions for this version.
&quot;A String&quot;,
],
&quot;minorVersion&quot;: 42, # An integer representing the minor iOS version.
# Examples: &quot;1&quot;, &quot;2&quot;.
&quot;tags&quot;: [ # Tags for this dimension.
# Examples: &quot;default&quot;, &quot;preview&quot;, &quot;deprecated&quot;.
&quot;A String&quot;,
],
},
],
},
}</pre>
</div>
</body></html>