2023-01-27 03:22:44 -08:00
|
|
|
import type {
|
2023-03-09 09:13:15 -08:00
|
|
|
IExecuteFunctions,
|
2020-10-03 09:09:07 -07:00
|
|
|
IDataObject,
|
|
|
|
ILoadOptionsFunctions,
|
2020-10-03 09:10:03 -07:00
|
|
|
INodeExecutionData,
|
2020-10-03 09:09:07 -07:00
|
|
|
INodePropertyOptions,
|
2020-10-03 09:10:03 -07:00
|
|
|
INodeType,
|
|
|
|
INodeTypeDescription,
|
2020-10-03 09:09:07 -07:00
|
|
|
} from 'n8n-workflow';
|
2023-01-27 03:22:44 -08:00
|
|
|
import { NodeOperationError } from 'n8n-workflow';
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2022-08-17 08:50:24 -07:00
|
|
|
import { googleApiRequest, googleApiRequestAllItems } from './GenericFunctions';
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2022-08-17 08:50:24 -07:00
|
|
|
import { userFields, userOperations } from './UserDescription';
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2022-08-17 08:50:24 -07:00
|
|
|
import { groupFields, groupOperations } from './GroupDescripion';
|
2020-10-23 00:15:11 -07:00
|
|
|
|
2020-10-03 09:09:07 -07:00
|
|
|
export class GSuiteAdmin implements INodeType {
|
|
|
|
description: INodeTypeDescription = {
|
2022-10-12 07:05:52 -07:00
|
|
|
displayName: 'Google Workspace Admin',
|
2020-10-03 09:09:07 -07:00
|
|
|
name: 'gSuiteAdmin',
|
2022-06-20 07:54:01 -07:00
|
|
|
// eslint-disable-next-line n8n-nodes-base/node-class-description-icon-not-svg
|
2022-10-12 07:05:52 -07:00
|
|
|
icon: 'file:google-workspace-admin.png',
|
2020-10-03 09:09:07 -07:00
|
|
|
group: ['input'],
|
|
|
|
version: 1,
|
|
|
|
subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
|
2022-10-12 07:05:52 -07:00
|
|
|
description: 'Consume Google Workspace Admin API',
|
2020-10-03 09:09:07 -07:00
|
|
|
defaults: {
|
2022-10-12 07:05:52 -07:00
|
|
|
name: 'Google Workspace Admin',
|
2020-10-03 09:09:07 -07:00
|
|
|
},
|
|
|
|
inputs: ['main'],
|
|
|
|
outputs: ['main'],
|
|
|
|
credentials: [
|
|
|
|
{
|
|
|
|
name: 'gSuiteAdminOAuth2Api',
|
|
|
|
required: true,
|
|
|
|
},
|
|
|
|
],
|
|
|
|
properties: [
|
|
|
|
{
|
|
|
|
displayName: 'Resource',
|
|
|
|
name: 'resource',
|
|
|
|
type: 'options',
|
2022-05-20 14:47:24 -07:00
|
|
|
noDataExpression: true,
|
2020-10-03 09:09:07 -07:00
|
|
|
options: [
|
2020-10-23 00:15:11 -07:00
|
|
|
{
|
|
|
|
name: 'Group',
|
|
|
|
value: 'group',
|
|
|
|
},
|
2020-10-03 09:09:07 -07:00
|
|
|
{
|
|
|
|
name: 'User',
|
|
|
|
value: 'user',
|
|
|
|
},
|
|
|
|
],
|
|
|
|
default: 'user',
|
|
|
|
},
|
2020-10-23 00:15:11 -07:00
|
|
|
...groupOperations,
|
|
|
|
...groupFields,
|
2020-10-03 09:09:07 -07:00
|
|
|
...userOperations,
|
|
|
|
...userFields,
|
|
|
|
],
|
|
|
|
};
|
|
|
|
|
|
|
|
methods = {
|
|
|
|
loadOptions: {
|
2023-04-19 07:00:49 -07:00
|
|
|
// Get all the domains to display them to user so that they can
|
2020-10-03 09:09:07 -07:00
|
|
|
// select them easily
|
2022-08-17 08:50:24 -07:00
|
|
|
async getDomains(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
2020-10-03 09:09:07 -07:00
|
|
|
const returnData: INodePropertyOptions[] = [];
|
|
|
|
const domains = await googleApiRequestAllItems.call(
|
|
|
|
this,
|
|
|
|
'domains',
|
|
|
|
'GET',
|
2020-10-22 09:00:28 -07:00
|
|
|
'/directory/v1/customer/my_customer/domains',
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
for (const domain of domains) {
|
|
|
|
const domainName = domain.domainName;
|
|
|
|
const domainId = domain.domainName;
|
|
|
|
returnData.push({
|
|
|
|
name: domainName,
|
2020-10-22 06:46:03 -07:00
|
|
|
value: domainId,
|
2020-10-03 09:09:07 -07:00
|
|
|
});
|
|
|
|
}
|
|
|
|
return returnData;
|
|
|
|
},
|
2023-04-19 07:00:49 -07:00
|
|
|
// Get all the schemas to display them to user so that they can
|
2020-10-03 09:09:07 -07:00
|
|
|
// select them easily
|
2022-08-17 08:50:24 -07:00
|
|
|
async getSchemas(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
|
2020-10-03 09:09:07 -07:00
|
|
|
const returnData: INodePropertyOptions[] = [];
|
|
|
|
const schemas = await googleApiRequestAllItems.call(
|
|
|
|
this,
|
|
|
|
'schemas',
|
|
|
|
'GET',
|
2020-10-22 09:00:28 -07:00
|
|
|
'/directory/v1/customer/my_customer/schemas',
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
for (const schema of schemas) {
|
|
|
|
const schemaName = schema.displayName;
|
|
|
|
const schemaId = schema.schemaName;
|
|
|
|
returnData.push({
|
|
|
|
name: schemaName,
|
2020-10-22 06:46:03 -07:00
|
|
|
value: schemaId,
|
2020-10-03 09:09:07 -07:00
|
|
|
});
|
|
|
|
}
|
|
|
|
return returnData;
|
|
|
|
},
|
|
|
|
},
|
|
|
|
};
|
|
|
|
|
|
|
|
async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
|
|
|
|
const items = this.getInputData();
|
2022-08-30 08:55:33 -07:00
|
|
|
const returnData: INodeExecutionData[] = [];
|
2022-04-22 09:29:51 -07:00
|
|
|
const length = items.length;
|
2020-10-03 09:09:07 -07:00
|
|
|
const qs: IDataObject = {};
|
|
|
|
let responseData;
|
2022-12-02 03:53:59 -08:00
|
|
|
const resource = this.getNodeParameter('resource', 0);
|
|
|
|
const operation = this.getNodeParameter('operation', 0);
|
2020-10-03 09:09:07 -07:00
|
|
|
for (let i = 0; i < length; i++) {
|
2020-10-23 00:15:11 -07:00
|
|
|
if (resource === 'group') {
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/groups/insert
|
|
|
|
if (operation === 'create') {
|
|
|
|
const email = this.getNodeParameter('email', i) as string;
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const additionalFields = this.getNodeParameter('additionalFields', i);
|
2020-10-23 00:15:11 -07:00
|
|
|
|
|
|
|
const body: IDataObject = {
|
|
|
|
email,
|
|
|
|
};
|
|
|
|
|
|
|
|
Object.assign(body, additionalFields);
|
|
|
|
|
2022-12-29 03:20:43 -08:00
|
|
|
responseData = await googleApiRequest.call(this, 'POST', '/directory/v1/groups', body);
|
2020-10-23 00:15:11 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/groups/delete
|
|
|
|
if (operation === 'delete') {
|
|
|
|
const groupId = this.getNodeParameter('groupId', i) as string;
|
|
|
|
|
|
|
|
responseData = await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'DELETE',
|
|
|
|
`/directory/v1/groups/${groupId}`,
|
2020-10-23 00:19:45 -07:00
|
|
|
{},
|
2020-10-23 00:15:11 -07:00
|
|
|
);
|
|
|
|
|
|
|
|
responseData = { success: true };
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/groups/get
|
|
|
|
if (operation === 'get') {
|
|
|
|
const groupId = this.getNodeParameter('groupId', i) as string;
|
|
|
|
|
|
|
|
responseData = await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'GET',
|
|
|
|
`/directory/v1/groups/${groupId}`,
|
|
|
|
{},
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/groups/list
|
|
|
|
if (operation === 'getAll') {
|
2022-11-18 05:31:38 -08:00
|
|
|
const returnAll = this.getNodeParameter('returnAll', i);
|
2020-10-23 00:15:11 -07:00
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const options = this.getNodeParameter('options', i);
|
2020-10-23 00:15:11 -07:00
|
|
|
|
|
|
|
Object.assign(qs, options);
|
|
|
|
|
|
|
|
if (qs.customer === undefined) {
|
|
|
|
qs.customer = 'my_customer';
|
|
|
|
}
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2020-10-23 00:15:11 -07:00
|
|
|
if (returnAll) {
|
|
|
|
responseData = await googleApiRequestAllItems.call(
|
|
|
|
this,
|
|
|
|
'groups',
|
|
|
|
'GET',
|
2022-12-29 03:20:43 -08:00
|
|
|
'/directory/v1/groups',
|
2020-10-23 00:15:11 -07:00
|
|
|
{},
|
2020-10-23 00:19:45 -07:00
|
|
|
qs,
|
2020-10-23 00:15:11 -07:00
|
|
|
);
|
|
|
|
} else {
|
2022-11-18 06:26:22 -08:00
|
|
|
qs.maxResults = this.getNodeParameter('limit', i);
|
2020-10-23 00:15:11 -07:00
|
|
|
|
2022-12-29 03:20:43 -08:00
|
|
|
responseData = await googleApiRequest.call(this, 'GET', '/directory/v1/groups', {}, qs);
|
2020-10-23 00:15:11 -07:00
|
|
|
|
|
|
|
responseData = responseData.groups;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/groups/update
|
|
|
|
if (operation === 'update') {
|
|
|
|
const groupId = this.getNodeParameter('groupId', i) as string;
|
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const updateFields = this.getNodeParameter('updateFields', i);
|
2020-10-23 00:15:11 -07:00
|
|
|
|
|
|
|
const body: IDataObject = {};
|
|
|
|
|
|
|
|
Object.assign(body, updateFields);
|
|
|
|
|
|
|
|
responseData = await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'PUT',
|
|
|
|
`/directory/v1/groups/${groupId}`,
|
|
|
|
body,
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (resource === 'user') {
|
2020-10-03 09:09:07 -07:00
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/users/insert
|
|
|
|
if (operation === 'create') {
|
|
|
|
const domain = this.getNodeParameter('domain', i) as string;
|
|
|
|
|
|
|
|
const firstName = this.getNodeParameter('firstName', i) as string;
|
|
|
|
|
|
|
|
const lastName = this.getNodeParameter('lastName', i) as string;
|
|
|
|
|
|
|
|
const password = this.getNodeParameter('password', i) as string;
|
|
|
|
|
|
|
|
const username = this.getNodeParameter('username', i) as string;
|
|
|
|
|
|
|
|
const makeAdmin = this.getNodeParameter('makeAdmin', i) as boolean;
|
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const additionalFields = this.getNodeParameter('additionalFields', i);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
const body: IDataObject = {
|
|
|
|
name: {
|
|
|
|
familyName: lastName,
|
|
|
|
givenName: firstName,
|
|
|
|
},
|
|
|
|
password,
|
|
|
|
primaryEmail: `${username}@${domain}`,
|
|
|
|
};
|
|
|
|
|
|
|
|
Object.assign(body, additionalFields);
|
|
|
|
|
|
|
|
if (additionalFields.phoneUi) {
|
|
|
|
const phones = (additionalFields.phoneUi as IDataObject).phoneValues as IDataObject[];
|
|
|
|
|
|
|
|
body.phones = phones;
|
|
|
|
|
|
|
|
delete body.phoneUi;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (additionalFields.emailUi) {
|
|
|
|
const emails = (additionalFields.emailUi as IDataObject).emailValues as IDataObject[];
|
|
|
|
|
|
|
|
body.emails = emails;
|
|
|
|
|
|
|
|
delete body.emailUi;
|
|
|
|
}
|
|
|
|
|
2022-12-29 03:20:43 -08:00
|
|
|
responseData = await googleApiRequest.call(this, 'POST', '/directory/v1/users', body, qs);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
if (makeAdmin) {
|
|
|
|
await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'POST',
|
|
|
|
`/directory/v1/users/${responseData.id}/makeAdmin`,
|
2020-10-22 09:00:28 -07:00
|
|
|
{ status: true },
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
|
|
|
|
responseData.isAdmin = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/users/delete
|
|
|
|
if (operation === 'delete') {
|
|
|
|
const userId = this.getNodeParameter('userId', i) as string;
|
|
|
|
|
|
|
|
responseData = await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'DELETE',
|
|
|
|
`/directory/v1/users/${userId}`,
|
2020-10-22 09:00:28 -07:00
|
|
|
{},
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
|
|
|
|
responseData = { success: true };
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/users/get
|
|
|
|
if (operation === 'get') {
|
|
|
|
const userId = this.getNodeParameter('userId', i) as string;
|
|
|
|
|
|
|
|
const projection = this.getNodeParameter('projection', i) as string;
|
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const options = this.getNodeParameter('options', i);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
qs.projection = projection;
|
|
|
|
|
|
|
|
Object.assign(qs, options);
|
|
|
|
|
|
|
|
if (qs.customFieldMask) {
|
|
|
|
qs.customFieldMask = (qs.customFieldMask as string[]).join(' ');
|
|
|
|
}
|
|
|
|
|
|
|
|
if (qs.projection === 'custom' && qs.customFieldMask === undefined) {
|
2022-08-17 08:50:24 -07:00
|
|
|
throw new NodeOperationError(
|
|
|
|
this.getNode(),
|
|
|
|
'When projection is set to custom, the custom schemas field must be defined',
|
|
|
|
{ itemIndex: i },
|
|
|
|
);
|
2020-10-03 09:09:07 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
responseData = await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'GET',
|
|
|
|
`/directory/v1/users/${userId}`,
|
|
|
|
{},
|
2020-10-22 09:00:28 -07:00
|
|
|
qs,
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/users/list
|
|
|
|
if (operation === 'getAll') {
|
2022-11-18 05:31:38 -08:00
|
|
|
const returnAll = this.getNodeParameter('returnAll', i);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
const projection = this.getNodeParameter('projection', i) as string;
|
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const options = this.getNodeParameter('options', i);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
qs.projection = projection;
|
|
|
|
|
|
|
|
Object.assign(qs, options);
|
|
|
|
|
|
|
|
if (qs.customer === undefined) {
|
|
|
|
qs.customer = 'my_customer';
|
|
|
|
}
|
|
|
|
|
|
|
|
if (qs.customFieldMask) {
|
|
|
|
qs.customFieldMask = (qs.customFieldMask as string[]).join(' ');
|
|
|
|
}
|
|
|
|
|
|
|
|
if (qs.projection === 'custom' && qs.customFieldMask === undefined) {
|
2022-08-17 08:50:24 -07:00
|
|
|
throw new NodeOperationError(
|
|
|
|
this.getNode(),
|
|
|
|
'When projection is set to custom, the custom schemas field must be defined',
|
|
|
|
{ itemIndex: i },
|
|
|
|
);
|
2020-10-03 09:09:07 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
if (returnAll) {
|
|
|
|
responseData = await googleApiRequestAllItems.call(
|
|
|
|
this,
|
|
|
|
'users',
|
|
|
|
'GET',
|
2022-12-29 03:20:43 -08:00
|
|
|
'/directory/v1/users',
|
2020-10-03 09:09:07 -07:00
|
|
|
{},
|
2020-10-22 09:00:28 -07:00
|
|
|
qs,
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
} else {
|
2022-11-18 06:26:22 -08:00
|
|
|
qs.maxResults = this.getNodeParameter('limit', i);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2022-12-29 03:20:43 -08:00
|
|
|
responseData = await googleApiRequest.call(this, 'GET', '/directory/v1/users', {}, qs);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
responseData = responseData.users;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
//https://developers.google.com/admin-sdk/directory/v1/reference/users/update
|
|
|
|
if (operation === 'update') {
|
|
|
|
const userId = this.getNodeParameter('userId', i) as string;
|
|
|
|
|
2022-11-18 07:29:44 -08:00
|
|
|
const updateFields = this.getNodeParameter('updateFields', i);
|
2020-10-03 09:09:07 -07:00
|
|
|
|
2022-08-17 08:50:24 -07:00
|
|
|
const body: {
|
|
|
|
name: { givenName?: string; familyName?: string };
|
|
|
|
emails?: IDataObject[];
|
|
|
|
phones?: IDataObject[];
|
|
|
|
} = { name: {} };
|
2020-10-03 09:09:07 -07:00
|
|
|
|
|
|
|
Object.assign(body, updateFields);
|
|
|
|
|
|
|
|
if (updateFields.firstName) {
|
|
|
|
body.name.givenName = updateFields.firstName as string;
|
|
|
|
//@ts-ignore
|
|
|
|
delete body.firstName;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (updateFields.lastName) {
|
|
|
|
body.name.familyName = updateFields.lastName as string;
|
|
|
|
//@ts-ignore
|
|
|
|
delete body.lastName;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (Object.keys(body.name).length === 0) {
|
2020-10-03 09:10:03 -07:00
|
|
|
//@ts-ignore
|
2020-10-03 09:09:07 -07:00
|
|
|
delete body.name;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (updateFields.phoneUi) {
|
|
|
|
const phones = (updateFields.phoneUi as IDataObject).phoneValues as IDataObject[];
|
|
|
|
|
|
|
|
body.phones = phones;
|
|
|
|
|
|
|
|
//@ts-ignore
|
|
|
|
delete body.phoneUi;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (updateFields.emailUi) {
|
|
|
|
const emails = (updateFields.emailUi as IDataObject).emailValues as IDataObject[];
|
|
|
|
|
|
|
|
body.emails = emails;
|
|
|
|
|
|
|
|
//@ts-ignore
|
|
|
|
delete body.emailUi;
|
|
|
|
}
|
|
|
|
|
|
|
|
responseData = await googleApiRequest.call(
|
|
|
|
this,
|
|
|
|
'PUT',
|
|
|
|
`/directory/v1/users/${userId}`,
|
|
|
|
body,
|
2020-10-22 09:00:28 -07:00
|
|
|
qs,
|
2020-10-03 09:09:07 -07:00
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-08-30 08:55:33 -07:00
|
|
|
const executionData = this.helpers.constructExecutionMetaData(
|
2023-02-27 19:39:43 -08:00
|
|
|
this.helpers.returnJsonArray(responseData as IDataObject[]),
|
2022-08-30 08:55:33 -07:00
|
|
|
{ itemData: { item: i } },
|
|
|
|
);
|
|
|
|
|
|
|
|
returnData.push(...executionData);
|
2020-10-03 09:09:07 -07:00
|
|
|
}
|
|
|
|
|
2023-09-05 03:59:02 -07:00
|
|
|
return [returnData];
|
2020-10-03 09:09:07 -07:00
|
|
|
}
|
|
|
|
}
|