Step by Step Guide to Building a GoToMeeting API Integration in Go

Aug 7, 2024 • 6 minute read

Introduction

Hey there, fellow Go enthusiast! Ready to dive into the world of GoToMeeting API integration? You're in for a treat. We'll be walking through the process of building a robust integration that'll have you scheduling meetings like a pro in no time. Let's get cracking!

Prerequisites

Before we jump in, make sure you've got:

Go installed (I know, obvious, right?)
Your GoToMeeting API credentials (if you don't have these, hop over to their developer portal)
A cup of coffee (optional, but highly recommended)

Setting up the project

First things first, let's get our project set up:

mkdir gotomeeting-integration
cd gotomeeting-integration
go mod init gotomeeting-integration

Now, let's grab the packages we'll need:

go get github.com/go-resty/resty/v2
go get golang.org/x/oauth2

Authentication

Alright, time to get our hands dirty with some OAuth 2.0 goodness:

import (
    "golang.org/x/oauth2"
)

func getToken() (*oauth2.Token, error) {
    config := &oauth2.Config{
        ClientID:     "YOUR_CLIENT_ID",
        ClientSecret: "YOUR_CLIENT_SECRET",
        Endpoint: oauth2.Endpoint{
            TokenURL: "https://api.getgo.com/oauth/v2/token",
        },
    }

    token, err := config.PasswordCredentialsToken(context.Background(), "YOUR_USERNAME", "YOUR_PASSWORD")
    if err != nil {
        return nil, err
    }

    return token, nil
}

Basic API Requests

Now that we're authenticated, let's make a simple GET request:

import (
    "github.com/go-resty/resty/v2"
)

func getMeetings(token string) ([]byte, error) {
    client := resty.New()
    resp, err := client.R().
        SetAuthToken(token).
        Get("https://api.getgo.com/G2M/rest/meetings")
    
    if err != nil {
        return nil, err
    }

    return resp.Body(), nil
}

Core Functionalities

Let's create a meeting, shall we?

func createMeeting(token string, subject string, startTime time.Time) (int, error) {
    client := resty.New()
    resp, err := client.R().
        SetAuthToken(token).
        SetBody(map[string]interface{}{
            "subject": subject,
            "starttime": startTime.Format(time.RFC3339),
        }).
        Post("https://api.getgo.com/G2M/rest/meetings")
    
    if err != nil {
        return 0, err
    }

    var result map[string]interface{}
    json.Unmarshal(resp.Body(), &result)

    return int(result["meetingId"].(float64)), nil
}

Advanced Features

Want to add some attendees? No problem:

func addAttendees(token string, meetingId int, attendees []string) error {
    client := resty.New()
    _, err := client.R().
        SetAuthToken(token).
        SetBody(map[string]interface{}{
            "attendees": attendees,
        }).
        Post(fmt.Sprintf("https://api.getgo.com/G2M/rest/meetings/%d/attendees", meetingId))
    
    return err
}

Error Handling and Logging

Don't forget to handle those pesky errors:

import (
    "log"
)

func handleAPIError(err error) {
    if err != nil {
        log.Printf("API Error: %v", err)
        // Handle the error appropriately
    }
}

Testing

Testing is crucial, folks. Here's a quick example:

func TestCreateMeeting(t *testing.T) {
    token, _ := getToken()
    meetingId, err := createMeeting(token.AccessToken, "Test Meeting", time.Now().Add(time.Hour))
    
    if err != nil {
        t.Errorf("Failed to create meeting: %v", err)
    }

    if meetingId == 0 {
        t.Error("Expected non-zero meeting ID")
    }
}

Best Practices

Remember to implement rate limiting to avoid hitting API limits:

import (
    "golang.org/x/time/rate"
)

var limiter = rate.NewLimiter(rate.Every(time.Second), 5)

func makeAPICall() {
    if err := limiter.Wait(context.Background()); err != nil {
        // Handle error
    }
    // Make your API call here
}

Conclusion

And there you have it! You've just built a solid foundation for your GoToMeeting API integration. Remember, this is just the beginning. There's a whole world of features waiting for you to explore and implement.

Keep coding, keep learning, and most importantly, keep having fun with Go!

Resources

Now go forth and conquer those virtual meetings!