@maxim_mazurok/gapi.client.script-v1 0.0.20220806

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxim_mazurok/gapi.client.script-v1",
+  "version": "0.0.20220806",
+  "description": "TypeScript typings for Apps Script API v1",
+  "license": "MIT",
+  "author": {
+    "email": "maxim@mazurok.com",
+    "name": "Maxim Mazurok",
+    "url": "https://maxim.mazurok.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Maxim-Mazurok/google-api-typings-generator.git"
+  },
+  "types": "index.d.ts",
+  "dependencies": {
+    "@types/gapi.client": "*",
+    "@types/gapi.client.discovery": "*"
+  }
+}

package/readme.md

@@ -0,0 +1,159 @@
+# TypeScript typings for Apps Script API v1
+
+Manages and executes Google Apps Script projects. 
+For detailed description please check [documentation](https://developers.google.com/apps-script/api/).
+
+## Installing
+
+Install typings for Apps Script API:
+
+```
+npm install @types/gapi.client.script-v1 --save-dev
+```
+
+## Usage
+
+You need to initialize Google API client in your code:
+
+```typescript
+gapi.load('client', () => {
+  // now we can use gapi.client
+  // ...
+});
+```
+
+Then load api client wrapper:
+
+```typescript
+gapi.client.load('https://script.googleapis.com/$discovery/rest?version=v1', () => {
+  // now we can use:
+  // gapi.client.script
+});
+```
+
+```typescript
+// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
+gapi.client.load('script', 'v1', () => {
+  // now we can use:
+  // gapi.client.script
+});
+```
+
+Don't forget to authenticate your client before sending any request to resources:
+
+```typescript
+// declare client_id registered in Google Developers Console
+var client_id = '',
+  scope = [
+      // Read, compose, send, and permanently delete all your email from Gmail
+      'https://mail.google.com/',
+
+      // See, edit, share, and permanently delete all the calendars you can access using Google Calendar
+      'https://www.google.com/calendar/feeds',
+
+      // See, edit, download, and permanently delete your contacts
+      'https://www.google.com/m8/feeds',
+
+      // View and manage the provisioning of groups on your domain
+      'https://www.googleapis.com/auth/admin.directory.group',
+
+      // View and manage the provisioning of users on your domain
+      'https://www.googleapis.com/auth/admin.directory.user',
+
+      // See, edit, create, and delete all your Google Docs documents
+      'https://www.googleapis.com/auth/documents',
+
+      // See, edit, create, and delete all of your Google Drive files
+      'https://www.googleapis.com/auth/drive',
+
+      // View and manage your forms in Google Drive
+      'https://www.googleapis.com/auth/forms',
+
+      // View and manage forms that this application has been installed in
+      'https://www.googleapis.com/auth/forms.currentonly',
+
+      // View and manage your Google Groups
+      'https://www.googleapis.com/auth/groups',
+
+      // Create and update Google Apps Script deployments
+      'https://www.googleapis.com/auth/script.deployments',
+
+      // View Google Apps Script deployments
+      'https://www.googleapis.com/auth/script.deployments.readonly',
+
+      // View Google Apps Script project's metrics
+      'https://www.googleapis.com/auth/script.metrics',
+
+      // View Google Apps Script processes
+      'https://www.googleapis.com/auth/script.processes',
+
+      // Create and update Google Apps Script projects
+      'https://www.googleapis.com/auth/script.projects',
+
+      // View Google Apps Script projects
+      'https://www.googleapis.com/auth/script.projects.readonly',
+
+      // See, edit, create, and delete all your Google Sheets spreadsheets
+      'https://www.googleapis.com/auth/spreadsheets',
+
+      // See your primary Google Account email address
+      'https://www.googleapis.com/auth/userinfo.email',
+    ],
+    immediate = true;
+// ...
+
+gapi.auth.authorize(
+  { client_id: client_id, scope: scope, immediate: immediate },
+  authResult => {
+    if (authResult && !authResult.error) {
+        /* handle successful authorization */
+    } else {
+        /* handle authorization error */
+    }
+});
+```
+
+After that you can use Apps Script API resources: <!-- TODO: make this work for multiple namespaces -->
+
+```typescript
+
+/*
+List information about processes made by or on behalf of a user, such as process type and current status.
+*/
+await gapi.client.script.processes.list({  });
+
+/*
+List information about a script's executed processes, such as process type and current status.
+*/
+await gapi.client.script.processes.listScriptProcesses({  });
+
+/*
+Creates a new, empty script project with no script files and a base manifest file.
+*/
+await gapi.client.script.projects.create({  });
+
+/*
+Gets a script project's metadata.
+*/
+await gapi.client.script.projects.get({ scriptId: "scriptId",  });
+
+/*
+Gets the content of the script project, including the code source and metadata for each script file.
+*/
+await gapi.client.script.projects.getContent({ scriptId: "scriptId",  });
+
+/*
+Get metrics data for scripts, such as number of executions and active users.
+*/
+await gapi.client.script.projects.getMetrics({ scriptId: "scriptId",  });
+
+/*
+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.
+*/
+await gapi.client.script.projects.updateContent({ scriptId: "scriptId",  });
+
+/*
+Runs a function in an Apps Script project. The script project must be deployed for use with the Apps Script API and the calling application must share the same Cloud Platform project. This method requires authorization with an OAuth 2.0 token that includes at least one of the scopes listed in the [Authorization](#authorization-scopes) 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 script project **Overview** page and scroll down to "Project OAuth Scopes." The error `403, PERMISSION_DENIED: The caller does not have permission` indicates that the Cloud Platform project used to authorize the request is not the same as the one used by the script.
+*/
+await gapi.client.script.scripts.run({ scriptId: "scriptId",  });
+```

package/tests.ts

@@ -0,0 +1,223 @@
+/* This is stub file for gapi.client.script-v1 definition tests */
+// IMPORTANT
+// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
+// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
+
+// Revision: 20220806
+
+gapi.load('client', async () => {
+    /** now we can use gapi.client */
+
+    await gapi.client.load('https://script.googleapis.com/$discovery/rest?version=v1');
+    /** now we can use gapi.client.script */
+
+    /** don't forget to authenticate your client before sending any request to resources: */
+    /** declare client_id registered in Google Developers Console */
+    const client_id = '<<PUT YOUR CLIENT ID HERE>>';
+    const scope = [
+        /** Read, compose, send, and permanently delete all your email from Gmail */
+        'https://mail.google.com/',
+        /** See, edit, share, and permanently delete all the calendars you can access using Google Calendar */
+        'https://www.google.com/calendar/feeds',
+        /** See, edit, download, and permanently delete your contacts */
+        'https://www.google.com/m8/feeds',
+        /** View and manage the provisioning of groups on your domain */
+        'https://www.googleapis.com/auth/admin.directory.group',
+        /** View and manage the provisioning of users on your domain */
+        'https://www.googleapis.com/auth/admin.directory.user',
+        /** See, edit, create, and delete all your Google Docs documents */
+        'https://www.googleapis.com/auth/documents',
+        /** See, edit, create, and delete all of your Google Drive files */
+        'https://www.googleapis.com/auth/drive',
+        /** View and manage your forms in Google Drive */
+        'https://www.googleapis.com/auth/forms',
+        /** View and manage forms that this application has been installed in */
+        'https://www.googleapis.com/auth/forms.currentonly',
+        /** View and manage your Google Groups */
+        'https://www.googleapis.com/auth/groups',
+        /** Create and update Google Apps Script deployments */
+        'https://www.googleapis.com/auth/script.deployments',
+        /** View Google Apps Script deployments */
+        'https://www.googleapis.com/auth/script.deployments.readonly',
+        /** View Google Apps Script project's metrics */
+        'https://www.googleapis.com/auth/script.metrics',
+        /** View Google Apps Script processes */
+        'https://www.googleapis.com/auth/script.processes',
+        /** Create and update Google Apps Script projects */
+        'https://www.googleapis.com/auth/script.projects',
+        /** View Google Apps Script projects */
+        'https://www.googleapis.com/auth/script.projects.readonly',
+        /** See, edit, create, and delete all your Google Sheets spreadsheets */
+        'https://www.googleapis.com/auth/spreadsheets',
+        /** See your primary Google Account email address */
+        'https://www.googleapis.com/auth/userinfo.email',
+    ];
+    const immediate = false;
+    gapi.auth.authorize({ client_id, scope, immediate }, authResult => {
+        if (authResult && !authResult.error) {
+            /** handle successful authorization */
+            run();
+        } else {
+            /** handle authorization error */
+        }
+    });
+
+    async function run() {
+        /** List information about processes made by or on behalf of a user, such as process type and current status. */
+        await gapi.client.script.processes.list({
+            pageSize: 42,
+            pageToken: "Test string",
+            "userProcessFilter.deploymentId": "Test string",
+            "userProcessFilter.endTime": "Test string",
+            "userProcessFilter.functionName": "Test string",
+            "userProcessFilter.projectName": "Test string",
+            "userProcessFilter.scriptId": "Test string",
+            "userProcessFilter.startTime": "Test string",
+            "userProcessFilter.statuses": "Test string",
+            "userProcessFilter.types": "Test string",
+            "userProcessFilter.userAccessLevels": "Test string",
+        });
+        /** List information about a script's executed processes, such as process type and current status. */
+        await gapi.client.script.processes.listScriptProcesses({
+            pageSize: 42,
+            pageToken: "Test string",
+            scriptId: "Test string",
+            "scriptProcessFilter.deploymentId": "Test string",
+            "scriptProcessFilter.endTime": "Test string",
+            "scriptProcessFilter.functionName": "Test string",
+            "scriptProcessFilter.startTime": "Test string",
+            "scriptProcessFilter.statuses": "Test string",
+            "scriptProcessFilter.types": "Test string",
+            "scriptProcessFilter.userAccessLevels": "Test string",
+        });
+        /** Creates a new, empty script project with no script files and a base manifest file. */
+        await gapi.client.script.projects.create({
+        }, {
+            parentId: "Test string",
+            title: "Test string",
+        });
+        /** Gets a script project's metadata. */
+        await gapi.client.script.projects.get({
+            scriptId: "Test string",
+        });
+        /** Gets the content of the script project, including the code source and metadata for each script file. */
+        await gapi.client.script.projects.getContent({
+            scriptId: "Test string",
+            versionNumber: 42,
+        });
+        /** Get metrics data for scripts, such as number of executions and active users. */
+        await gapi.client.script.projects.getMetrics({
+            "metricsFilter.deploymentId": "Test string",
+            metricsGranularity: "Test string",
+            scriptId: "Test string",
+        });
+        /**
+         * 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.
+         */
+        await gapi.client.script.projects.updateContent({
+            scriptId: "Test string",
+        }, {
+            files: [
+                {
+                    createTime: "Test string",
+                    functionSet: {
+                        values: [
+                            {
+                                name: "Test string",
+                                parameters: [
+                                    "Test string"
+                                ],
+                            }
+                        ],
+                    },
+                    lastModifyUser: {
+                        domain: "Test string",
+                        email: "Test string",
+                        name: "Test string",
+                        photoUrl: "Test string",
+                    },
+                    name: "Test string",
+                    source: "Test string",
+                    type: "Test string",
+                    updateTime: "Test string",
+                }
+            ],
+            scriptId: "Test string",
+        });
+        /** Creates a deployment of an Apps Script project. */
+        await gapi.client.script.projects.deployments.create({
+            scriptId: "Test string",
+        }, {
+            description: "Test string",
+            manifestFileName: "Test string",
+            scriptId: "Test string",
+            versionNumber: 42,
+        });
+        /** Deletes a deployment of an Apps Script project. */
+        await gapi.client.script.projects.deployments.delete({
+            deploymentId: "Test string",
+            scriptId: "Test string",
+        });
+        /** Gets a deployment of an Apps Script project. */
+        await gapi.client.script.projects.deployments.get({
+            deploymentId: "Test string",
+            scriptId: "Test string",
+        });
+        /** Lists the deployments of an Apps Script project. */
+        await gapi.client.script.projects.deployments.list({
+            pageSize: 42,
+            pageToken: "Test string",
+            scriptId: "Test string",
+        });
+        /** Updates a deployment of an Apps Script project. */
+        await gapi.client.script.projects.deployments.update({
+            deploymentId: "Test string",
+            scriptId: "Test string",
+        }, {
+            deploymentConfig: {
+                description: "Test string",
+                manifestFileName: "Test string",
+                scriptId: "Test string",
+                versionNumber: 42,
+            },
+        });
+        /** Creates a new immutable version using the current code, with a unique version number. */
+        await gapi.client.script.projects.versions.create({
+            scriptId: "Test string",
+        }, {
+            createTime: "Test string",
+            description: "Test string",
+            scriptId: "Test string",
+            versionNumber: 42,
+        });
+        /** Gets a version of a script project. */
+        await gapi.client.script.projects.versions.get({
+            scriptId: "Test string",
+            versionNumber: 42,
+        });
+        /** List the versions of a script project. */
+        await gapi.client.script.projects.versions.list({
+            pageSize: 42,
+            pageToken: "Test string",
+            scriptId: "Test string",
+        });
+        /**
+         * Runs a function in an Apps Script project. The script project must be deployed for use with the Apps Script API and the calling application must share the same Cloud Platform project.
+         * This method requires authorization with an OAuth 2.0 token that includes at least one of the scopes listed in the [Authorization](#authorization-scopes) 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 script project **Overview** page and scroll
+         * down to "Project OAuth Scopes." The error `403, PERMISSION_DENIED: The caller does not have permission` indicates that the Cloud Platform project used to authorize the request is not
+         * the same as the one used by the script.
+         */
+        await gapi.client.script.scripts.run({
+            scriptId: "Test string",
+        }, {
+            devMode: true,
+            function: "Test string",
+            parameters: [
+                42
+            ],
+            sessionState: "Test string",
+        });
+    }
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": ["es6", "dom"],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true,
+        "strictFunctionTypes": true
+    },
+    "files": ["index.d.ts", "tests.ts"]
+}

package/tslint.json

@@ -0,0 +1,6 @@
+{
+    "extends": "dtslint/dtslint.json",
+    "rules": {
+        "no-redundant-jsdoc": false
+    }
+}