(PureBasic) MS Teamwork: Update an Online Meeting

See more Microsoft Teams Examples

Demonstrates how to update a Microsoft Teamwork Online Meeting

Note:If using Application access (i.e. client credentials) which is what this example is doing, then you'll need to "Configure application access to online meetings or virtual events" See https://learn.microsoft.com/en-us/graph/cloud-communication-online-meeting-application-access-policy#configure-application-access-policy

For example, here's our Powershell session to setup the policy.

Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
Try the new cross-platform PowerShell
https://aka.ms/pscore6 

PS C:\WINDOWS\system32> Install-Module -Name PowerShellGet -Force -AllowClobber
PS C:\WINDOWS\system32> Install-Module -Name MicrosoftTeams -Force -AllowClobber
PS C:\WINDOWS\system32> Connect-MicrosoftTeams

Account              Environment Tenant                               TenantId
-------              ----------- ------                               --------
admin@chilkat365.com AzureCloud  112d7ed6-71bf-4eba-a866-738364321bfc 112d7ed6-71bf-4eba-a866-738364321bfc

PS C:\WINDOWS\system32> New-CsApplicationAccessPolicy -Identity Test-Teams-policy -AppIds "e1cd2318-298b-4916-bfd6-78cae9938835" -Description "Want App to be able to work with Teams for a User"

Identity    : Tag:Test-Teams-policy
AppIds      : {e1cd2318-298b-4916-bfd6-78cae9938835}
Description : Want App to be able to work with Teams for a User

PS C:\WINDOWS\system32> Grant-CsApplicationAccessPolicy -PolicyName Test-Teams-policy -Identity "4ee732c3-322e-4a6b-b729-2fd1eb5c6004"
PS C:\WINDOWS\system32>

Note: This example uses the new "Integrated OAuth2 Client Credentials" feature introduced in Chilkat v9.5.0.96.

For more information, see https://learn.microsoft.com/en-us/graph/api/onlinemeeting-update?view=graph-rest-1.0&tabs=http

Chilkat PureBasic Module Download Chilkat PureBasic Module

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

