PureBasic

Create Group

See more Microsoft Group Examples

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.

PureBasic

IncludeFile "CkHttpResponse.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkJsonObject.pb"

Procedure ChilkatExample()

    success.i = 0

    ; This example requires the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Use your previously obtained access token as shown here:
    ;    Get Microsoft Graph OAuth2 Access Token with Group.ReadWrite.All scope.

    jsonToken.i = CkJsonObject::ckCreate()
    If jsonToken.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkJsonObject::ckLoadFile(jsonToken,"qa_data/tokens/msGraphGroup.json")
    If success = 0
        Debug CkJsonObject::ckLastErrorText(jsonToken)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(jsonToken)
        ProcedureReturn
    EndIf

    CkHttp::setCkAuthToken(http, CkJsonObject::ckStringOf(jsonToken,"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
    ; }

    json.i = CkJsonObject::ckCreate()
    If json.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(json,"description","Self help community for library")
    CkJsonObject::ckUpdateString(json,"displayName","Library Assist")
    CkJsonObject::ckUpdateString(json,"groupTypes[0]","Unified")
    CkJsonObject::ckUpdateBool(json,"mailEnabled",1)
    CkJsonObject::ckUpdateString(json,"mailNickname","library")
    CkJsonObject::ckUpdateBool(json,"securityEnabled",0)

    ; POST the JSON to https://graph.microsoft.com/v1.0/groups

    resp.i = CkHttpResponse::ckCreate()
    If resp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkHttp::ckHttpJson(http,"POST","https://graph.microsoft.com/v1.0/groups",json,"application/json",resp)
    If success = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(jsonToken)
        CkJsonObject::ckDispose(json)
        CkHttpResponse::ckDispose(resp)
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoad(json,CkHttpResponse::ckBodyStr(resp))
    CkJsonObject::setCkEmitCompact(json, 0)

    If CkHttpResponse::ckStatusCode(resp) <> 201
        Debug CkJsonObject::ckEmit(json)
        Debug "Failed, response status code = " + Str(CkHttpResponse::ckStatusCode(resp))
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(jsonToken)
        CkJsonObject::ckDispose(json)
        CkHttpResponse::ckDispose(resp)
        ProcedureReturn
    EndIf

    Debug CkJsonObject::ckEmit(json)

    ; 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

    id.s
    deletedDateTime.s
    classification.s
    createdDateTime.s
    description.s
    displayName.s
    mail.s
    mailEnabled.i
    mailNickname.s
    onPremisesLastSyncDateTime.s
    onPremisesSecurityIdentifier.s
    onPremisesSyncEnabled.s
    preferredDataLocation.s
    renewedDateTime.s
    securityEnabled.i
    visibility.s
    i.i
    count_i.i
    strVal.s

    id = CkJsonObject::ckStringOf(json,"id")
    deletedDateTime = CkJsonObject::ckStringOf(json,"deletedDateTime")
    classification = CkJsonObject::ckStringOf(json,"classification")
    createdDateTime = CkJsonObject::ckStringOf(json,"createdDateTime")
    description = CkJsonObject::ckStringOf(json,"description")
    displayName = CkJsonObject::ckStringOf(json,"displayName")
    mail = CkJsonObject::ckStringOf(json,"mail")
    mailEnabled = CkJsonObject::ckBoolOf(json,"mailEnabled")
    mailNickname = CkJsonObject::ckStringOf(json,"mailNickname")
    onPremisesLastSyncDateTime = CkJsonObject::ckStringOf(json,"onPremisesLastSyncDateTime")
    onPremisesSecurityIdentifier = CkJsonObject::ckStringOf(json,"onPremisesSecurityIdentifier")
    onPremisesSyncEnabled = CkJsonObject::ckStringOf(json,"onPremisesSyncEnabled")
    preferredDataLocation = CkJsonObject::ckStringOf(json,"preferredDataLocation")
    renewedDateTime = CkJsonObject::ckStringOf(json,"renewedDateTime")
    securityEnabled = CkJsonObject::ckBoolOf(json,"securityEnabled")
    visibility = CkJsonObject::ckStringOf(json,"visibility")
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(json,"creationOptions")
    While i < count_i
        CkJsonObject::setCkI(json, i)
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(json,"groupTypes")
    While i < count_i
        CkJsonObject::setCkI(json, i)
        strVal = CkJsonObject::ckStringOf(json,"groupTypes[i]")
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(json,"proxyAddresses")
    While i < count_i
        CkJsonObject::setCkI(json, i)
        strVal = CkJsonObject::ckStringOf(json,"proxyAddresses[i]")
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(json,"resourceBehaviorOptions")
    While i < count_i
        CkJsonObject::setCkI(json, i)
        ; ...
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(json,"resourceProvisioningOptions")
    While i < count_i
        CkJsonObject::setCkI(json, i)
        ; ...
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(json,"onPremisesProvisioningErrors")
    While i < count_i
        CkJsonObject::setCkI(json, i)
        ; ...
        i = i + 1
    Wend

    Debug "Success."


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(jsonToken)
    CkJsonObject::ckDispose(json)
    CkHttpResponse::ckDispose(resp)


    ProcedureReturn
EndProcedure