(Tcl) 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 Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set http [new_CkHttp]

# 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.  
set jsonOAuthCC [new_CkJsonObject]

# --------------------------------------------------------------------------------------------------------
# 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_UpdateString $jsonOAuthCC "client_id" "e1cd2318-xxxx-4916-bfd6-xxxxxxxxxxxx"
CkJsonObject_UpdateString $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_UpdateString $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_UpdateString $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_put_AuthToken $http [CkJsonObject_emit $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"
# }

set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "startDateTime" "2023-12-14T14:33:30-07:00"
CkJsonObject_UpdateString $json "endDateTime" "2023-12-14T15:03:30-07:00"
CkJsonObject_UpdateString $json "subject" "Patch Meeting Subject"

set sbRequestBody [new_CkStringBuilder]

CkJsonObject_EmitSb $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"
# }

set userId "4ee732c3-322e-4a6b-b729-2fd1eb5c6004"
set meetingId "MSo0ZWU3MzJjMy0zMjJlLTRhNmItYjcyOS0yZmQxZWI1YzYwMDQqMCoqMTk6bWVldGluZ19OemMwT0RGa1pESXRNV1ZoTkMwME9UQXpMV0psWXpJdFkyRXdNR0kzTVdNME5qTmpAdGhyZWFkLnYy"

set sbUrl [new_CkStringBuilder]

CkStringBuilder_Append $sbUrl "https://graph.microsoft.com/v1.0/users/{userId}/onlineMeetings/{meetingId}"
set numReplaced [CkStringBuilder_Replace $sbUrl "{userId}" $userId]
set numReplaced [CkStringBuilder_Replace $sbUrl "{meetingId}" $meetingId]

# resp is a CkHttpResponse
set resp [CkHttp_PTextSb $http "PATCH" [CkStringBuilder_getAsString $sbUrl] $sbRequestBody "utf-8" "application/json" 0 0]
if {[CkHttp_get_LastMethodSuccess $http] == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $jsonOAuthCC
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbRequestBody
    delete_CkStringBuilder $sbUrl
    exit
}

# ----------------------------------------------------------------------------------------
# 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"
#     }
#   }
# }
# ----------------------------------------------------------------------------------------

set jsonResp [new_CkJsonObject]

CkJsonObject_Load $jsonResp [CkHttpResponse_bodyStr $resp]
CkJsonObject_put_EmitCompact $jsonResp 0
puts [CkJsonObject_emit $jsonResp]

set statusCode [CkHttpResponse_get_StatusCode $resp]
puts "response status code = $statusCode"

delete_CkHttpResponse $resp

if {$statusCode != 200} then {
    puts "Failed."
    delete_CkHttp $http
    delete_CkJsonObject $jsonOAuthCC
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbRequestBody
    delete_CkStringBuilder $sbUrl
    delete_CkJsonObject $jsonResp
    exit
}

# 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

puts "Success."

delete_CkHttp $http
delete_CkJsonObject $jsonOAuthCC
delete_CkJsonObject $json
delete_CkStringBuilder $sbRequestBody
delete_CkStringBuilder $sbUrl
delete_CkJsonObject $jsonResp