blob: 342e9ca05bd18e5ef6dbdd78210b312c2bd90af8 [file] [log] [blame] [edit]
// This is a generated file (see the discoveryapis_generator project).
// ignore_for_file: camel_case_types
// ignore_for_file: comment_references
// ignore_for_file: deprecated_member_use_from_same_package
// ignore_for_file: doc_directive_unknown
// ignore_for_file: lines_longer_than_80_chars
// ignore_for_file: non_constant_identifier_names
// ignore_for_file: prefer_interpolation_to_compose_strings
// ignore_for_file: unintended_html_in_doc_comment
// ignore_for_file: unnecessary_brace_in_string_interps
// ignore_for_file: unnecessary_lambdas
// ignore_for_file: unnecessary_string_interpolations
/// Apps Script API - v1
///
/// Manages and executes Google Apps Script projects.
///
/// For more information, see <https://developers.google.com/apps-script/api/>
///
/// Create an instance of [ScriptApi] to access these resources:
///
/// - [ProcessesResource]
/// - [ProjectsResource]
/// - [ProjectsDeploymentsResource]
/// - [ProjectsVersionsResource]
/// - [ScriptsResource]
library;
import 'dart:async' as async;
import 'dart:convert' as convert;
import 'dart:core' as core;
import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
import 'package:http/http.dart' as http;
import '../shared.dart';
import '../src/user_agent.dart';
export 'package:_discoveryapis_commons/_discoveryapis_commons.dart'
show ApiRequestError, DetailedApiRequestError;
/// Manages and executes Google Apps Script projects.
class ScriptApi {
/// Read, compose, send, and permanently delete all your email from Gmail
static const mailGoogleComScope = 'https://mail.google.com/';
/// See, edit, share, and permanently delete all the calendars you can access
/// using Google Calendar
static const wwwGoogleComCalendarFeedsScope =
'https://www.google.com/calendar/feeds';
/// See, edit, download, and permanently delete your contacts
static const wwwGoogleComM8FeedsScope = 'https://www.google.com/m8/feeds';
/// View and manage the provisioning of groups on your domain
static const adminDirectoryGroupScope =
'https://www.googleapis.com/auth/admin.directory.group';
/// View and manage the provisioning of users on your domain
static const adminDirectoryUserScope =
'https://www.googleapis.com/auth/admin.directory.user';
/// See, edit, create, and delete all your Google Docs documents
static const documentsScope = 'https://www.googleapis.com/auth/documents';
/// See, edit, create, and delete all of your Google Drive files
static const driveScope = 'https://www.googleapis.com/auth/drive';
/// View and manage your forms in Google Drive
static const formsScope = 'https://www.googleapis.com/auth/forms';
/// View and manage forms that this application has been installed in
static const formsCurrentonlyScope =
'https://www.googleapis.com/auth/forms.currentonly';
/// View and manage your Google Groups
static const groupsScope = 'https://www.googleapis.com/auth/groups';
/// Create and update Google Apps Script deployments
static const scriptDeploymentsScope =
'https://www.googleapis.com/auth/script.deployments';
/// View Google Apps Script deployments
static const scriptDeploymentsReadonlyScope =
'https://www.googleapis.com/auth/script.deployments.readonly';
/// View Google Apps Script project's metrics
static const scriptMetricsScope =
'https://www.googleapis.com/auth/script.metrics';
/// View Google Apps Script processes
static const scriptProcessesScope =
'https://www.googleapis.com/auth/script.processes';
/// Create and update Google Apps Script projects
static const scriptProjectsScope =
'https://www.googleapis.com/auth/script.projects';
/// View Google Apps Script projects
static const scriptProjectsReadonlyScope =
'https://www.googleapis.com/auth/script.projects.readonly';
/// See, edit, create, and delete all your Google Sheets spreadsheets
static const spreadsheetsScope =
'https://www.googleapis.com/auth/spreadsheets';
/// See your primary Google Account email address
static const userinfoEmailScope =
'https://www.googleapis.com/auth/userinfo.email';
final commons.ApiRequester _requester;
ProcessesResource get processes => ProcessesResource(_requester);
ProjectsResource get projects => ProjectsResource(_requester);
ScriptsResource get scripts => ScriptsResource(_requester);
ScriptApi(
http.Client client, {
core.String rootUrl = 'https://script.googleapis.com/',
core.String servicePath = '',
}) : _requester = commons.ApiRequester(
client,
rootUrl,
servicePath,
requestHeaders,
);
}
class ProcessesResource {
final commons.ApiRequester _requester;
ProcessesResource(commons.ApiRequester client) : _requester = client;
/// List information about processes made by or on behalf of a user, such as
/// process type and current status.
///
/// Request parameters:
///
/// [pageSize] - The maximum number of returned processes per page of results.
/// Defaults to 50.
///
/// [pageToken] - The token for continuing a previous list request on the next
/// page. This should be set to the value of `nextPageToken` from a previous
/// response.
///
/// [userProcessFilter_deploymentId] - Optional field used to limit returned
/// processes to those originating from projects with a specific deployment
/// ID.
///
/// [userProcessFilter_endTime] - Optional field used to limit returned
/// processes to those that completed on or before the given timestamp.
///
/// [userProcessFilter_functionName] - Optional field used to limit returned
/// processes to those originating from a script function with the given
/// function name.
///
/// [userProcessFilter_projectName] - Optional field used to limit returned
/// processes to those originating from projects with project names containing
/// a specific string.
///
/// [userProcessFilter_scriptId] - Optional field used to limit returned
/// processes to those originating from projects with a specific script ID.
///
/// [userProcessFilter_startTime] - Optional field used to limit returned
/// processes to those that were started on or after the given timestamp.
///
/// [userProcessFilter_statuses] - Optional field used to limit returned
/// processes to those having one of the specified process statuses.
///
/// [userProcessFilter_types] - Optional field used to limit returned
/// processes to those having one of the specified process types.
///
/// [userProcessFilter_userAccessLevels] - Optional field used to limit
/// returned processes to those having one of the specified user access
/// levels.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [ListUserProcessesResponse].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<ListUserProcessesResponse> list({
core.int? pageSize,
core.String? pageToken,
core.String? userProcessFilter_deploymentId,
core.String? userProcessFilter_endTime,
core.String? userProcessFilter_functionName,
core.String? userProcessFilter_projectName,
core.String? userProcessFilter_scriptId,
core.String? userProcessFilter_startTime,
core.List<core.String>? userProcessFilter_statuses,
core.List<core.String>? userProcessFilter_types,
core.List<core.String>? userProcessFilter_userAccessLevels,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if (userProcessFilter_deploymentId != null)
'userProcessFilter.deploymentId': [userProcessFilter_deploymentId],
if (userProcessFilter_endTime != null)
'userProcessFilter.endTime': [userProcessFilter_endTime],
if (userProcessFilter_functionName != null)
'userProcessFilter.functionName': [userProcessFilter_functionName],
if (userProcessFilter_projectName != null)
'userProcessFilter.projectName': [userProcessFilter_projectName],
if (userProcessFilter_scriptId != null)
'userProcessFilter.scriptId': [userProcessFilter_scriptId],
if (userProcessFilter_startTime != null)
'userProcessFilter.startTime': [userProcessFilter_startTime],
if (userProcessFilter_statuses != null)
'userProcessFilter.statuses': userProcessFilter_statuses,
if (userProcessFilter_types != null)
'userProcessFilter.types': userProcessFilter_types,
if (userProcessFilter_userAccessLevels != null)
'userProcessFilter.userAccessLevels':
userProcessFilter_userAccessLevels,
if ($fields != null) 'fields': [$fields],
};
const url_ = 'v1/processes';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListUserProcessesResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
/// List information about a script's executed processes, such as process type
/// and current status.
///
/// Request parameters:
///
/// [pageSize] - The maximum number of returned processes per page of results.
/// Defaults to 50.
///
/// [pageToken] - The token for continuing a previous list request on the next
/// page. This should be set to the value of `nextPageToken` from a previous
/// response.
///
/// [scriptId] - The script ID of the project whose processes are listed.
///
/// [scriptProcessFilter_deploymentId] - Optional field used to limit returned
/// processes to those originating from projects with a specific deployment
/// ID.
///
/// [scriptProcessFilter_endTime] - Optional field used to limit returned
/// processes to those that completed on or before the given timestamp.
///
/// [scriptProcessFilter_functionName] - Optional field used to limit returned
/// processes to those originating from a script function with the given
/// function name.
///
/// [scriptProcessFilter_startTime] - Optional field used to limit returned
/// processes to those that were started on or after the given timestamp.
///
/// [scriptProcessFilter_statuses] - Optional field used to limit returned
/// processes to those having one of the specified process statuses.
///
/// [scriptProcessFilter_types] - Optional field used to limit returned
/// processes to those having one of the specified process types.
///
/// [scriptProcessFilter_userAccessLevels] - Optional field used to limit
/// returned processes to those having one of the specified user access
/// levels.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [ListScriptProcessesResponse].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<ListScriptProcessesResponse> listScriptProcesses({
core.int? pageSize,
core.String? pageToken,
core.String? scriptId,
core.String? scriptProcessFilter_deploymentId,
core.String? scriptProcessFilter_endTime,
core.String? scriptProcessFilter_functionName,
core.String? scriptProcessFilter_startTime,
core.List<core.String>? scriptProcessFilter_statuses,
core.List<core.String>? scriptProcessFilter_types,
core.List<core.String>? scriptProcessFilter_userAccessLevels,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if (scriptId != null) 'scriptId': [scriptId],
if (scriptProcessFilter_deploymentId != null)
'scriptProcessFilter.deploymentId': [scriptProcessFilter_deploymentId],
if (scriptProcessFilter_endTime != null)
'scriptProcessFilter.endTime': [scriptProcessFilter_endTime],
if (scriptProcessFilter_functionName != null)
'scriptProcessFilter.functionName': [scriptProcessFilter_functionName],
if (scriptProcessFilter_startTime != null)
'scriptProcessFilter.startTime': [scriptProcessFilter_startTime],
if (scriptProcessFilter_statuses != null)
'scriptProcessFilter.statuses': scriptProcessFilter_statuses,
if (scriptProcessFilter_types != null)
'scriptProcessFilter.types': scriptProcessFilter_types,
if (scriptProcessFilter_userAccessLevels != null)
'scriptProcessFilter.userAccessLevels':
scriptProcessFilter_userAccessLevels,
if ($fields != null) 'fields': [$fields],
};
const url_ = 'v1/processes:listScriptProcesses';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListScriptProcessesResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
}
class ProjectsResource {
final commons.ApiRequester _requester;
ProjectsDeploymentsResource get deployments =>
ProjectsDeploymentsResource(_requester);
ProjectsVersionsResource get versions => ProjectsVersionsResource(_requester);
ProjectsResource(commons.ApiRequester client) : _requester = client;
/// Creates a new, empty script project with no script files and a base
/// manifest file.
///
/// [request] - The metadata request object.
///
/// Request parameters:
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Project].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Project> create(
CreateProjectRequest request, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
const url_ = 'v1/projects';
final response_ = await _requester.request(
url_,
'POST',
body: body_,
queryParams: queryParams_,
);
return Project.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// Gets a script project's metadata.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Project].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Project> get(
core.String scriptId, {
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ = 'v1/projects/' + commons.escapeVariable('$scriptId');
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return Project.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// Gets the content of the script project, including the code source and
/// metadata for each script file.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [versionNumber] - The version number of the project to retrieve. If not
/// provided, the project's HEAD version is returned.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Content].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Content> getContent(
core.String scriptId, {
core.int? versionNumber,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (versionNumber != null) 'versionNumber': ['${versionNumber}'],
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/content';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return Content.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// Get metrics data for scripts, such as number of executions and active
/// users.
///
/// Request parameters:
///
/// [scriptId] - Required field indicating the script to get metrics for.
///
/// [metricsFilter_deploymentId] - Optional field indicating a specific
/// deployment to retrieve metrics from.
///
/// [metricsGranularity] - Required field indicating what granularity of
/// metrics are returned.
/// Possible string values are:
/// - "UNSPECIFIED_GRANULARITY" : Default metric granularity used to query no
/// metrics.
/// - "WEEKLY" : Represents weekly metrics.
/// - "DAILY" : Represents daily metrics over a period of 7 days.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Metrics].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Metrics> getMetrics(
core.String scriptId, {
core.String? metricsFilter_deploymentId,
core.String? metricsGranularity,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (metricsFilter_deploymentId != null)
'metricsFilter.deploymentId': [metricsFilter_deploymentId],
if (metricsGranularity != null)
'metricsGranularity': [metricsGranularity],
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/metrics';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return Metrics.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// 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.
///
/// [request] - The metadata request object.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Content].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Content> updateContent(
Content request,
core.String scriptId, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/content';
final response_ = await _requester.request(
url_,
'PUT',
body: body_,
queryParams: queryParams_,
);
return Content.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
}
class ProjectsDeploymentsResource {
final commons.ApiRequester _requester;
ProjectsDeploymentsResource(commons.ApiRequester client)
: _requester = client;
/// Creates a deployment of an Apps Script project.
///
/// [request] - The metadata request object.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Deployment].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Deployment> create(
DeploymentConfig request,
core.String scriptId, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/deployments';
final response_ = await _requester.request(
url_,
'POST',
body: body_,
queryParams: queryParams_,
);
return Deployment.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
/// Deletes a deployment of an Apps Script project.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [deploymentId] - The deployment ID to be undeployed.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Empty].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Empty> delete(
core.String scriptId,
core.String deploymentId, {
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' +
commons.escapeVariable('$scriptId') +
'/deployments/' +
commons.escapeVariable('$deploymentId');
final response_ = await _requester.request(
url_,
'DELETE',
queryParams: queryParams_,
);
return Empty.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// Gets a deployment of an Apps Script project.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [deploymentId] - The deployment ID.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Deployment].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Deployment> get(
core.String scriptId,
core.String deploymentId, {
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' +
commons.escapeVariable('$scriptId') +
'/deployments/' +
commons.escapeVariable('$deploymentId');
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return Deployment.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
/// Lists the deployments of an Apps Script project.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [pageSize] - The maximum number of deployments on each returned page.
/// Defaults to 50.
///
/// [pageToken] - The token for continuing a previous list request on the next
/// page. This should be set to the value of `nextPageToken` from a previous
/// response.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [ListDeploymentsResponse].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<ListDeploymentsResponse> list(
core.String scriptId, {
core.int? pageSize,
core.String? pageToken,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/deployments';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListDeploymentsResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
/// Updates a deployment of an Apps Script project.
///
/// [request] - The metadata request object.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [deploymentId] - The deployment ID for this deployment.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Deployment].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Deployment> update(
UpdateDeploymentRequest request,
core.String scriptId,
core.String deploymentId, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' +
commons.escapeVariable('$scriptId') +
'/deployments/' +
commons.escapeVariable('$deploymentId');
final response_ = await _requester.request(
url_,
'PUT',
body: body_,
queryParams: queryParams_,
);
return Deployment.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
}
class ProjectsVersionsResource {
final commons.ApiRequester _requester;
ProjectsVersionsResource(commons.ApiRequester client) : _requester = client;
/// Creates a new immutable version using the current code, with a unique
/// version number.
///
/// [request] - The metadata request object.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Version].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Version> create(
Version request,
core.String scriptId, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/versions';
final response_ = await _requester.request(
url_,
'POST',
body: body_,
queryParams: queryParams_,
);
return Version.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// Gets a version of a script project.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [versionNumber] - The version number.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Version].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Version> get(
core.String scriptId,
core.int versionNumber, {
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' +
commons.escapeVariable('$scriptId') +
'/versions/' +
commons.escapeVariable('$versionNumber');
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return Version.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
/// List the versions of a script project.
///
/// Request parameters:
///
/// [scriptId] - The script project's Drive ID.
///
/// [pageSize] - The maximum number of versions on each returned page.
/// Defaults to 50.
///
/// [pageToken] - The token for continuing a previous list request on the next
/// page. This should be set to the value of `nextPageToken` from a previous
/// response.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [ListVersionsResponse].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<ListVersionsResponse> list(
core.String scriptId, {
core.int? pageSize,
core.String? pageToken,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if ($fields != null) 'fields': [$fields],
};
final url_ =
'v1/projects/' + commons.escapeVariable('$scriptId') + '/versions';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListVersionsResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}
}
class ScriptsResource {
final commons.ApiRequester _requester;
ScriptsResource(commons.ApiRequester client) : _requester = client;
/// [request] - The metadata request object.
///
/// Request parameters:
///
/// [scriptId] - The script ID of the script to be executed. Find the script
/// ID on the **Project settings** page under "IDs." As multiple executable
/// APIs can be deployed in new IDE for same script, this field should be
/// populated with DeploymentID generated while deploying in new IDE instead
/// of script ID.
///
/// [$fields] - Selector specifying which fields to include in a partial
/// response.
///
/// Completes with a [Operation].
///
/// Completes with a [commons.ApiRequestError] if the API endpoint returned an
/// error.
///
/// If the used [http.Client] completes with an error when making a REST call,
/// this method will complete with the same error.
async.Future<Operation> run(
ExecutionRequest request,
core.String scriptId, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ = 'v1/scripts/' + commons.escapeVariable('$scriptId') + ':run';
final response_ = await _requester.request(
url_,
'POST',
body: body_,
queryParams: queryParams_,
);
return Operation.fromJson(response_ as core.Map<core.String, core.dynamic>);
}
}
/// The Content resource.
class Content {
/// The list of script project files.
///
/// One of the files is a script manifest; it must be named "appsscript", must
/// have type of JSON, and include the manifest configurations for the
/// project.
core.List<File>? files;
/// The script project's Drive ID.
core.String? scriptId;
Content({this.files, this.scriptId});
Content.fromJson(core.Map json_)
: this(
files:
(json_['files'] as core.List?)
?.map(
(value) => File.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
scriptId: json_['scriptId'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (files != null) 'files': files!,
if (scriptId != null) 'scriptId': scriptId!,
};
}
/// Request to create a script project.
class CreateProjectRequest {
/// The Drive ID of a parent file that the created script project is bound to.
///
/// This is usually the ID of a Google Doc, Google Sheet, Google Form, or
/// Google Slides file. If not set, a standalone script project is created.
core.String? parentId;
/// The title for the project.
core.String? title;
CreateProjectRequest({this.parentId, this.title});
CreateProjectRequest.fromJson(core.Map json_)
: this(
parentId: json_['parentId'] as core.String?,
title: json_['title'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (parentId != null) 'parentId': parentId!,
if (title != null) 'title': title!,
};
}
/// Representation of a single script deployment.
class Deployment {
/// The deployment configuration.
DeploymentConfig? deploymentConfig;
/// The deployment ID for this deployment.
core.String? deploymentId;
/// The deployment's entry points.
core.List<EntryPoint>? entryPoints;
/// Last modified date time stamp.
core.String? updateTime;
Deployment({
this.deploymentConfig,
this.deploymentId,
this.entryPoints,
this.updateTime,
});
Deployment.fromJson(core.Map json_)
: this(
deploymentConfig:
json_.containsKey('deploymentConfig')
? DeploymentConfig.fromJson(
json_['deploymentConfig']
as core.Map<core.String, core.dynamic>,
)
: null,
deploymentId: json_['deploymentId'] as core.String?,
entryPoints:
(json_['entryPoints'] as core.List?)
?.map(
(value) => EntryPoint.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
updateTime: json_['updateTime'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (deploymentConfig != null) 'deploymentConfig': deploymentConfig!,
if (deploymentId != null) 'deploymentId': deploymentId!,
if (entryPoints != null) 'entryPoints': entryPoints!,
if (updateTime != null) 'updateTime': updateTime!,
};
}
/// Metadata the defines how a deployment is configured.
class DeploymentConfig {
/// The description for this deployment.
core.String? description;
/// The manifest file name for this deployment.
core.String? manifestFileName;
/// The script project's Drive ID.
core.String? scriptId;
/// The version number on which this deployment is based.
core.int? versionNumber;
DeploymentConfig({
this.description,
this.manifestFileName,
this.scriptId,
this.versionNumber,
});
DeploymentConfig.fromJson(core.Map json_)
: this(
description: json_['description'] as core.String?,
manifestFileName: json_['manifestFileName'] as core.String?,
scriptId: json_['scriptId'] as core.String?,
versionNumber: json_['versionNumber'] as core.int?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (description != null) 'description': description!,
if (manifestFileName != null) 'manifestFileName': manifestFileName!,
if (scriptId != null) 'scriptId': scriptId!,
if (versionNumber != null) 'versionNumber': versionNumber!,
};
}
/// 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); }
typedef Empty = $Empty;
/// A configuration that defines how a deployment is accessed externally.
class EntryPoint {
/// Add-on properties.
GoogleAppsScriptTypeAddOnEntryPoint? addOn;
/// The type of the entry point.
/// Possible string values are:
/// - "ENTRY_POINT_TYPE_UNSPECIFIED" : An unspecified entry point.
/// - "WEB_APP" : A web application entry point.
/// - "EXECUTION_API" : An API executable entry point.
/// - "ADD_ON" : An Add-On entry point.
core.String? entryPointType;
/// An entry point specification for Apps Script API execution calls.
GoogleAppsScriptTypeExecutionApiEntryPoint? executionApi;
/// An entry point specification for web apps.
GoogleAppsScriptTypeWebAppEntryPoint? webApp;
EntryPoint({this.addOn, this.entryPointType, this.executionApi, this.webApp});
EntryPoint.fromJson(core.Map json_)
: this(
addOn:
json_.containsKey('addOn')
? GoogleAppsScriptTypeAddOnEntryPoint.fromJson(
json_['addOn'] as core.Map<core.String, core.dynamic>,
)
: null,
entryPointType: json_['entryPointType'] as core.String?,
executionApi:
json_.containsKey('executionApi')
? GoogleAppsScriptTypeExecutionApiEntryPoint.fromJson(
json_['executionApi'] as core.Map<core.String, core.dynamic>,
)
: null,
webApp:
json_.containsKey('webApp')
? GoogleAppsScriptTypeWebAppEntryPoint.fromJson(
json_['webApp'] as core.Map<core.String, core.dynamic>,
)
: null,
);
core.Map<core.String, core.dynamic> toJson() => {
if (addOn != null) 'addOn': addOn!,
if (entryPointType != null) 'entryPointType': entryPointType!,
if (executionApi != null) 'executionApi': executionApi!,
if (webApp != null) 'webApp': webApp!,
};
}
/// A request to run the function in a script.
///
/// The script is identified by the specified `script_id`. Executing a function
/// on a script returns results based on the implementation of the script.
class ExecutionRequest {
/// If `true` and the user is an owner of the script, the script runs at the
/// most recently saved version rather than the version deployed for use with
/// the Apps Script API.
///
/// Optional; default is `false`.
core.bool? devMode;
/// The name of the function to execute in the given script.
///
/// The name does not include parentheses or parameters. It can reference a
/// function in an included library such as `Library.libFunction1`.
core.String? function;
/// The parameters to be passed to the function being executed.
///
/// The object type for each parameter should match the expected type in Apps
/// Script. Parameters cannot be Apps Script-specific object types (such as a
/// `Document` or a `Calendar`); they can only be primitive types such as
/// `string`, `number`, `array`, `object`, or `boolean`. Optional.
///
/// The values for Object must be JSON objects. It can consist of `num`,
/// `String`, `bool` and `null` as well as `Map` and `List` values.
core.List<core.Object?>? parameters;
/// *Deprecated*.
///
/// For use with Android add-ons only. An ID that represents the user's
/// current session in the Android app for Google Docs or Sheets, included as
/// extra data in the
/// [Intent](https://developer.android.com/guide/components/intents-filters.html)
/// that launches the add-on. When an Android add-on is run with a session
/// state, it gains the privileges of a
/// [bound](https://developers.google.com/apps-script/guides/bound)
/// script—that is, it can access information like the user's current cursor
/// position (in Docs) or selected cell (in Sheets). To retrieve the state,
/// call
/// `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionState")`.
/// Optional.
core.String? sessionState;
ExecutionRequest({
this.devMode,
this.function,
this.parameters,
this.sessionState,
});
ExecutionRequest.fromJson(core.Map json_)
: this(
devMode: json_['devMode'] as core.bool?,
function: json_['function'] as core.String?,
parameters:
json_.containsKey('parameters')
? json_['parameters'] as core.List
: null,
sessionState: json_['sessionState'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (devMode != null) 'devMode': devMode!,
if (function != null) 'function': function!,
if (parameters != null) 'parameters': parameters!,
if (sessionState != null) 'sessionState': sessionState!,
};
}
/// An individual file within a script project.
///
/// A file is a third-party source code created by one or more developers. It
/// can be a server-side JS code, HTML, or a configuration file. Each script
/// project can contain multiple files.
class File {
/// Creation date timestamp.
core.String? createTime;
/// The defined set of functions in the script file, if any.
GoogleAppsScriptTypeFunctionSet? functionSet;
/// The user who modified the file most recently.
///
/// The details visible in this object are controlled by the profile
/// visibility settings of the last modifying user.
GoogleAppsScriptTypeUser? lastModifyUser;
/// The name of the file.
///
/// The file extension is not part of the file name, which can be identified
/// from the type field.
core.String? name;
/// The file content.
core.String? source;
/// The type of the file.
/// Possible string values are:
/// - "ENUM_TYPE_UNSPECIFIED" : Undetermined file type; never actually used.
/// - "SERVER_JS" : An Apps Script server-side code file.
/// - "HTML" : A file containing client-side HTML.
/// - "JSON" : A file in JSON format. This type is only used for the script
/// project's manifest. The manifest file content must match the structure of
/// a valid \[ScriptManifest\](/apps-script/concepts/manifests)
core.String? type;
/// Last modified date timestamp.
core.String? updateTime;
File({
this.createTime,
this.functionSet,
this.lastModifyUser,
this.name,
this.source,
this.type,
this.updateTime,
});
File.fromJson(core.Map json_)
: this(
createTime: json_['createTime'] as core.String?,
functionSet:
json_.containsKey('functionSet')
? GoogleAppsScriptTypeFunctionSet.fromJson(
json_['functionSet'] as core.Map<core.String, core.dynamic>,
)
: null,
lastModifyUser:
json_.containsKey('lastModifyUser')
? GoogleAppsScriptTypeUser.fromJson(
json_['lastModifyUser']
as core.Map<core.String, core.dynamic>,
)
: null,
name: json_['name'] as core.String?,
source: json_['source'] as core.String?,
type: json_['type'] as core.String?,
updateTime: json_['updateTime'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (createTime != null) 'createTime': createTime!,
if (functionSet != null) 'functionSet': functionSet!,
if (lastModifyUser != null) 'lastModifyUser': lastModifyUser!,
if (name != null) 'name': name!,
if (source != null) 'source': source!,
if (type != null) 'type': type!,
if (updateTime != null) 'updateTime': updateTime!,
};
}
/// An add-on entry point.
class GoogleAppsScriptTypeAddOnEntryPoint {
/// The add-on's required list of supported container types.
/// Possible string values are:
/// - "UNKNOWN_ADDON_TYPE" : Default value, unknown add-on type.
/// - "GMAIL" : Add-on type for Gmail.
/// - "DATA_STUDIO" : Add-on type for Data Studio.
core.String? addOnType;
/// The add-on's optional description.
core.String? description;
/// The add-on's optional help URL.
core.String? helpUrl;
/// The add-on's required post install tip URL.
core.String? postInstallTipUrl;
/// The add-on's optional report issue URL.
core.String? reportIssueUrl;
/// The add-on's required title.
core.String? title;
GoogleAppsScriptTypeAddOnEntryPoint({
this.addOnType,
this.description,
this.helpUrl,
this.postInstallTipUrl,
this.reportIssueUrl,
this.title,
});
GoogleAppsScriptTypeAddOnEntryPoint.fromJson(core.Map json_)
: this(
addOnType: json_['addOnType'] as core.String?,
description: json_['description'] as core.String?,
helpUrl: json_['helpUrl'] as core.String?,
postInstallTipUrl: json_['postInstallTipUrl'] as core.String?,
reportIssueUrl: json_['reportIssueUrl'] as core.String?,
title: json_['title'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (addOnType != null) 'addOnType': addOnType!,
if (description != null) 'description': description!,
if (helpUrl != null) 'helpUrl': helpUrl!,
if (postInstallTipUrl != null) 'postInstallTipUrl': postInstallTipUrl!,
if (reportIssueUrl != null) 'reportIssueUrl': reportIssueUrl!,
if (title != null) 'title': title!,
};
}
/// API executable entry point configuration.
class GoogleAppsScriptTypeExecutionApiConfig {
/// Who has permission to run the API executable.
/// Possible string values are:
/// - "UNKNOWN_ACCESS" : Default value, should not be used.
/// - "MYSELF" : Only the user who deployed the web app or executable can
/// access it. Note that this is not necessarily the owner of the script
/// project.
/// - "DOMAIN" : Only users in the same domain as the user who deployed the
/// web app or executable can access it.
/// - "ANYONE" : Any logged in user can access the web app or executable.
/// - "ANYONE_ANONYMOUS" : Any user, logged in or not, can access the web app
/// or executable.
core.String? access;
GoogleAppsScriptTypeExecutionApiConfig({this.access});
GoogleAppsScriptTypeExecutionApiConfig.fromJson(core.Map json_)
: this(access: json_['access'] as core.String?);
core.Map<core.String, core.dynamic> toJson() => {
if (access != null) 'access': access!,
};
}
/// An API executable entry point.
class GoogleAppsScriptTypeExecutionApiEntryPoint {
/// The entry point's configuration.
GoogleAppsScriptTypeExecutionApiConfig? entryPointConfig;
GoogleAppsScriptTypeExecutionApiEntryPoint({this.entryPointConfig});
GoogleAppsScriptTypeExecutionApiEntryPoint.fromJson(core.Map json_)
: this(
entryPointConfig:
json_.containsKey('entryPointConfig')
? GoogleAppsScriptTypeExecutionApiConfig.fromJson(
json_['entryPointConfig']
as core.Map<core.String, core.dynamic>,
)
: null,
);
core.Map<core.String, core.dynamic> toJson() => {
if (entryPointConfig != null) 'entryPointConfig': entryPointConfig!,
};
}
/// Represents a function in a script project.
class GoogleAppsScriptTypeFunction {
/// The function name in the script project.
core.String? name;
/// The ordered list of parameter names of the function in the script project.
core.List<core.String>? parameters;
GoogleAppsScriptTypeFunction({this.name, this.parameters});
GoogleAppsScriptTypeFunction.fromJson(core.Map json_)
: this(
name: json_['name'] as core.String?,
parameters:
(json_['parameters'] as core.List?)
?.map((value) => value as core.String)
.toList(),
);
core.Map<core.String, core.dynamic> toJson() => {
if (name != null) 'name': name!,
if (parameters != null) 'parameters': parameters!,
};
}
/// A set of functions.
///
/// No duplicates are permitted.
class GoogleAppsScriptTypeFunctionSet {
/// A list of functions composing the set.
core.List<GoogleAppsScriptTypeFunction>? values;
GoogleAppsScriptTypeFunctionSet({this.values});
GoogleAppsScriptTypeFunctionSet.fromJson(core.Map json_)
: this(
values:
(json_['values'] as core.List?)
?.map(
(value) => GoogleAppsScriptTypeFunction.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
);
core.Map<core.String, core.dynamic> toJson() => {
if (values != null) 'values': values!,
};
}
/// Representation of a single script process execution that was started from
/// the script editor, a trigger, an application, or using the Apps Script API.
///
/// This is distinct from the `Operation` resource, which only represents
/// executions started via the Apps Script API.
class GoogleAppsScriptTypeProcess {
/// Duration the execution spent executing.
core.String? duration;
/// Name of the function the started the execution.
core.String? functionName;
/// The executions status.
/// Possible string values are:
/// - "PROCESS_STATUS_UNSPECIFIED" : Unspecified status.
/// - "RUNNING" : The process is currently running.
/// - "PAUSED" : The process has paused.
/// - "COMPLETED" : The process has completed.
/// - "CANCELED" : The process was cancelled.
/// - "FAILED" : The process failed.
/// - "TIMED_OUT" : The process timed out.
/// - "UNKNOWN" : Process status unknown.
/// - "DELAYED" : The process is delayed, waiting for quota.
/// - "EXECUTION_DISABLED" : AppsScript executions are disabled by Admin.
core.String? processStatus;
/// The executions type.
/// Possible string values are:
/// - "PROCESS_TYPE_UNSPECIFIED" : Unspecified type.
/// - "ADD_ON" : The process was started from an add-on entry point.
/// - "EXECUTION_API" : The process was started using the Apps Script API.
/// - "TIME_DRIVEN" : The process was started from a time-based trigger.
/// - "TRIGGER" : The process was started from an event-based trigger.
/// - "WEBAPP" : The process was started from a web app entry point.
/// - "EDITOR" : The process was started using the Apps Script IDE.
/// - "SIMPLE_TRIGGER" : The process was started from a G Suite simple
/// trigger.
/// - "MENU" : The process was started from a G Suite menu item.
/// - "BATCH_TASK" : The process was started as a task in a batch job.
core.String? processType;
/// Name of the script being executed.
core.String? projectName;
/// Which version of maestro to use to execute the script.
/// Possible string values are:
/// - "RUNTIME_VERSION_UNSPECIFIED" : Runtime version unset / unknown.
/// - "DEPRECATED_ES5" : Legacy rhino version of the Apps script runtime
/// - "V8" : Current default V8 version of the apps script runtime.
core.String? runtimeVersion;
/// Time the execution started.
core.String? startTime;
/// The executing users access level to the script.
/// Possible string values are:
/// - "USER_ACCESS_LEVEL_UNSPECIFIED" : User access level unspecified
/// - "NONE" : The user has no access.
/// - "READ" : The user has read-only access.
/// - "WRITE" : The user has write access.
/// - "OWNER" : The user is an owner.
core.String? userAccessLevel;
GoogleAppsScriptTypeProcess({
this.duration,
this.functionName,
this.processStatus,
this.processType,
this.projectName,
this.runtimeVersion,
this.startTime,
this.userAccessLevel,
});
GoogleAppsScriptTypeProcess.fromJson(core.Map json_)
: this(
duration: json_['duration'] as core.String?,
functionName: json_['functionName'] as core.String?,
processStatus: json_['processStatus'] as core.String?,
processType: json_['processType'] as core.String?,
projectName: json_['projectName'] as core.String?,
runtimeVersion: json_['runtimeVersion'] as core.String?,
startTime: json_['startTime'] as core.String?,
userAccessLevel: json_['userAccessLevel'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (duration != null) 'duration': duration!,
if (functionName != null) 'functionName': functionName!,
if (processStatus != null) 'processStatus': processStatus!,
if (processType != null) 'processType': processType!,
if (projectName != null) 'projectName': projectName!,
if (runtimeVersion != null) 'runtimeVersion': runtimeVersion!,
if (startTime != null) 'startTime': startTime!,
if (userAccessLevel != null) 'userAccessLevel': userAccessLevel!,
};
}
/// A simple user profile resource.
class GoogleAppsScriptTypeUser {
/// The user's domain.
core.String? domain;
/// The user's identifying email address.
core.String? email;
/// The user's display name.
core.String? name;
/// The user's photo.
core.String? photoUrl;
GoogleAppsScriptTypeUser({this.domain, this.email, this.name, this.photoUrl});
GoogleAppsScriptTypeUser.fromJson(core.Map json_)
: this(
domain: json_['domain'] as core.String?,
email: json_['email'] as core.String?,
name: json_['name'] as core.String?,
photoUrl: json_['photoUrl'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (domain != null) 'domain': domain!,
if (email != null) 'email': email!,
if (name != null) 'name': name!,
if (photoUrl != null) 'photoUrl': photoUrl!,
};
}
/// Web app entry point configuration.
class GoogleAppsScriptTypeWebAppConfig {
/// Who has permission to run the web app.
/// Possible string values are:
/// - "UNKNOWN_ACCESS" : Default value, should not be used.
/// - "MYSELF" : Only the user who deployed the web app or executable can
/// access it. Note that this is not necessarily the owner of the script
/// project.
/// - "DOMAIN" : Only users in the same domain as the user who deployed the
/// web app or executable can access it.
/// - "ANYONE" : Any logged in user can access the web app or executable.
/// - "ANYONE_ANONYMOUS" : Any user, logged in or not, can access the web app
/// or executable.
core.String? access;
/// Who to execute the web app as.
/// Possible string values are:
/// - "UNKNOWN_EXECUTE_AS" : Default value, should not be used.
/// - "USER_ACCESSING" : The script runs as the user accessing the web app.
/// - "USER_DEPLOYING" : The script runs as the user who deployed the web app.
/// Note that this is not necessarily the owner of the script project.
core.String? executeAs;
GoogleAppsScriptTypeWebAppConfig({this.access, this.executeAs});
GoogleAppsScriptTypeWebAppConfig.fromJson(core.Map json_)
: this(
access: json_['access'] as core.String?,
executeAs: json_['executeAs'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (access != null) 'access': access!,
if (executeAs != null) 'executeAs': executeAs!,
};
}
/// A web application entry point.
class GoogleAppsScriptTypeWebAppEntryPoint {
/// The entry point's configuration.
GoogleAppsScriptTypeWebAppConfig? entryPointConfig;
/// The URL for the web application.
core.String? url;
GoogleAppsScriptTypeWebAppEntryPoint({this.entryPointConfig, this.url});
GoogleAppsScriptTypeWebAppEntryPoint.fromJson(core.Map json_)
: this(
entryPointConfig:
json_.containsKey('entryPointConfig')
? GoogleAppsScriptTypeWebAppConfig.fromJson(
json_['entryPointConfig']
as core.Map<core.String, core.dynamic>,
)
: null,
url: json_['url'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (entryPointConfig != null) 'entryPointConfig': entryPointConfig!,
if (url != null) 'url': url!,
};
}
/// Response with the list of deployments for the specified Apps Script project.
class ListDeploymentsResponse {
/// The list of deployments.
core.List<Deployment>? deployments;
/// The token that can be used in the next call to get the next page of
/// results.
core.String? nextPageToken;
ListDeploymentsResponse({this.deployments, this.nextPageToken});
ListDeploymentsResponse.fromJson(core.Map json_)
: this(
deployments:
(json_['deployments'] as core.List?)
?.map(
(value) => Deployment.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
nextPageToken: json_['nextPageToken'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (deployments != null) 'deployments': deployments!,
if (nextPageToken != null) 'nextPageToken': nextPageToken!,
};
}
/// Response with the list of Process resources.
class ListScriptProcessesResponse {
/// Token for the next page of results.
///
/// If empty, there are no more pages remaining.
core.String? nextPageToken;
/// List of processes matching request parameters.
core.List<GoogleAppsScriptTypeProcess>? processes;
ListScriptProcessesResponse({this.nextPageToken, this.processes});
ListScriptProcessesResponse.fromJson(core.Map json_)
: this(
nextPageToken: json_['nextPageToken'] as core.String?,
processes:
(json_['processes'] as core.List?)
?.map(
(value) => GoogleAppsScriptTypeProcess.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
);
core.Map<core.String, core.dynamic> toJson() => {
if (nextPageToken != null) 'nextPageToken': nextPageToken!,
if (processes != null) 'processes': processes!,
};
}
/// Response with the list of Process resources.
class ListUserProcessesResponse {
/// Token for the next page of results.
///
/// If empty, there are no more pages remaining.
core.String? nextPageToken;
/// List of processes matching request parameters.
core.List<GoogleAppsScriptTypeProcess>? processes;
ListUserProcessesResponse({this.nextPageToken, this.processes});
ListUserProcessesResponse.fromJson(core.Map json_)
: this(
nextPageToken: json_['nextPageToken'] as core.String?,
processes:
(json_['processes'] as core.List?)
?.map(
(value) => GoogleAppsScriptTypeProcess.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
);
core.Map<core.String, core.dynamic> toJson() => {
if (nextPageToken != null) 'nextPageToken': nextPageToken!,
if (processes != null) 'processes': processes!,
};
}
/// Response with the list of the versions for the specified script project.
class ListVersionsResponse {
/// The token use to fetch the next page of records.
///
/// if not exist in the response, that means no more versions to list.
core.String? nextPageToken;
/// The list of versions.
core.List<Version>? versions;
ListVersionsResponse({this.nextPageToken, this.versions});
ListVersionsResponse.fromJson(core.Map json_)
: this(
nextPageToken: json_['nextPageToken'] as core.String?,
versions:
(json_['versions'] as core.List?)
?.map(
(value) => Version.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
);
core.Map<core.String, core.dynamic> toJson() => {
if (nextPageToken != null) 'nextPageToken': nextPageToken!,
if (versions != null) 'versions': versions!,
};
}
/// Resource containing usage stats for a given script, based on the supplied
/// filter and mask present in the request.
class Metrics {
/// Number of active users.
core.List<MetricsValue>? activeUsers;
/// Number of failed executions.
core.List<MetricsValue>? failedExecutions;
/// Number of total executions.
core.List<MetricsValue>? totalExecutions;
Metrics({this.activeUsers, this.failedExecutions, this.totalExecutions});
Metrics.fromJson(core.Map json_)
: this(
activeUsers:
(json_['activeUsers'] as core.List?)
?.map(
(value) => MetricsValue.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
failedExecutions:
(json_['failedExecutions'] as core.List?)
?.map(
(value) => MetricsValue.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
totalExecutions:
(json_['totalExecutions'] as core.List?)
?.map(
(value) => MetricsValue.fromJson(
value as core.Map<core.String, core.dynamic>,
),
)
.toList(),
);
core.Map<core.String, core.dynamic> toJson() => {
if (activeUsers != null) 'activeUsers': activeUsers!,
if (failedExecutions != null) 'failedExecutions': failedExecutions!,
if (totalExecutions != null) 'totalExecutions': totalExecutions!,
};
}
/// Metrics value that holds number of executions counted.
class MetricsValue {
/// Required field indicating the end time of the interval.
core.String? endTime;
/// Required field indicating the start time of the interval.
core.String? startTime;
/// Indicates the number of executions counted.
core.String? value;
MetricsValue({this.endTime, this.startTime, this.value});
MetricsValue.fromJson(core.Map json_)
: this(
endTime: json_['endTime'] as core.String?,
startTime: json_['startTime'] as core.String?,
value: json_['value'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (endTime != null) 'endTime': endTime!,
if (startTime != null) 'startTime': startTime!,
if (value != null) 'value': value!,
};
}
/// A representation of an execution of an Apps Script function started with
/// run.
///
/// The execution response does not arrive until the function finishes
/// executing. The maximum execution runtime is listed in the \[Apps Script
/// quotas guide\](/apps-script/guides/services/quotas#current_limitations).
/// After execution has started, it can have one of four outcomes: - If the
/// script function returns successfully, the response field contains an
/// ExecutionResponse object with the function's return value in the object's
/// `result` field. - If the script function (or Apps Script itself) throws an
/// exception, the error field contains a Status object. The `Status` object's
/// `details` field contains an array with a single ExecutionError object that
/// provides information about the nature of the error. - If the execution has
/// not yet completed, the done field is `false` and the neither the `response`
/// nor `error` fields are present. - If the `run` call itself fails (for
/// example, because of a malformed request or an authorization error), the
/// method returns an HTTP response code in the 4XX range with a different
/// format for the response body. Client libraries automatically convert a 4XX
/// response into an exception class.
class Operation {
/// This field indicates whether the script execution has completed.
///
/// A completed execution has a populated `response` field containing the
/// ExecutionResponse from function that was executed.
core.bool? done;
/// If a `run` call succeeds but the script function (or Apps Script itself)
/// throws an exception, this field contains a Status object.
///
/// The `Status` object's `details` field contains an array with a single
/// ExecutionError object that provides information about the nature of the
/// error.
Status? error;
/// If the script function returns successfully, this field contains an
/// ExecutionResponse object with the function's return value.
///
/// The values for Object must be JSON objects. It can consist of `num`,
/// `String`, `bool` and `null` as well as `Map` and `List` values.
core.Map<core.String, core.Object?>? response;
Operation({this.done, this.error, this.response});
Operation.fromJson(core.Map json_)
: this(
done: json_['done'] as core.bool?,
error:
json_.containsKey('error')
? Status.fromJson(
json_['error'] as core.Map<core.String, core.dynamic>,
)
: null,
response:
json_.containsKey('response')
? json_['response'] as core.Map<core.String, core.dynamic>
: null,
);
core.Map<core.String, core.dynamic> toJson() => {
if (done != null) 'done': done!,
if (error != null) 'error': error!,
if (response != null) 'response': response!,
};
}
/// The script project resource.
class Project {
/// When the script was created.
core.String? createTime;
/// User who originally created the script.
GoogleAppsScriptTypeUser? creator;
/// User who last modified the script.
GoogleAppsScriptTypeUser? lastModifyUser;
/// The parent's Drive ID that the script will be attached to.
///
/// This is usually the ID of a Google Document or Google Sheet. This field is
/// optional, and if not set, a stand-alone script will be created.
core.String? parentId;
/// The script project's Drive ID.
core.String? scriptId;
/// The title for the project.
core.String? title;
/// When the script was last updated.
core.String? updateTime;
Project({
this.createTime,
this.creator,
this.lastModifyUser,
this.parentId,
this.scriptId,
this.title,
this.updateTime,
});
Project.fromJson(core.Map json_)
: this(
createTime: json_['createTime'] as core.String?,
creator:
json_.containsKey('creator')
? GoogleAppsScriptTypeUser.fromJson(
json_['creator'] as core.Map<core.String, core.dynamic>,
)
: null,
lastModifyUser:
json_.containsKey('lastModifyUser')
? GoogleAppsScriptTypeUser.fromJson(
json_['lastModifyUser']
as core.Map<core.String, core.dynamic>,
)
: null,
parentId: json_['parentId'] as core.String?,
scriptId: json_['scriptId'] as core.String?,
title: json_['title'] as core.String?,
updateTime: json_['updateTime'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (createTime != null) 'createTime': createTime!,
if (creator != null) 'creator': creator!,
if (lastModifyUser != null) 'lastModifyUser': lastModifyUser!,
if (parentId != null) 'parentId': parentId!,
if (scriptId != null) 'scriptId': scriptId!,
if (title != null) 'title': title!,
if (updateTime != null) 'updateTime': updateTime!,
};
}
/// If a `run` call succeeds but the script function (or Apps Script itself)
/// throws an exception, the response body's error field contains this `Status`
/// object.
class Status {
/// The status code.
///
/// For this API, this value either: - 10, indicating a `SCRIPT_TIMEOUT`
/// error, - 3, indicating an `INVALID_ARGUMENT` error, or - 1, indicating a
/// `CANCELLED` execution.
core.int? code;
/// An array that contains a single ExecutionError object that provides
/// information about the nature of the error.
///
/// The values for Object must be JSON objects. It can consist of `num`,
/// `String`, `bool` and `null` as well as `Map` and `List` values.
core.List<core.Map<core.String, core.Object?>>? details;
/// A developer-facing error message, which is in English.
///
/// Any user-facing error message is localized and sent in the details field,
/// or localized by the client.
core.String? message;
Status({this.code, this.details, this.message});
Status.fromJson(core.Map json_)
: this(
code: json_['code'] as core.int?,
details:
(json_['details'] as core.List?)
?.map((value) => value as core.Map<core.String, core.dynamic>)
.toList(),
message: json_['message'] as core.String?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (code != null) 'code': code!,
if (details != null) 'details': details!,
if (message != null) 'message': message!,
};
}
/// Request with deployment information to update an existing deployment.
class UpdateDeploymentRequest {
/// The deployment configuration.
DeploymentConfig? deploymentConfig;
UpdateDeploymentRequest({this.deploymentConfig});
UpdateDeploymentRequest.fromJson(core.Map json_)
: this(
deploymentConfig:
json_.containsKey('deploymentConfig')
? DeploymentConfig.fromJson(
json_['deploymentConfig']
as core.Map<core.String, core.dynamic>,
)
: null,
);
core.Map<core.String, core.dynamic> toJson() => {
if (deploymentConfig != null) 'deploymentConfig': deploymentConfig!,
};
}
/// A resource representing a script project version.
///
/// A version is a "snapshot" of a script project and is similar to a read-only
/// branched release. When creating deployments, the version to use must be
/// specified.
class Version {
/// When the version was created.
core.String? createTime;
/// The description for this version.
core.String? description;
/// The script project's Drive ID.
core.String? scriptId;
/// The incremental ID that is created by Apps Script when a version is
/// created.
///
/// This is system assigned number and is immutable once created.
core.int? versionNumber;
Version({
this.createTime,
this.description,
this.scriptId,
this.versionNumber,
});
Version.fromJson(core.Map json_)
: this(
createTime: json_['createTime'] as core.String?,
description: json_['description'] as core.String?,
scriptId: json_['scriptId'] as core.String?,
versionNumber: json_['versionNumber'] as core.int?,
);
core.Map<core.String, core.dynamic> toJson() => {
if (createTime != null) 'createTime': createTime!,
if (description != null) 'description': description!,
if (scriptId != null) 'scriptId': scriptId!,
if (versionNumber != null) 'versionNumber': versionNumber!,
};
}