Sample code for 30+ languages & platforms
Go Requires Chilkat v11.6.0+

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.

Microsoft documentation

Chilkat Go Downloads

Go
    success := false

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false
    //  Obtain a delegated Microsoft Graph token using the calendar authorization example.
    //  See Authorize Outlook Calendar with OAuth2 and PKCE.
    token := chilkat.NewJsonObject()
    token.SetStrict(true)
    success = token.LoadFile("qa_data/tokens/outlookCalendar.json")
    if success != true {
        fmt.Println("Could not read the private calendar token cache.")
        token.DisposeJsonObject()
        return
    }

    if (token.JsonTypeOf("access_token") != 1) || (token.StringOfEquals("access_token","",true) == true) {
        fmt.Println("Expected a nonempty access_token in the JSON.")
        token.DisposeJsonObject()
        return
    }

    http := chilkat.NewHttp()
    http.SetAuthToken(token.StringOf("access_token"))
    http.SetRequireSslCertVerify(true)
    http.SetFollowRedirects(false)
    http.SetConnectTimeout(20)
    http.SetReadTimeout(30)
    http.SetRequestHeader("Accept","application/json")
    resp := chilkat.NewHttpResponse()
    result := chilkat.NewJsonObject()
    result.SetStrict(true)
    http.SetRequestHeader("Prefer","outlook.timezone=\"UTC\", IdType=\"ImmutableId\"")
    owner := "owner@example.com"
    windowTime := chilkat.NewCkDateTime()
    success = windowTime.SetFromCurrentSystemTime()
    if success != true {
        fmt.Println("Could not get the current time.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        windowTime.DisposeCkDateTime()
        return
    }

    windowStart := windowTime.GetAsTimestamp(false)
    success = windowTime.AddDays(7)
    if success != true {
        fmt.Println("Could not calculate the window end.")
        token.DisposeJsonObject()
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        result.DisposeJsonObject()
        windowTime.DisposeCkDateTime()
        return
    }

    windowEnd := windowTime.GetAsTimestamp(false)
    endpoint := chilkat.NewStringBuilder()
    endpoint.Append("https://graph.microsoft.com/v1.0/users/")
    endpoint.Append(*http.UrlEncode(owner))
    endpoint.Append("/calendar/calendarView?startDateTime=")
    endpoint.Append(*http.UrlEncode(*windowStart))
    endpoint.Append("&endDateTime=")
    endpoint.Append(*http.UrlEncode(*windowEnd))
    endpoint.Append("&$select=id,subject,start,end,type&$top=50")
    url := endpoint.GetAsString()
    nextLink := chilkat.NewStringBuilder()
    seenLinks := chilkat.NewStringArray()
    pageCount := 0
    for (pageCount < 100) {
        //  Use Microsoft's nextLink exactly as returned; do not rebuild skip tokens.
        nextLink.Clear()
        nextLink.Append(*url)
        if nextLink.StartsWith("https://graph.microsoft.com/v1.0/",true) != true {
            fmt.Println("Unexpected pagination host or API version; no request sent.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        if seenLinks.Find(*url,0) >= 0 {
            fmt.Println("Repeated pagination URL; stopping.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        seenLinks.Append(*url)
        success = http.HttpNoBody("GET",*url,resp)
        //  A false result can still include an HTTP error response.
        if (success != true) && (resp.StatusCode() == 0) {
            fmt.Println("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        if resp.StatusCode() != 200 {
            fmt.Println("Unexpected HTTP status: ", resp.StatusCode())
            fmt.Println("Request ID: ", *resp.GetHeaderField("request-id"))
            if resp.StatusCode() == 429 {
                fmt.Println("Retry-After: ", *resp.GetHeaderField("Retry-After"))
            }

            if resp.StatusCode() == 401 {
                fmt.Println("Refresh the Graph access token or authorize again.")
            }

            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        success = result.Load(resp.BodyStr())
        if success != true {
            fmt.Println("Expected a well-formed JSON response.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        if result.JsonTypeOf("value") != 4 {
            fmt.Println("Expected a value array.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        i := 0
        for (i < result.SizeOfArray("value")) {
            result.SetI(i)
            if (result.JsonTypeOf("value[i].id") != 1) || (result.StringOfEquals("value[i].id","",true) == true) {
                fmt.Println("Expected a nonempty value[i].id in the JSON.")
                token.DisposeJsonObject()
                http.DisposeHttp()
                resp.DisposeHttpResponse()
                result.DisposeJsonObject()
                windowTime.DisposeCkDateTime()
                endpoint.DisposeStringBuilder()
                nextLink.DisposeStringBuilder()
                seenLinks.DisposeStringArray()
                return
            }

            fmt.Println("Event ID: ", *result.StringOf("value[i].id"))
            fmt.Println("Subject: ", *result.StringOf("value[i].subject"))
            fmt.Println("Start: ", *result.StringOf("value[i].start.dateTime"), " (", *result.StringOf("value[i].start.timeZone"), ")")
            fmt.Println("End: ", *result.StringOf("value[i].end.dateTime"))
            fmt.Println("Type: ", *result.StringOf("value[i].type"))
            i = i + 1
        }

        pageCount = pageCount + 1
        //  Quote the member name because @odata.nextLink contains a literal period.
        nextType := result.JsonTypeOf("\"@odata.nextLink\"")
        if (nextType == -1) || (nextType == 6) {
            fmt.Println("Completed pages: ", pageCount)
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        if (nextType != 1) || (result.StringOfEquals("\"@odata.nextLink\"","",true) == true) {
            fmt.Println("Invalid continuation link; cannot establish completeness.")
            token.DisposeJsonObject()
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            result.DisposeJsonObject()
            windowTime.DisposeCkDateTime()
            endpoint.DisposeStringBuilder()
            nextLink.DisposeStringBuilder()
            seenLinks.DisposeStringArray()
            return
        }

        url = result.StringOf("\"@odata.nextLink\"")
    }

    fmt.Println("Stopped at the example's 100-page limit. Save the continuation URL privately to resume.")

    token.DisposeJsonObject()
    http.DisposeHttp()
    resp.DisposeHttpResponse()
    result.DisposeJsonObject()
    windowTime.DisposeCkDateTime()
    endpoint.DisposeStringBuilder()
    nextLink.DisposeStringBuilder()
    seenLinks.DisposeStringArray()