Outlook Calendar: Read a Shared or Delegated Calendar
See more Outlook Calendar Examples
Read the next seven days directly from a calendar owner's default calendar while signed in as its share recipient or delegate. The owner must already have granted the necessary calendar rights. Before running, authorize the application with offline_access https://graph.microsoft.com/Calendars.Read.Shared (or Calendars.ReadWrite.Shared for writes) and save that token in the normal calendar cache. Adding an OAuth scope does not itself create mailbox sharing rights.
Replace owner@example.com with the owner's UPN or object ID. Event IDs returned by this path belong to the owner's mailbox context; do not send them to the recipient's /me/events path. This is delegated sharing access, separate from administrator-granted application access. For a shared secondary calendar, select its ID in the same owner context and use /users/{owner}/calendars/{id}/calendarView.
Follow the complete @odata.nextLink, retain the same Prefer header on every page, and treat IDs as case-sensitive strings. The example checks the Graph host and repeated links, and has a 100-page demonstration limit. Save a continuation URL privately if a larger scan must resume.
Delegated permission: Calendars.Read.Shared.
The original authorization example requests own-calendar access. For this example, change its requested scope and obtain consent for shared-calendar access before using the resulting token. No webhook receiver is required.
HTTP methods can return false for an HTTP error as well as a connection failure. The code distinguishes those cases and checks the expected status before reading JSON. For 401, refresh the access token or authorize again; for 403, check permissions, mailbox access, and tenant policy. For 429, honor Retry-After before a bounded retry. Do not automatically repeat a write after an uncertain outcome. Keep detailed errors and calendar data private.
Chilkat PowerBuilder Downloads
integer li_rc
long li_Success
oleobject loo_Token
oleobject loo_Http
oleobject loo_Resp
oleobject loo_Result
string ls_Owner
oleobject loo_WindowTime
string ls_WindowStart
string ls_WindowEnd
oleobject loo_Endpoint
string ls_Url
oleobject loo_NextLink
oleobject loo_SeenLinks
long li_PageCount
long i
long li_NextType
li_Success = 0
// Assumes Chilkat is unlocked. See Global Unlock Sample.
li_Success = 0
// Obtain a delegated Microsoft Graph token using the calendar authorization example.
// See Authorize Outlook Calendar with OAuth2 and PKCE.
loo_Token = create oleobject
li_rc = loo_Token.ConnectToNewObject("Chilkat.JsonObject")
if li_rc < 0 then
destroy loo_Token
MessageBox("Error","Connecting to COM object failed")
return
end if
loo_Token.Strict = 1
li_Success = loo_Token.LoadFile("qa_data/tokens/outlookCalendar.json")
if li_Success <> 1 then
Write-Debug "Could not read the private calendar token cache."
destroy loo_Token
return
end if
if (loo_Token.JsonTypeOf("access_token") <> 1) OR (loo_Token.StringOfEquals("access_token","",1) = 1) then
Write-Debug "Expected a nonempty access_token in the JSON."
destroy loo_Token
return
end if
loo_Http = create oleobject
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
loo_Http.AuthToken = loo_Token.StringOf("access_token")
loo_Http.RequireSslCertVerify = 1
loo_Http.FollowRedirects = 0
loo_Http.ConnectTimeout = 20
loo_Http.ReadTimeout = 30
loo_Http.SetRequestHeader("Accept","application/json")
loo_Resp = create oleobject
li_rc = loo_Resp.ConnectToNewObject("Chilkat.HttpResponse")
loo_Result = create oleobject
li_rc = loo_Result.ConnectToNewObject("Chilkat.JsonObject")
loo_Result.Strict = 1
loo_Http.SetRequestHeader("Prefer","outlook.timezone=~"UTC~", IdType=~"ImmutableId~"")
ls_Owner = "owner@example.com"
loo_WindowTime = create oleobject
li_rc = loo_WindowTime.ConnectToNewObject("Chilkat.CkDateTime")
li_Success = loo_WindowTime.SetFromCurrentSystemTime()
if li_Success <> 1 then
Write-Debug "Could not get the current time."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
return
end if
ls_WindowStart = loo_WindowTime.GetAsTimestamp(0)
li_Success = loo_WindowTime.AddDays(7)
if li_Success <> 1 then
Write-Debug "Could not calculate the window end."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
return
end if
ls_WindowEnd = loo_WindowTime.GetAsTimestamp(0)
loo_Endpoint = create oleobject
li_rc = loo_Endpoint.ConnectToNewObject("Chilkat.StringBuilder")
loo_Endpoint.Append("https://graph.microsoft.com/v1.0/users/")
loo_Endpoint.Append(loo_Http.UrlEncode(ls_Owner))
loo_Endpoint.Append("/calendar/calendarView?startDateTime=")
loo_Endpoint.Append(loo_Http.UrlEncode(ls_WindowStart))
loo_Endpoint.Append("&endDateTime=")
loo_Endpoint.Append(loo_Http.UrlEncode(ls_WindowEnd))
loo_Endpoint.Append("&$select=id,subject,start,end,type&$top=50")
ls_Url = loo_Endpoint.GetAsString()
loo_NextLink = create oleobject
li_rc = loo_NextLink.ConnectToNewObject("Chilkat.StringBuilder")
loo_SeenLinks = create oleobject
li_rc = loo_SeenLinks.ConnectToNewObject("Chilkat.StringArray")
li_PageCount = 0
do while (li_PageCount < 100)
// Use Microsoft's nextLink exactly as returned; do not rebuild skip tokens.
loo_NextLink.Clear()
loo_NextLink.Append(ls_Url)
if loo_NextLink.StartsWith("https://graph.microsoft.com/v1.0/",1) <> 1 then
Write-Debug "Unexpected pagination host or API version; no request sent."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
if loo_SeenLinks.Find(ls_Url,0) >= 0 then
Write-Debug "Repeated pagination URL; stopping."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
loo_SeenLinks.Append(ls_Url)
li_Success = loo_Http.HttpNoBody("GET",ls_Url,loo_Resp)
// A false result can still include an HTTP error response.
if (li_Success <> 1) AND (loo_Resp.StatusCode = 0) then
Write-Debug "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
if loo_Resp.StatusCode <> 200 then
Write-Debug "Unexpected HTTP status: " + string(loo_Resp.StatusCode)
Write-Debug "Request ID: " + loo_Resp.GetHeaderField("request-id")
if loo_Resp.StatusCode = 429 then
Write-Debug "Retry-After: " + loo_Resp.GetHeaderField("Retry-After")
end if
if loo_Resp.StatusCode = 401 then
Write-Debug "Refresh the Graph access token or authorize again."
end if
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
li_Success = loo_Result.Load(loo_Resp.BodyStr)
if li_Success <> 1 then
Write-Debug "Expected a well-formed JSON response."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
if loo_Result.JsonTypeOf("value") <> 4 then
Write-Debug "Expected a value array."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
i = 0
do while (i < loo_Result.SizeOfArray("value"))
loo_Result.I = i
if (loo_Result.JsonTypeOf("value[i].id") <> 1) OR (loo_Result.StringOfEquals("value[i].id","",1) = 1) then
Write-Debug "Expected a nonempty value[i].id in the JSON."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
Write-Debug "Event ID: " + loo_Result.StringOf("value[i].id")
Write-Debug "Subject: " + loo_Result.StringOf("value[i].subject")
Write-Debug "Start: " + loo_Result.StringOf("value[i].start.dateTime") + " (" + loo_Result.StringOf("value[i].start.timeZone") + ")"
Write-Debug "End: " + loo_Result.StringOf("value[i].end.dateTime")
Write-Debug "Type: " + loo_Result.StringOf("value[i].type")
i = i + 1
loop
li_PageCount = li_PageCount + 1
// Quote the member name because @odata.nextLink contains a literal period.
li_NextType = loo_Result.JsonTypeOf("~"@odata.nextLink~"")
if (li_NextType = -1) OR (li_NextType = 6) then
Write-Debug "Completed pages: " + string(li_PageCount)
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
if (li_NextType <> 1) OR (loo_Result.StringOfEquals("~"@odata.nextLink~"","",1) = 1) then
Write-Debug "Invalid continuation link; cannot establish completeness."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks
return
end if
ls_Url = loo_Result.StringOf("~"@odata.nextLink~"")
loop
Write-Debug "Stopped at the example's 100-page limit. Save the continuation URL privately to resume."
destroy loo_Token
destroy loo_Http
destroy loo_Resp
destroy loo_Result
destroy loo_WindowTime
destroy loo_Endpoint
destroy loo_NextLink
destroy loo_SeenLinks