|
|
(JavaScript) Create Group
Create a new group as specified in the request body. You can create one of three types of groups:
- Office 365 Group (unified group)
- Dynamic group
- Security group
This operation returns by default only a subset of the properties for each group. These default properties are noted in the Properties section.
See https://docs.microsoft.com/en-us/graph/api/group-post-groups?view=graph-rest-1.0 for more information. Note: This example requires Chilkat v11.0.0 or greater.
var success = false;
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
var http = new CkHttp();
// Use your previously obtained access token as shown here:
// Get Microsoft Graph OAuth2 Access Token with Group.ReadWrite.All scope.
var jsonToken = new CkJsonObject();
success = jsonToken.LoadFile("qa_data/tokens/msGraphGroup.json");
if (success == false) {
console.log(jsonToken.LastErrorText);
return;
}
http.AuthToken = jsonToken.StringOf("access_token");
// Create a JSON body for the HTTP POST
// Use this online tool to generate the code from sample JSON:
// Generate Code to Create JSON
// {
// "description": "Self help community for library",
// "displayName": "Library Assist",
// "groupTypes": [
// "Unified"
// ],
// "mailEnabled": true,
// "mailNickname": "library",
// "securityEnabled": false
// }
var json = new CkJsonObject();
json.UpdateString("description","Self help community for library");
json.UpdateString("displayName","Library Assist");
json.UpdateString("groupTypes[0]","Unified");
json.UpdateBool("mailEnabled",true);
json.UpdateString("mailNickname","library");
json.UpdateBool("securityEnabled",false);
// POST the JSON to https://graph.microsoft.com/v1.0/groups
var resp = new CkHttpResponse();
success = http.HttpJson("POST","https://graph.microsoft.com/v1.0/groups",json,"application/json",resp);
if (success == false) {
console.log(http.LastErrorText);
return;
}
json.Load(resp.BodyStr);
json.EmitCompact = false;
if (resp.StatusCode !== 201) {
console.log(json.Emit());
console.log("Failed, response status code = " + resp.StatusCode);
return;
}
console.log(json.Emit());
// A sample response:
// (See code for parsing this response below..)
// {
// "id": "b320ee12-b1cd-4cca-b648-a437be61c5cd",
// "deletedDateTime": null,
// "classification": null,
// "createdDateTime": "2018-12-22T00:51:37Z",
// "creationOptions": [],
// "description": "Self help community for library",
// "displayName": "Library Assist",
// "groupTypes": [
// "Unified"
// ],
// "mail": "library7423@contoso.com",
// "mailEnabled": true,
// "mailNickname": "library",
// "onPremisesLastSyncDateTime": null,
// "onPremisesSecurityIdentifier": null,
// "onPremisesSyncEnabled": null,
// "preferredDataLocation": "CAN",
// "proxyAddresses": [
// "SMTP:library7423@contoso.com"
// ],
// "renewedDateTime": "2018-12-22T00:51:37Z",
// "resourceBehaviorOptions": [],
// "resourceProvisioningOptions": [],
// "securityEnabled": false,
// "visibility": "Public",
// "onPremisesProvisioningErrors": []
// }
// Use this online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON
var id;
var deletedDateTime;
var classification;
var createdDateTime;
var description;
var displayName;
var mail;
var mailEnabled;
var mailNickname;
var onPremisesLastSyncDateTime;
var onPremisesSecurityIdentifier;
var onPremisesSyncEnabled;
var preferredDataLocation;
var renewedDateTime;
var securityEnabled;
var visibility;
var i;
var count_i;
var strVal;
id = json.StringOf("id");
deletedDateTime = json.StringOf("deletedDateTime");
classification = json.StringOf("classification");
createdDateTime = json.StringOf("createdDateTime");
description = json.StringOf("description");
displayName = json.StringOf("displayName");
mail = json.StringOf("mail");
mailEnabled = json.BoolOf("mailEnabled");
mailNickname = json.StringOf("mailNickname");
onPremisesLastSyncDateTime = json.StringOf("onPremisesLastSyncDateTime");
onPremisesSecurityIdentifier = json.StringOf("onPremisesSecurityIdentifier");
onPremisesSyncEnabled = json.StringOf("onPremisesSyncEnabled");
preferredDataLocation = json.StringOf("preferredDataLocation");
renewedDateTime = json.StringOf("renewedDateTime");
securityEnabled = json.BoolOf("securityEnabled");
visibility = json.StringOf("visibility");
i = 0;
count_i = json.SizeOfArray("creationOptions");
while (i < count_i) {
json.I = i;
i = i+1;
}
i = 0;
count_i = json.SizeOfArray("groupTypes");
while (i < count_i) {
json.I = i;
strVal = json.StringOf("groupTypes[i]");
i = i+1;
}
i = 0;
count_i = json.SizeOfArray("proxyAddresses");
while (i < count_i) {
json.I = i;
strVal = json.StringOf("proxyAddresses[i]");
i = i+1;
}
i = 0;
count_i = json.SizeOfArray("resourceBehaviorOptions");
while (i < count_i) {
json.I = i;
// ...
i = i+1;
}
i = 0;
count_i = json.SizeOfArray("resourceProvisioningOptions");
while (i < count_i) {
json.I = i;
// ...
i = i+1;
}
i = 0;
count_i = json.SizeOfArray("onPremisesProvisioningErrors");
while (i < count_i) {
json.I = i;
// ...
i = i+1;
}
console.log("Success.");
|