@maxim_mazurok/gapi.client.cloudidentity-v1 0.0.20220808

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxim_mazurok/gapi.client.cloudidentity-v1",
+  "version": "0.0.20220808",
+  "description": "TypeScript typings for Cloud Identity 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,167 @@
+# TypeScript typings for Cloud Identity API v1
+
+API for provisioning and managing identity resources.
+For detailed description please check [documentation](https://cloud.google.com/identity/).
+
+## Installing
+
+Install typings for Cloud Identity API:
+
+```
+npm install @types/gapi.client.cloudidentity-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://cloudidentity.googleapis.com/$discovery/rest?version=v1', () => {
+  // now we can use:
+  // gapi.client.cloudidentity
+});
+```
+
+```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('cloudidentity', 'v1', () => {
+  // now we can use:
+  // gapi.client.cloudidentity
+});
+```
+
+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 = [
+      // Private Service: https://www.googleapis.com/auth/cloud-identity
+      'https://www.googleapis.com/auth/cloud-identity',
+
+      // Private Service: https://www.googleapis.com/auth/cloud-identity.devices
+      'https://www.googleapis.com/auth/cloud-identity.devices',
+
+      // See your device details
+      'https://www.googleapis.com/auth/cloud-identity.devices.lookup',
+
+      // Private Service: https://www.googleapis.com/auth/cloud-identity.devices.readonly
+      'https://www.googleapis.com/auth/cloud-identity.devices.readonly',
+
+      // See, change, create, and delete any of the Cloud Identity Groups that you can access, including the members of each group
+      'https://www.googleapis.com/auth/cloud-identity.groups',
+
+      // See any Cloud Identity Groups that you can access, including group members and their emails
+      'https://www.googleapis.com/auth/cloud-identity.groups.readonly',
+
+      // See, send, or cancel any Cloud Identity UserInvitations to join your organization to users
+      'https://www.googleapis.com/auth/cloud-identity.userinvitations',
+
+      // See, send, or cancel any Cloud Identity UserInvitations to join your organization to users
+      'https://www.googleapis.com/auth/cloud-identity.userinvitations.readonly',
+
+      // See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
+      'https://www.googleapis.com/auth/cloud-platform',
+    ],
+    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 Cloud Identity API resources: <!-- TODO: make this work for multiple namespaces -->
+
+```typescript
+
+/*
+Cancels an unfinished device wipe. This operation can be used to cancel device wipe in the gap between the wipe operation returning success and the device being wiped. This operation is possible when the device is in a "pending wipe" state. The device enters the "pending wipe" state when a wipe device command is issued, but has not yet been sent to the device. The cancel wipe will fail if the wipe command has already been issued to the device.
+*/
+await gapi.client.cloudidentity.devices.cancelWipe({ name: "name",  });
+
+/*
+Creates a device. Only company-owned device may be created. **Note**: This method is available only to customers who have one of the following SKUs: Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity Premium
+*/
+await gapi.client.cloudidentity.devices.create({  });
+
+/*
+Deletes the specified device.
+*/
+await gapi.client.cloudidentity.devices.delete({ name: "name",  });
+
+/*
+Retrieves the specified device.
+*/
+await gapi.client.cloudidentity.devices.get({ name: "name",  });
+
+/*
+Lists/Searches devices.
+*/
+await gapi.client.cloudidentity.devices.list({  });
+
+/*
+Wipes all data on the specified device.
+*/
+await gapi.client.cloudidentity.devices.wipe({ name: "name",  });
+
+/*
+Creates a Group.
+*/
+await gapi.client.cloudidentity.groups.create({  });
+
+/*
+Deletes a `Group`.
+*/
+await gapi.client.cloudidentity.groups.delete({ name: "name",  });
+
+/*
+Retrieves a `Group`.
+*/
+await gapi.client.cloudidentity.groups.get({ name: "name",  });
+
+/*
+Get Security Settings
+*/
+await gapi.client.cloudidentity.groups.getSecuritySettings({ name: "name",  });
+
+/*
+Lists the `Group` resources under a customer or namespace.
+*/
+await gapi.client.cloudidentity.groups.list({  });
+
+/*
+Looks up the [resource name](https://cloud.google.com/apis/design/resource_names) of a `Group` by its `EntityKey`.
+*/
+await gapi.client.cloudidentity.groups.lookup({  });
+
+/*
+Updates a `Group`.
+*/
+await gapi.client.cloudidentity.groups.patch({ name: "name",  });
+
+/*
+Searches for `Group` resources matching a specified query.
+*/
+await gapi.client.cloudidentity.groups.search({  });
+
+/*
+Update Security Settings
+*/
+await gapi.client.cloudidentity.groups.updateSecuritySettings({ name: "name",  });
+```