Class: Google::Apis::ScriptV1::ScriptService
- Inherits:
-
Core::BaseService
- Object
- Core::BaseService
- Google::Apis::ScriptV1::ScriptService
- Defined in:
- generated/google/apis/script_v1/service.rb
Overview
Apps Script API
An API for managing and executing Google Apps Script projects.
Instance Attribute Summary collapse
-
#key ⇒ String
API key.
-
#quota_user ⇒ String
Available to use for quota purposes for server-side applications.
Attributes inherited from Core::BaseService
#authorization, #base_path, #batch_path, #client, #client_options, #request_options, #root_url, #upload_path
Instance Method Summary collapse
-
#create_project(create_project_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Project
Creates a new, empty script project with no script files and a base manifest file.
-
#create_project_deployment(script_id, deployment_config_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Deployment
Creates a deployment of an Apps Script project.
-
#create_project_version(script_id, version_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Version
Creates a new immutable version using the current code, with a unique version number.
-
#delete_project_deployment(script_id, deployment_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Empty
Deletes a deployment of an Apps Script project.
-
#get_project(script_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Project
Gets a script project's metadata.
-
#get_project_content(script_id, version_number: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Content
Gets the content of the script project, including the code source and metadata for each script file.
-
#get_project_deployment(script_id, deployment_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Deployment
Gets a deployment of an Apps Script project.
-
#get_project_metrics(script_id, metrics_filter_deployment_id: nil, metrics_granularity: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Metrics
Get metrics data for scripts, such as number of executions and active users.
-
#get_project_version(script_id, version_number, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Version
Gets a version of a script project.
-
#initialize ⇒ ScriptService
constructor
A new instance of ScriptService.
-
#list_process_script_processes(page_size: nil, page_token: nil, script_id: nil, script_process_filter_deployment_id: nil, script_process_filter_end_time: nil, script_process_filter_function_name: nil, script_process_filter_start_time: nil, script_process_filter_statuses: nil, script_process_filter_types: nil, script_process_filter_user_access_levels: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListScriptProcessesResponse
List information about a script's executed processes, such as process type and current status.
-
#list_processes(page_size: nil, page_token: nil, user_process_filter_deployment_id: nil, user_process_filter_end_time: nil, user_process_filter_function_name: nil, user_process_filter_project_name: nil, user_process_filter_script_id: nil, user_process_filter_start_time: nil, user_process_filter_statuses: nil, user_process_filter_types: nil, user_process_filter_user_access_levels: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListUserProcessesResponse
List information about processes made by or on behalf of a user, such as process type and current status.
-
#list_project_deployments(script_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListDeploymentsResponse
Lists the deployments of an Apps Script project.
-
#list_project_versions(script_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListVersionsResponse
List the versions of a script project.
-
#run_script(script_id, execution_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Operation
Runs a function in an Apps Script project.
-
#update_deployment(script_id, deployment_id, update_deployment_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Deployment
Updates a deployment of an Apps Script project.
-
#update_project_content(script_id, content_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Content
Updates the content of the specified script project.
Methods inherited from Core::BaseService
#batch, #batch_upload, #fetch_all, #http
Methods included from Core::Logging
Constructor Details
#initialize ⇒ ScriptService
Returns a new instance of ScriptService
51 52 53 54 |
# File 'generated/google/apis/script_v1/service.rb', line 51 def initialize super('https://script.googleapis.com/', '') @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.
44 45 46 |
# File 'generated/google/apis/script_v1/service.rb', line 44 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.
49 50 51 |
# File 'generated/google/apis/script_v1/service.rb', line 49 def quota_user @quota_user end |
Instance Method Details
#create_project(create_project_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Project
Creates a new, empty script project with no script files and a base manifest file.
215 216 217 218 219 220 221 222 223 224 |
# File 'generated/google/apis/script_v1/service.rb', line 215 def create_project(create_project_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/projects', ) command.request_representation = Google::Apis::ScriptV1::CreateProjectRequest::Representation command.request_object = create_project_request_object command.response_representation = Google::Apis::ScriptV1::Project::Representation command.response_class = Google::Apis::ScriptV1::Project 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_deployment(script_id, deployment_config_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Deployment
Creates a deployment of an Apps Script project.
386 387 388 389 390 391 392 393 394 395 396 |
# File 'generated/google/apis/script_v1/service.rb', line 386 def create_project_deployment(script_id, deployment_config_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/projects/{scriptId}/deployments', ) command.request_representation = Google::Apis::ScriptV1::DeploymentConfig::Representation command.request_object = deployment_config_object command.response_representation = Google::Apis::ScriptV1::Deployment::Representation command.response_class = Google::Apis::ScriptV1::Deployment command.params['scriptId'] = script_id unless script_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_version(script_id, version_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Version
Creates a new immutable version using the current code, with a unique version number.
559 560 561 562 563 564 565 566 567 568 569 |
# File 'generated/google/apis/script_v1/service.rb', line 559 def create_project_version(script_id, version_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/projects/{scriptId}/versions', ) command.request_representation = Google::Apis::ScriptV1::Version::Representation command.request_object = version_object command.response_representation = Google::Apis::ScriptV1::Version::Representation command.response_class = Google::Apis::ScriptV1::Version command.params['scriptId'] = script_id unless script_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 |
#delete_project_deployment(script_id, deployment_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Empty
Deletes a deployment of an Apps Script project.
420 421 422 423 424 425 426 427 428 429 |
# File 'generated/google/apis/script_v1/service.rb', line 420 def delete_project_deployment(script_id, deployment_id, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:delete, 'v1/projects/{scriptId}/deployments/{deploymentId}', ) command.response_representation = Google::Apis::ScriptV1::Empty::Representation command.response_class = Google::Apis::ScriptV1::Empty command.params['scriptId'] = script_id unless script_id.nil? command.params['deploymentId'] = deployment_id unless deployment_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_project(script_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Project
Gets a script project's metadata.
246 247 248 249 250 251 252 253 254 |
# File 'generated/google/apis/script_v1/service.rb', line 246 def get_project(script_id, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}', ) command.response_representation = Google::Apis::ScriptV1::Project::Representation command.response_class = Google::Apis::ScriptV1::Project command.params['scriptId'] = script_id unless script_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_project_content(script_id, version_number: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Content
Gets the content of the script project, including the code source and metadata for each script file.
280 281 282 283 284 285 286 287 288 289 |
# File 'generated/google/apis/script_v1/service.rb', line 280 def get_project_content(script_id, version_number: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}/content', ) command.response_representation = Google::Apis::ScriptV1::Content::Representation command.response_class = Google::Apis::ScriptV1::Content command.params['scriptId'] = script_id unless script_id.nil? command.query['versionNumber'] = version_number unless version_number.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_deployment(script_id, deployment_id, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Deployment
Gets a deployment of an Apps Script project.
453 454 455 456 457 458 459 460 461 462 |
# File 'generated/google/apis/script_v1/service.rb', line 453 def get_project_deployment(script_id, deployment_id, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}/deployments/{deploymentId}', ) command.response_representation = Google::Apis::ScriptV1::Deployment::Representation command.response_class = Google::Apis::ScriptV1::Deployment command.params['scriptId'] = script_id unless script_id.nil? command.params['deploymentId'] = deployment_id unless deployment_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_project_metrics(script_id, metrics_filter_deployment_id: nil, metrics_granularity: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Metrics
Get metrics data for scripts, such as number of executions and active users.
316 317 318 319 320 321 322 323 324 325 326 |
# File 'generated/google/apis/script_v1/service.rb', line 316 def get_project_metrics(script_id, metrics_filter_deployment_id: nil, metrics_granularity: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}/metrics', ) command.response_representation = Google::Apis::ScriptV1::Metrics::Representation command.response_class = Google::Apis::ScriptV1::Metrics command.params['scriptId'] = script_id unless script_id.nil? command.query['metricsFilter.deploymentId'] = metrics_filter_deployment_id unless metrics_filter_deployment_id.nil? command.query['metricsGranularity'] = metrics_granularity unless metrics_granularity.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_version(script_id, version_number, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Version
Gets a version of a script project.
593 594 595 596 597 598 599 600 601 602 |
# File 'generated/google/apis/script_v1/service.rb', line 593 def get_project_version(script_id, version_number, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}/versions/{versionNumber}', ) command.response_representation = Google::Apis::ScriptV1::Version::Representation command.response_class = Google::Apis::ScriptV1::Version command.params['scriptId'] = script_id unless script_id.nil? command.params['versionNumber'] = version_number unless version_number.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_process_script_processes(page_size: nil, page_token: nil, script_id: nil, script_process_filter_deployment_id: nil, script_process_filter_end_time: nil, script_process_filter_function_name: nil, script_process_filter_start_time: nil, script_process_filter_statuses: nil, script_process_filter_types: nil, script_process_filter_user_access_levels: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListScriptProcessesResponse
List information about a script's executed processes, such as process type and current status.
176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 |
# File 'generated/google/apis/script_v1/service.rb', line 176 def list_process_script_processes(page_size: nil, page_token: nil, script_id: nil, script_process_filter_deployment_id: nil, script_process_filter_end_time: nil, script_process_filter_function_name: nil, script_process_filter_start_time: nil, script_process_filter_statuses: nil, script_process_filter_types: nil, script_process_filter_user_access_levels: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/processes:listScriptProcesses', ) command.response_representation = Google::Apis::ScriptV1::ListScriptProcessesResponse::Representation command.response_class = Google::Apis::ScriptV1::ListScriptProcessesResponse command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['scriptId'] = script_id unless script_id.nil? command.query['scriptProcessFilter.deploymentId'] = script_process_filter_deployment_id unless script_process_filter_deployment_id.nil? command.query['scriptProcessFilter.endTime'] = script_process_filter_end_time unless script_process_filter_end_time.nil? command.query['scriptProcessFilter.functionName'] = script_process_filter_function_name unless script_process_filter_function_name.nil? command.query['scriptProcessFilter.startTime'] = script_process_filter_start_time unless script_process_filter_start_time.nil? command.query['scriptProcessFilter.statuses'] = script_process_filter_statuses unless script_process_filter_statuses.nil? command.query['scriptProcessFilter.types'] = script_process_filter_types unless script_process_filter_types.nil? command.query['scriptProcessFilter.userAccessLevels'] = script_process_filter_user_access_levels unless script_process_filter_user_access_levels.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_processes(page_size: nil, page_token: nil, user_process_filter_deployment_id: nil, user_process_filter_end_time: nil, user_process_filter_function_name: nil, user_process_filter_project_name: nil, user_process_filter_script_id: nil, user_process_filter_start_time: nil, user_process_filter_statuses: nil, user_process_filter_types: nil, user_process_filter_user_access_levels: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListUserProcessesResponse
List information about processes made by or on behalf of a user, such as process type and current status.
108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 |
# File 'generated/google/apis/script_v1/service.rb', line 108 def list_processes(page_size: nil, page_token: nil, user_process_filter_deployment_id: nil, user_process_filter_end_time: nil, user_process_filter_function_name: nil, user_process_filter_project_name: nil, user_process_filter_script_id: nil, user_process_filter_start_time: nil, user_process_filter_statuses: nil, user_process_filter_types: nil, user_process_filter_user_access_levels: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/processes', ) command.response_representation = Google::Apis::ScriptV1::ListUserProcessesResponse::Representation command.response_class = Google::Apis::ScriptV1::ListUserProcessesResponse command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['userProcessFilter.deploymentId'] = user_process_filter_deployment_id unless user_process_filter_deployment_id.nil? command.query['userProcessFilter.endTime'] = user_process_filter_end_time unless user_process_filter_end_time.nil? command.query['userProcessFilter.functionName'] = user_process_filter_function_name unless user_process_filter_function_name.nil? command.query['userProcessFilter.projectName'] = user_process_filter_project_name unless user_process_filter_project_name.nil? command.query['userProcessFilter.scriptId'] = user_process_filter_script_id unless user_process_filter_script_id.nil? command.query['userProcessFilter.startTime'] = user_process_filter_start_time unless user_process_filter_start_time.nil? command.query['userProcessFilter.statuses'] = user_process_filter_statuses unless user_process_filter_statuses.nil? command.query['userProcessFilter.types'] = user_process_filter_types unless user_process_filter_types.nil? command.query['userProcessFilter.userAccessLevels'] = user_process_filter_user_access_levels unless user_process_filter_user_access_levels.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_deployments(script_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListDeploymentsResponse
Lists the deployments of an Apps Script project.
489 490 491 492 493 494 495 496 497 498 499 |
# File 'generated/google/apis/script_v1/service.rb', line 489 def list_project_deployments(script_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}/deployments', ) command.response_representation = Google::Apis::ScriptV1::ListDeploymentsResponse::Representation command.response_class = Google::Apis::ScriptV1::ListDeploymentsResponse command.params['scriptId'] = script_id unless script_id.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 |
#list_project_versions(script_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::ListVersionsResponse
List the versions of a script project.
629 630 631 632 633 634 635 636 637 638 639 |
# File 'generated/google/apis/script_v1/service.rb', line 629 def list_project_versions(script_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1/projects/{scriptId}/versions', ) command.response_representation = Google::Apis::ScriptV1::ListVersionsResponse::Representation command.response_class = Google::Apis::ScriptV1::ListVersionsResponse command.params['scriptId'] = script_id unless script_id.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 |
#run_script(script_id, execution_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Operation
Runs a function in an Apps Script project. The project must be deployed for use with the Apps Script API. This method requires authorization with an OAuth 2.0 token that includes at least one of the scopes listed in the Authorization section; script projects that do not require authorization cannot be executed through this API. To find the correct scopes to include in the authentication token, open the project in the script editor, then select File > Project properties and click the Scopes tab.
670 671 672 673 674 675 676 677 678 679 680 |
# File 'generated/google/apis/script_v1/service.rb', line 670 def run_script(script_id, execution_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:post, 'v1/scripts/{scriptId}:run', ) command.request_representation = Google::Apis::ScriptV1::ExecutionRequest::Representation command.request_object = execution_request_object command.response_representation = Google::Apis::ScriptV1::Operation::Representation command.response_class = Google::Apis::ScriptV1::Operation command.params['scriptId'] = script_id unless script_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 |
#update_deployment(script_id, deployment_id, update_deployment_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Deployment
Updates a deployment of an Apps Script project.
524 525 526 527 528 529 530 531 532 533 534 535 |
# File 'generated/google/apis/script_v1/service.rb', line 524 def update_deployment(script_id, deployment_id, update_deployment_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'v1/projects/{scriptId}/deployments/{deploymentId}', ) command.request_representation = Google::Apis::ScriptV1::UpdateDeploymentRequest::Representation command.request_object = update_deployment_request_object command.response_representation = Google::Apis::ScriptV1::Deployment::Representation command.response_class = Google::Apis::ScriptV1::Deployment command.params['scriptId'] = script_id unless script_id.nil? command.params['deploymentId'] = deployment_id unless deployment_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 |
#update_project_content(script_id, content_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::ScriptV1::Content
Updates the content of the specified script project. This content is stored as the HEAD version, and is used when the script is executed as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. This clears all the existing files in the project.
353 354 355 356 357 358 359 360 361 362 363 |
# File 'generated/google/apis/script_v1/service.rb', line 353 def update_project_content(script_id, content_object = nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:put, 'v1/projects/{scriptId}/content', ) command.request_representation = Google::Apis::ScriptV1::Content::Representation command.request_object = content_object command.response_representation = Google::Apis::ScriptV1::Content::Representation command.response_class = Google::Apis::ScriptV1::Content command.params['scriptId'] = script_id unless script_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 |