Tcl
Tcl
MS Teamwork: Update an Online Meeting
See more Microsoft Teams Examples
Demonstrates how to update a Microsoft Teamwork Online MeetingNote: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>
Chilkat Tcl Downloads
load ./chilkat.dll
set success 0
# 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.
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]
set url [CkStringBuilder_getAsString $sbUrl]
set resp [new_CkHttpResponse]
set success [CkHttp_HttpSb $http "PATCH" $url $sbRequestBody "utf-8" "application/json" $resp]
if {$success == 0} then {
puts [CkHttp_lastErrorText $http]
delete_CkHttp $http
delete_CkJsonObject $jsonOAuthCC
delete_CkJsonObject $json
delete_CkStringBuilder $sbRequestBody
delete_CkStringBuilder $sbUrl
delete_CkHttpResponse $resp
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"
if {$statusCode != 200} then {
puts "Failed."
delete_CkHttp $http
delete_CkJsonObject $jsonOAuthCC
delete_CkJsonObject $json
delete_CkStringBuilder $sbRequestBody
delete_CkStringBuilder $sbUrl
delete_CkHttpResponse $resp
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
# {
# "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('4ee732c3-322e-4a6b-b729-2fd1eb5c6004')/onlineMeetings/$entity",
# "id": "MSo0ZWU3MzJjMy0zMjJlLTRhNmItYjcyOS0yZmQxZWI1YzYwMDQqMCoqMTk6bWVldGluZ19OemMwT0RGa1pESXRNV1ZoTkMwME9UQXpMV0psWXpJdFkyRXdNR0kzTVeNME5qTmpAdGhyZWFkLnYy",
# "creationDateTime": "2023-11-17T18:28:15.9746525Z",
# "startDateTime": "2023-12-14T21:33:30Z",
# "endDateTime": "2023-12-14T22:03:30Z",
# "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_Nzd0ODFkZDItMWVhNC00OTAzLWJlYzItY2EwMGI3MWM0NjNj%40thread.v2/0?context=%7b%22Tid%22%3a%22112d7ed6-71bf-4eba-a866-738364321bfc%22%2c%22Oid%22%3a%224ee732c3-322e-4a6b-b729-2fd1eb5c6004%22%7d",
# "meetingCode": "215394732897",
# "isBroadcast": false,
# "autoAdmittedUsers": "everyoneInCompany",
# "outerMeetingAutoAdmittedUsers": null,
# "capabilities": [
# ],
# "externalId": null,
# "iCalUid": null,
# "meetingType": null,
# "meetingMigrationMode": null,
# "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_Nzd0ODFkZDItMWVhNC00OTAzLWJlYzItY2EwMGI3MWM0NjNj%40thread.v2/0?context=%7b%22Tid%22%3a%22112d7ed6-71bf-4eba-a866-738364321bfc%22%2c%22Oid%22%3a%224ee732c3-322e-4a6b-b729-2fd1eb5c6004%22%7d",
# "subject": "Patch Meeting Subject",
# "videoTeleconferenceId": null,
# "isEntryExitAnnounced": true,
# "allowedPresenters": "everyone",
# "allowAttendeeToEnableMic": true,
# "allowAttendeeToEnableCamera": true,
# "allowMeetingChat": "enabled",
# "shareMeetingChatHistoryDefault": "none",
# "allowTeamworkReactions": true,
# "anonymizeIdentityForRoles": [
# ],
# "recordAutomatically": false,
# "allowParticipantsToChangeName": false,
# "allowTranscription": true,
# "allowRecording": true,
# "broadcastSettings": null,
# "meetingInfo": null,
# "audioConferencing": null,
# "watermarkProtection": null,
# "chatRestrictions": null,
# "participants": {
# "organizer": {
# "upn": "admin@chilkat365.com",
# "role": "presenter",
# "identity": {
# "application": null,
# "device": null,
# "user": {
# "id": "4ee732c3-322e-4a6b-b729-2fd1eb5c6004",
# "displayName": null,
# "tenantId": "112d7ed6-71bf-4eba-a866-738364321bfc",
# "identityProvider": "AAD"
# }
# }
# },
# "attendees": [
# ]
# },
# "chatInfo": {
# "threadId": "19:meeting_Nzc0ODFkZDItMWVhNC00OTAzLWJlYzItY2EwMGI3MWM0NjNj@thread.v2",
# "messageId": "0",
# "replyChainMessageId": null
# },
# "joinInformation": {
# "content": "data:text/html,%3cdiv+style ... %2fdiv%3e",
# "contentType": "html"
# },
# "joinMeetingIdSettings": {
# "isPasscodeRequired": false,
# "joinMeetingId": "215394732897",
# "passcode": null
# },
# "lobbyBypassSettings": {
# "scope": "organization",
# "isDialInBypassEnabled": false
# }
# }
# 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_CkHttpResponse $resp
delete_CkJsonObject $jsonResp