google-admin-sdk

node.js library that wraps Google's Admin SDK. A subset of CRUD actions in the Directory API are supported.

![Build Status](https://circleci.com/gh/Clever/node-google-admin-sdk)

Initializing the library

The library includes 4 submodules:
* OrgUnitProvisioning for CRUD operations on OrgUnits
* UserProvisioning for CRUD operations on Google Apps users
* GroupProvisioning for CRUD operations on Groups
* Batch for batching requests

To use the library, you must have your Google credentials in the form
``opts = { client: { id: '12345.apps.googleusercontent.com', secret: 'abcdefgh' }, token: { refresh: 'your_refresh_token' } };

The library is designed such that you can initialize and use any submodule independently of the other three. Any or all submodules can be initialized using the credentials above:`admin_sdk = require('google-admin-sdk'); user_provisioning = new admin_sdk.UserProvisioning(opts);`

`Example usage`


new_user = {
  name: {
    givenName: 'Grace',
    familyName: 'Hopper',
  },
  password: 'password1234',
  primaryEmail: 'grace.hopper@example.com'
  fields: "kind,nextPageToken,users(id,kind,name,orgUnitPath,primaryEmail)"
};
user_provisioning.insert(new_user, function(err, body) {
  console.log("Received response: " + body);
});


Note: it is recommended to use Google's fields editor to construct queries with

fields arguments.

`new_user = { name: { givenName: 'Grace', familyName: 'Hopper', }, password: 'password1234', primaryEmail: 'grace.hopper@example.com' }; query = user_provisioning.insert(new_usery); query.exec(function(err, body){ // Handle error and body });`

`OrgUnitProvisioning`


The following provide functionality for querying the orgunits endpoint of the Directory API. For information on constructing queries and parsing responses, see the official documentation.
$3

Creates an OrgUnit and any of its parents that need to be created. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit

: an array of the form that specifies the path of the OrgUnit to create. For example, to create the OrgUnit "/Users/Admins/SuperAdmins", pass in

['Users', 'Admins', 'SuperAdmins'].
* cache (optional): a map of strings representing OrgUnits that are known to exist. For example,

{'/': 1, 'Users':1, 'Admins':1}
*

callback (optional): function of the form callback(error, body) to call when the response is received.

Note that findOrCreate uses async.memoize. This can cause problems with tests that expect a fresh state at the beginning of each test. You can use async.unmemoize to reset state.

`$3`


Creates an OrgUnit. Accepts arguments:
*

customer_id

: your Google customer id.
*

properties: an object that specifies the name of the OrgUnit to create. Uses the form { name: 'X', parent: 'Y' }. Note that the parent must already exist; to deep create an OrgUnit, use OrgUnitProvisioning.findOrCreate

.
*

fields

 (optional): fields to return in the response.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Lists OrgUnits owned by a customer. Accepts arguments:
*

customer_id

: your Google customer id.
*

params

 (optional): object containing querystring arguments.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Gets a single OrgUnit owned by a customer. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit_path

: String representation of the OrgUnit to find.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Updates an OrgUnit using patch semantics. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit_path

: the full OrgUnit path to update.
*

body

 (optional): object containing the fields to update on the OrgUnit and their new values.
*

fields

 (optional): fields to return in the response.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Deletes an OrgUnit. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit_path

: String representation of the OrgUnit to delete.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.


User Provisioning

The following provide functionality for querying the Users endpoint of the Directory API. For information on constructing queries and parsing responses, see the official documentation.
$3

Creates a Google Apps user. Accepts arguments:
*

body: specifies the name, password, and primaryEmail

 of the user.
*

fields

 (optional): specifies which user fields are included in the response.
*

callback (optional): a function of the form callback(error, body)

 to be called when the response is received.
$3

Gets information for a single user. Accepts arguments:
*

userkey

: the unique userkey of the user to find.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Lists Google Apps users. Accepts arguments:
*

params

: user fields to query by
*

callback (optional): function of the form callback(error, body) to call when the response is received.

#### Example`// Get at most 200 users in the domainexample.comparams = { domain: 'example.com', max_results: 200 };

user_provisioning.list(params, function(err, body) { // Handle error and do something with users });`

`$3`


Updates a user using patch semantics. Accepts arguments:
*

userkey

: the unique userkey of the user to update.
*

body

: object containing fields to update on the user and their new values.
*

fields

 (optional): fields to return in the response.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Same as

patch

, but updates a user without using patch semantics.
$3

Deletes a user. Accepts arguments:
*

userkey

: the unique userkey of the user to delete.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.

Group Provisioning

GroupProvisioning supports all functions supported by UserProvisioning except

update. The function signatures and behaviors are identical, except they accept a unique groupkey instead of a unique userkey.


Batch

$3

Executes queries in batches. Accepts arguments:
*

queries

: an array of GoogleQueries (returned by invoking CRUD functions in other submodules without a callback) to execute.
*

callback: function of the form callback(error, body) to call when the response is received.

#### Example`queries = []; user1_properties = { name: { familyName: 'Parr', givenName: 'Bob' }, password: 'password12345', primaryEmail: 'bob@example.com' }; user2_properties = { name: { familyName: 'Huph', givenName: 'Gilbert' }, password: 'password12345', primaryEmail: 'gilbert@example.com' }; queries.push(UserProvisioning.insert(user1_properties)); queries.push(UserProvisioning.insert(user2_properties)); Batch.go(queries, function(error, results){ // Handle error and parse results });``

google-admin-sdk

node.js library that wraps Google's Admin SDK. A subset of CRUD actions in the Directory API are supported.

![Build Status](https://circleci.com/gh/Clever/node-google-admin-sdk)

Initializing the library

To use the library, you must have your Google credentials in the form
``opts = { client: { id: '12345.apps.googleusercontent.com', secret: 'abcdefgh' }, token: { refresh: 'your_refresh_token' } };

`Example usage`


new_user = {
  name: {
    givenName: 'Grace',
    familyName: 'Hopper',
  },
  password: 'password1234',
  primaryEmail: 'grace.hopper@example.com'
  fields: "kind,nextPageToken,users(id,kind,name,orgUnitPath,primaryEmail)"
};
user_provisioning.insert(new_user, function(err, body) {
  console.log("Received response: " + body);
});


Note: it is recommended to use Google's fields editor to construct queries with

fields arguments.

`OrgUnitProvisioning`


The following provide functionality for querying the orgunits endpoint of the Directory API. For information on constructing queries and parsing responses, see the official documentation.
$3

Creates an OrgUnit and any of its parents that need to be created. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit

: an array of the form that specifies the path of the OrgUnit to create. For example, to create the OrgUnit "/Users/Admins/SuperAdmins", pass in

['Users', 'Admins', 'SuperAdmins'].
* cache (optional): a map of strings representing OrgUnits that are known to exist. For example,

{'/': 1, 'Users':1, 'Admins':1}
*

callback (optional): function of the form callback(error, body) to call when the response is received.

Note that findOrCreate uses async.memoize. This can cause problems with tests that expect a fresh state at the beginning of each test. You can use async.unmemoize to reset state.

`$3`


Creates an OrgUnit. Accepts arguments:
*

customer_id

: your Google customer id.
*

.
*

fields

 (optional): fields to return in the response.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Lists OrgUnits owned by a customer. Accepts arguments:
*

customer_id

: your Google customer id.
*

params

 (optional): object containing querystring arguments.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Gets a single OrgUnit owned by a customer. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit_path

: String representation of the OrgUnit to find.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Updates an OrgUnit using patch semantics. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit_path

: the full OrgUnit path to update.
*

body

 (optional): object containing the fields to update on the OrgUnit and their new values.
*

fields

 (optional): fields to return in the response.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Deletes an OrgUnit. Accepts arguments:
*

customer_id

: your Google customer id.
*

org_unit_path

: String representation of the OrgUnit to delete.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.


User Provisioning

The following provide functionality for querying the Users endpoint of the Directory API. For information on constructing queries and parsing responses, see the official documentation.
$3

Creates a Google Apps user. Accepts arguments:
*

body: specifies the name, password, and primaryEmail

 of the user.
*

fields

 (optional): specifies which user fields are included in the response.
*

callback (optional): a function of the form callback(error, body)

 to be called when the response is received.
$3

Gets information for a single user. Accepts arguments:
*

userkey

: the unique userkey of the user to find.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Lists Google Apps users. Accepts arguments:
*

params

: user fields to query by
*

callback (optional): function of the form callback(error, body) to call when the response is received.

#### Example`// Get at most 200 users in the domainexample.comparams = { domain: 'example.com', max_results: 200 };

user_provisioning.list(params, function(err, body) { // Handle error and do something with users });`

`$3`


Updates a user using patch semantics. Accepts arguments:
*

userkey

: the unique userkey of the user to update.
*

body

: object containing fields to update on the user and their new values.
*

fields

 (optional): fields to return in the response.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.
$3

Same as

patch

, but updates a user without using patch semantics.
$3

Deletes a user. Accepts arguments:
*

userkey

: the unique userkey of the user to delete.
*

callback (optional): function of the form callback(error, body)

 to call when the response is received.

Group Provisioning

GroupProvisioning supports all functions supported by UserProvisioning except

update. The function signatures and behaviors are identical, except they accept a unique groupkey instead of a unique userkey.


Batch

$3

Executes queries in batches. Accepts arguments:
*

queries

: an array of GoogleQueries (returned by invoking CRUD functions in other submodules without a callback) to execute.
*

callback: function of the form callback(error, body) to call when the response is received.