Class: Google::Apis::TestingV1::TestingService

Inherits:
Core::BaseService
  • Object
show all
Defined in:
lib/google/apis/testing_v1/service.rb

Overview

Cloud Testing API

Allows developers to run automated tests for their mobile applications on Google infrastructure.

Examples:

require 'google/apis/testing_v1'

Testing = Google::Apis::TestingV1 # Alias the module
service = Testing::TestingService.new

See Also:

Constant Summary collapse

DEFAULT_ENDPOINT_TEMPLATE = 
"https://testing.$UNIVERSE_DOMAIN$/"

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ TestingService

Returns a new instance of TestingService.



48
49
50
51
52
53
 
# File 'lib/google/apis/testing_v1/service.rb', line 48

def initialize
  super(DEFAULT_ENDPOINT_TEMPLATE, '',
        client_name: 'google-apis-testing_v1',
        client_version: Google::Apis::TestingV1::GEM_VERSION)
  @batch_path = 'batch'
end

Instance Attribute Details

#key ⇒ String

Returns API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

Returns:

  • (String) —

    API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.



41
42
43
 
# File 'lib/google/apis/testing_v1/service.rb', line 41

def key
  @key
end

#quota_user ⇒ String

Returns Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

Returns:

  • (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.



46
47
48
 
# File 'lib/google/apis/testing_v1/service.rb', line 46

def quota_user
  @quota_user
end

Instance Method Details

#cancel_device_session(name, cancel_device_session_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::Empty

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.

Parameters:

  • name (String) —

    Required. Name of the DeviceSession, e.g. "projects/project_id/ deviceSessions/session_id"

  • cancel_device_session_request_object (Google::Apis::TestingV1::CancelDeviceSessionRequest) (defaults to: nil)
  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



115
116
117
118
119
120
121
122
123
124
125
 
# File 'lib/google/apis/testing_v1/service.rb', line 115

def cancel_device_session(name, cancel_device_session_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1/{+name}:cancel', options)
  command.request_representation = Google::Apis::TestingV1::CancelDeviceSessionRequest::Representation
  command.request_object = cancel_device_session_request_object
  command.response_representation = Google::Apis::TestingV1::Empty::Representation
  command.response_class = Google::Apis::TestingV1::Empty
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#cancel_project_test_matrix(project_id, test_matrix_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::CancelTestMatrixResponse

Cancels unfinished test executions in a test matrix. This call returns immediately and cancellation proceeds asynchronously. If the matrix is already final, this operation will have no effect. 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

Parameters:

  • project_id (String) —

    Cloud project that owns the test.

  • test_matrix_id (String) —

    Test matrix that will be canceled.

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



301
302
303
304
305
306
307
308
309
310
 
# File 'lib/google/apis/testing_v1/service.rb', line 301

def cancel_project_test_matrix(project_id, test_matrix_id, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1/projects/{projectId}/testMatrices/{testMatrixId}:cancel', options)
  command.response_representation = Google::Apis::TestingV1::CancelTestMatrixResponse::Representation
  command.response_class = Google::Apis::TestingV1::CancelTestMatrixResponse
  command.params['projectId'] = project_id unless project_id.nil?
  command.params['testMatrixId'] = test_matrix_id unless test_matrix_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_project_device_session(parent, device_session_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::DeviceSession

POST /v1/projects/project_id/deviceSessions

Parameters:

  • parent (String) —

    Required. The Compute Engine project under which this device will be allocated. "projects/project_id"

  • device_session_object (Google::Apis::TestingV1::DeviceSession) (defaults to: nil)
  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



149
150
151
152
153
154
155
156
157
158
159
 
# File 'lib/google/apis/testing_v1/service.rb', line 149

def create_project_device_session(parent, device_session_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1/{+parent}/deviceSessions', options)
  command.request_representation = Google::Apis::TestingV1::DeviceSession::Representation
  command.request_object = device_session_object
  command.response_representation = Google::Apis::TestingV1::DeviceSession::Representation
  command.response_class = Google::Apis::TestingV1::DeviceSession
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_project_test_matrix(project_id, test_matrix_object = nil, request_id: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::TestMatrix

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.

Parameters:

  • project_id (String) —

    The GCE project under which this job will run.

  • test_matrix_object (Google::Apis::TestingV1::TestMatrix) (defaults to: nil)
  • request_id (String) (defaults to: nil) —

    A string id used to detect duplicated requests. Ids are automatically scoped to a project, so users should ensure the ID is unique per-project. A UUID is recommended. Optional, but strongly recommended.

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



345
346
347
348
349
350
351
352
353
354
355
356
 
# File 'lib/google/apis/testing_v1/service.rb', line 345

def create_project_test_matrix(project_id, test_matrix_object = nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1/projects/{projectId}/testMatrices', options)
  command.request_representation = Google::Apis::TestingV1::TestMatrix::Representation
  command.request_object = test_matrix_object
  command.response_representation = Google::Apis::TestingV1::TestMatrix::Representation
  command.response_class = Google::Apis::TestingV1::TestMatrix
  command.params['projectId'] = project_id unless project_id.nil?
  command.query['requestId'] = request_id unless request_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_application_detail_service_apk_details(file_reference_object = nil, bundle_location_gcs_path: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::GetApkDetailsResponse

Gets the details of an Android application APK.

Parameters:

  • file_reference_object (Google::Apis::TestingV1::FileReference) (defaults to: nil)
  • bundle_location_gcs_path (String) (defaults to: nil) —

    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)

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/google/apis/testing_v1/service.rb', line 78

def get_application_detail_service_apk_details(file_reference_object = nil, bundle_location_gcs_path: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1/applicationDetailService/getApkDetails', options)
  command.request_representation = Google::Apis::TestingV1::FileReference::Representation
  command.request_object = file_reference_object
  command.response_representation = Google::Apis::TestingV1::GetApkDetailsResponse::Representation
  command.response_class = Google::Apis::TestingV1::GetApkDetailsResponse
  command.query['bundleLocation.gcsPath'] = bundle_location_gcs_path unless bundle_location_gcs_path.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_device_session(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::DeviceSession

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.

Parameters:

  • name (String) —

    Required. Name of the DeviceSession, e.g. "projects/project_id/ deviceSessions/session_id"

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



184
185
186
187
188
189
190
191
192
 
# File 'lib/google/apis/testing_v1/service.rb', line 184

def get_project_device_session(name, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1/{+name}', options)
  command.response_representation = Google::Apis::TestingV1::DeviceSession::Representation
  command.response_class = Google::Apis::TestingV1::DeviceSession
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_test_matrix(project_id, test_matrix_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::TestMatrix

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

Parameters:

  • project_id (String) —

    Cloud project that owns the test matrix.

  • test_matrix_id (String) —

    Unique test matrix id which was assigned by the service.

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



386
387
388
389
390
391
392
393
394
395
 
# File 'lib/google/apis/testing_v1/service.rb', line 386

def get_project_test_matrix(project_id, test_matrix_id, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1/projects/{projectId}/testMatrices/{testMatrixId}', options)
  command.response_representation = Google::Apis::TestingV1::TestMatrix::Representation
  command.response_class = Google::Apis::TestingV1::TestMatrix
  command.params['projectId'] = project_id unless project_id.nil?
  command.params['testMatrixId'] = test_matrix_id unless test_matrix_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_test_environment_catalog(environment_type, project_id: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::TestEnvironmentCatalog

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

Parameters:

  • environment_type (String) —

    Required. The type of environment that should be listed.

  • project_id (String) (defaults to: nil) —

    For authorization, the cloud project requesting the TestEnvironmentCatalog.

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



422
423
424
425
426
427
428
429
430
431
 
# File 'lib/google/apis/testing_v1/service.rb', line 422

def get_test_environment_catalog(environment_type, project_id: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1/testEnvironmentCatalog/{environmentType}', options)
  command.response_representation = Google::Apis::TestingV1::TestEnvironmentCatalog::Representation
  command.response_class = Google::Apis::TestingV1::TestEnvironmentCatalog
  command.params['environmentType'] = environment_type unless environment_type.nil?
  command.query['projectId'] = project_id unless project_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_project_device_sessions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::ListDeviceSessionsResponse

GET /v1/projects/project_id/deviceSessions Lists device Sessions owned by the project user.

Parameters:

  • parent (String) —

    Required. The name of the parent to request, e.g. "projects/project_id"

  • filter (String) (defaults to: nil) —

    Optional. If specified, responses will be filtered by the given filter. Allowed fields are: session_state.

  • page_size (Fixnum) (defaults to: nil) —

    Optional. The maximum number of DeviceSessions to return.

  • page_token (String) (defaults to: nil) —

    Optional. A continuation token for paging.

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



222
223
224
225
226
227
228
229
230
231
232
233
 
# File 'lib/google/apis/testing_v1/service.rb', line 222

def list_project_device_sessions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1/{+parent}/deviceSessions', options)
  command.response_representation = Google::Apis::TestingV1::ListDeviceSessionsResponse::Representation
  command.response_class = Google::Apis::TestingV1::ListDeviceSessionsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['filter'] = filter unless filter.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#patch_project_device_session(name, device_session_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::TestingV1::DeviceSession

PATCH /v1/projects/projectId/deviceSessions/deviceSessionId`: updateDeviceSession Updates the current device session to the fields described by the update_mask.

Parameters:

  • name (String) —

    Optional. Name of the DeviceSession, e.g. "projects/project_id/ deviceSessions/session_id"

  • device_session_object (Google::Apis::TestingV1::DeviceSession) (defaults to: nil)
  • update_mask (String) (defaults to: nil) —

    Required. The list of fields to update.

  • fields (String) (defaults to: nil) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) (defaults to: nil) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) (defaults to: nil) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:

  • (Google::Apis::ServerError) —

    An error occurred on the server and the request can be retried

  • (Google::Apis::ClientError) —

    The request is invalid and should not be retried without modification

  • (Google::Apis::AuthorizationError) —

    Authorization is required



261
262
263
264
265
266
267
268
269
270
271
272
 
# File 'lib/google/apis/testing_v1/service.rb', line 261

def patch_project_device_session(name, device_session_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:patch, 'v1/{+name}', options)
  command.request_representation = Google::Apis::TestingV1::DeviceSession::Representation
  command.request_object = device_session_object
  command.response_representation = Google::Apis::TestingV1::DeviceSession::Representation
  command.response_class = Google::Apis::TestingV1::DeviceSession
  command.params['name'] = name unless name.nil?
  command.query['updateMask'] = update_mask unless update_mask.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end