Procedure ChilkatExample()

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

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

    ; Provide the information needed for Chilkat to automatically fetch the OAuth2.0 
    ; access token as needed.
    ; This is the new "Integrated OAuth2 Client Credentials" feature introduced in Chilkat v9.5.0.96.  
    jsonOAuthCC.i = CkJsonObject::ckCreate()
    If jsonOAuthCC.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; --------------------------------------------------------------------------------------------------------
    ; You'll need to have registered an app in Azure beforehand.
    ; 
    ; Note: Creating an online meeting requires the following Application permission:  OnlineMeetings.ReadWrite.All
    ; 
    ; See How to Create an Azure App Registration for OAuth 2.0 Client Credentials
    ; --------------------------------------------------------------------------------------------------------

    ; Use the values from your App Registration in Azure.
    CkJsonObject::ckUpdateString(jsonOAuthCC,"client_id","e1cd2318-xxxx-4916-bfd6-xxxxxxxxxxxx")
    CkJsonObject::ckUpdateString(jsonOAuthCC,"client_secret","K.d8Q~RoJxxxxvCj_u_xxxxxxxxxxxxxxxxxxxxx")

    ; You'll always use this scope for client credentials, because the allowed actions
    ; are determined by the App Permissions defined when you registered the app in Azure.
    CkJsonObject::ckUpdateString(jsonOAuthCC,"scope","https://graph.microsoft.com/.default")

    ; The token endpoint includes your tenant ID.  Use your tenant ID (not the tenant ID shown here).
    CkJsonObject::ckUpdateString(jsonOAuthCC,"token_endpoint","https://login.microsoftonline.com/112d7ed6-71bf-4eba-a866-738364321bfc/oauth2/v2.0/token")

    ; Provide the OAuth2 information. Chilkat will use this information to automatically fetch the OAuth2 access token as needed,
    CkHttp::setCkAuthToken(http, CkJsonObject::ckEmit(jsonOAuthCC))

    ; -------------------------------------------------------------------------------------------
    ; The following JSON is sent in the request body.

    ; {
    ;   "startDateTime": "2023-12-14T14:33:30-07:00",
    ;   "endDateTime": "2023-12-14T15:03:30-07:00",
    ;   "subject": "Patch Meeting Subject"
    ; }

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

    CkJsonObject::ckUpdateString(json,"startDateTime","2023-12-14T14:33:30-07:00")
    CkJsonObject::ckUpdateString(json,"endDateTime","2023-12-14T15:03:30-07:00")
    CkJsonObject::ckUpdateString(json,"subject","Patch Meeting Subject")

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

    CkJsonObject::ckEmitSb(json,sbRequestBody)

    ; To update an online meeting, send a PATCH request like this:
    ; 
    ; PATCH https://graph.microsoft.com/v1.0/users/{userId}/onlineMeetings/{meetingId}
    ; Content-Type: application/json 
    ; 
    ; {
    ;   "startDateTime": "2020-09-09T14:33:30.8546353-07:00",
    ;   "endDateTime": "2020-09-09T15:03:30.8566356-07:00",
    ;   "subject": "Patch Meeting Subject"
    ; }

    userId.s = "4ee732c3-322e-4a6b-b729-2fd1eb5c6004"
    meetingId.s = "MSo0ZWU3MzJjMy0zMjJlLTRhNmItYjcyOS0yZmQxZWI1YzYwMDQqMCoqMTk6bWVldGluZ19OemMwT0RGa1pESXRNV1ZoTkMwME9UQXpMV0psWXpJdFkyRXdNR0kzTVdNME5qTmpAdGhyZWFkLnYy"

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

    CkStringBuilder::ckAppend(sbUrl,"https://graph.microsoft.com/v1.0/users/{userId}/onlineMeetings/{meetingId}")
    numReplaced.i = CkStringBuilder::ckReplace(sbUrl,"{userId}",userId)
    numReplaced = CkStringBuilder::ckReplace(sbUrl,"{meetingId}",meetingId)

    resp.i = CkHttp::ckPTextSb(http,"PATCH",CkStringBuilder::ckGetAsString(sbUrl),sbRequestBody,"utf-8","application/json",0,0)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(jsonOAuthCC)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbRequestBody)
        CkStringBuilder::ckDispose(sbUrl)
        ProcedureReturn
    EndIf

    ; ----------------------------------------------------------------------------------------
    ; IMPORTANT: 

    ; If using Application access, you will get the following error unless you configure your application
    ; to manage online meetings on behalf of the user.  (Note that the user ID is in the URL shown above.)
    ; See  https://learn.microsoft.com/en-us/graph/cloud-communication-online-meeting-application-access-policy#allow-applications-to-access-online-meetings-on-behalf-of-a-user 
    ; 
    ; {
    ;   "error": {
    ;     "code": "General",
    ;     "message": "No application access policy found for this app.",
    ;     "innerError": {
    ;       "request-id": "1c9bd09a-a089-4afd-add4-eec2334135c8",
    ;       "date": "2023-11-17T16:26:53",
    ;       "client-request-id": "1c9bd09a-a089-4afd-add4-eec2334135c8"
    ;     }
    ;   }
    ; }
    ; ----------------------------------------------------------------------------------------

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

    CkJsonObject::ckLoad(jsonResp,CkHttpResponse::ckBodyStr(resp))
    CkJsonObject::setCkEmitCompact(jsonResp, 0)
    Debug CkJsonObject::ckEmit(jsonResp)

    statusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "response status code = " + Str(statusCode)

    CkHttpResponse::ckDispose(resp)

    If statusCode <> 200
        Debug "Failed."
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(jsonOAuthCC)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbRequestBody)
        CkStringBuilder::ckDispose(sbUrl)
        CkJsonObject::ckDispose(jsonResp)
        ProcedureReturn
    EndIf

    ; Here is a sample response:

    ; Use the following online tool to generate parsing code from sample JSON: 
    ; Generate Parsing Code from JSON

    ; Use the following online tool to generate parsing code from sample JSON: 
    ; Generate Parsing Code from JSON

    Debug "Success."


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(jsonOAuthCC)
    CkJsonObject::ckDispose(json)
    CkStringBuilder::ckDispose(sbRequestBody)
    CkStringBuilder::ckDispose(sbUrl)
    CkJsonObject::ckDispose(jsonResp)


    ProcedureReturn
EndProcedure