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:

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ TestingService

Returns a new instance of TestingService.



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

def initialize
  super('https://testing.googleapis.com/', '',
        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.



39
40
41
 
# File 'lib/google/apis/testing_v1/service.rb', line 39

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.



44
45
46
 
# File 'lib/google/apis/testing_v1/service.rb', line 44

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



108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/google/apis/testing_v1/service.rb', line 108

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



294
295
296
297
298
299
300
301
302
303
 
# File 'lib/google/apis/testing_v1/service.rb', line 294

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



142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/google/apis/testing_v1/service.rb', line 142

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



338
339
340
341
342
343
344
345
346
347
348
349
 
# File 'lib/google/apis/testing_v1/service.rb', line 338

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, 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)
  • 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



72
73
74
75
76
77
78
79
80
81
 
# File 'lib/google/apis/testing_v1/service.rb', line 72

def get_application_detail_service_apk_details(file_reference_object = 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['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



177
178
179
180
181
182
183
184
185
 
# File 'lib/google/apis/testing_v1/service.rb', line 177

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



379
380
381
382
383
384
385
386
387
388
 
# File 'lib/google/apis/testing_v1/service.rb', line 379

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



415
416
417
418
419
420
421
422
423
424
 
# File 'lib/google/apis/testing_v1/service.rb', line 415

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



215
216
217
218
219
220
221
222
223
224
225
226
 
# File 'lib/google/apis/testing_v1/service.rb', line 215

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



254
255
256
257
258
259
260
261
262
263
264
265
 
# File 'lib/google/apis/testing_v1/service.rb', line 254

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