Apps Script API . processes

Instance Methods

close()

Close httplib2 connections.

list(pageSize=None, pageToken=None, userProcessFilter_deploymentId=None, userProcessFilter_endTime=None, userProcessFilter_functionName=None, userProcessFilter_projectName=None, userProcessFilter_scriptId=None, userProcessFilter_startTime=None, userProcessFilter_statuses=None, userProcessFilter_types=None, userProcessFilter_userAccessLevels=None, x__xgafv=None)

List information about processes made by or on behalf of a user, such as process type and current status.

listScriptProcesses(pageSize=None, pageToken=None, scriptId=None, scriptProcessFilter_deploymentId=None, scriptProcessFilter_endTime=None, scriptProcessFilter_functionName=None, scriptProcessFilter_startTime=None, scriptProcessFilter_statuses=None, scriptProcessFilter_types=None, scriptProcessFilter_userAccessLevels=None, x__xgafv=None)

List information about a script's executed processes, such as process type and current status.

listScriptProcesses_next()

Retrieves the next page of results.

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
list(pageSize=None, pageToken=None, userProcessFilter_deploymentId=None, userProcessFilter_endTime=None, userProcessFilter_functionName=None, userProcessFilter_projectName=None, userProcessFilter_scriptId=None, userProcessFilter_startTime=None, userProcessFilter_statuses=None, userProcessFilter_types=None, userProcessFilter_userAccessLevels=None, x__xgafv=None)
List information about processes made by or on behalf of a user, such as process type and current status.

Args:
  pageSize: integer, The maximum number of returned processes per page of results. Defaults to 50.
  pageToken: string, 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: string, Optional field used to limit returned processes to those originating from projects with a specific deployment ID.
  userProcessFilter_endTime: string, Optional field used to limit returned processes to those that completed on or before the given timestamp.
  userProcessFilter_functionName: string, Optional field used to limit returned processes to those originating from a script function with the given function name.
  userProcessFilter_projectName: string, Optional field used to limit returned processes to those originating from projects with project names containing a specific string.
  userProcessFilter_scriptId: string, Optional field used to limit returned processes to those originating from projects with a specific script ID.
  userProcessFilter_startTime: string, Optional field used to limit returned processes to those that were started on or after the given timestamp.
  userProcessFilter_statuses: string, Optional field used to limit returned processes to those having one of the specified process statuses. (repeated)
    Allowed values
      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.
  userProcessFilter_types: string, Optional field used to limit returned processes to those having one of the specified process types. (repeated)
    Allowed values
      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.
  userProcessFilter_userAccessLevels: string, Optional field used to limit returned processes to those having one of the specified user access levels. (repeated)
    Allowed values
      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.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response with the list of Process resources.
  "nextPageToken": "A String", # Token for the next page of results. If empty, there are no more pages remaining.
  "processes": [ # List of processes matching request parameters.
    { # 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.
      "duration": "A String", # Duration the execution spent executing.
      "functionName": "A String", # Name of the function the started the execution.
      "processStatus": "A String", # The executions status.
      "processType": "A String", # The executions type.
      "projectName": "A String", # Name of the script being executed.
      "runtimeVersion": "A String", # Which version of maestro to use to execute the script.
      "startTime": "A String", # Time the execution started.
      "userAccessLevel": "A String", # The executing users access level to the script.
    },
  ],
}
listScriptProcesses(pageSize=None, pageToken=None, scriptId=None, scriptProcessFilter_deploymentId=None, scriptProcessFilter_endTime=None, scriptProcessFilter_functionName=None, scriptProcessFilter_startTime=None, scriptProcessFilter_statuses=None, scriptProcessFilter_types=None, scriptProcessFilter_userAccessLevels=None, x__xgafv=None)
List information about a script's executed processes, such as process type and current status.

Args:
  pageSize: integer, The maximum number of returned processes per page of results. Defaults to 50.
  pageToken: string, 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: string, The script ID of the project whose processes are listed.
  scriptProcessFilter_deploymentId: string, Optional field used to limit returned processes to those originating from projects with a specific deployment ID.
  scriptProcessFilter_endTime: string, Optional field used to limit returned processes to those that completed on or before the given timestamp.
  scriptProcessFilter_functionName: string, Optional field used to limit returned processes to those originating from a script function with the given function name.
  scriptProcessFilter_startTime: string, Optional field used to limit returned processes to those that were started on or after the given timestamp.
  scriptProcessFilter_statuses: string, Optional field used to limit returned processes to those having one of the specified process statuses. (repeated)
    Allowed values
      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.
  scriptProcessFilter_types: string, Optional field used to limit returned processes to those having one of the specified process types. (repeated)
    Allowed values
      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.
  scriptProcessFilter_userAccessLevels: string, Optional field used to limit returned processes to those having one of the specified user access levels. (repeated)
    Allowed values
      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.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response with the list of Process resources.
  "nextPageToken": "A String", # Token for the next page of results. If empty, there are no more pages remaining.
  "processes": [ # List of processes matching request parameters.
    { # 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.
      "duration": "A String", # Duration the execution spent executing.
      "functionName": "A String", # Name of the function the started the execution.
      "processStatus": "A String", # The executions status.
      "processType": "A String", # The executions type.
      "projectName": "A String", # Name of the script being executed.
      "runtimeVersion": "A String", # Which version of maestro to use to execute the script.
      "startTime": "A String", # Time the execution started.
      "userAccessLevel": "A String", # The executing users access level to the script.
    },
  ],
}
listScriptProcesses_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.