Last Updated: 6/15/2022, 1:51:10 AM

# Golang SDK Getting Started Guide

# Overview

You can use the AccelByte Golang SDK to implement our backend services within your game. The SDK acts as a bridge between your game and our services. Follow the tutorials below to learn how to set up our Golang SDK.

# Prerequisites

Create a Game Namespace if you don’t have one yet. Be sure to keep the namespace’s Namespace ID as you will need it later
Create an OAuth Client with a Confidential client type. Keep the Client ID and the Client Secret somewhere safe as you will be using them in this tutorial
Download the AccelByte Golang SDK (opens new window).

# Additional Resources

Download the Sample App for the AccelByte Golang SDK (opens new window).
Refer to AccelByte Python Golang Index (opens new window) to find information about the included services’ wrappers.

# Tutorials

# Install the AccelByte Golang SDK

To install the AccelByte Golang SDK into your project directory, follow these steps:

Import the AccelByte Golang SDK (opens new window) into the go.mod file directly from the GitHub repository by running the following command in the terminal. Make sure to use the latest version of our Golang SDK.
```
go get github.com/AccelByte/accelbyte-go-sdk
```
Then run this command in the Terminal.
```
$ go mod tidy
```

Open the go.mod file and it will look like this.

module aws-lambda-functions

go 1.16

require (
  github.com/AccelByte/accelbyte-go-sdk latest
)

# Log in as a Client using the SDK

To log in as the client you created earlier, follow these steps:

Create empty structs for TokenRepositoryImpl and ConfigRepositoryImpl that will be used for the following actions:

The TokenRepositoryImpl struct is used to store, get, and remove tokens.

type TokenRepositoryImpl struct {}

func (t *TokenRepositoryImpl) Store(accessToken iamclientmodels.OauthmodelTokenResponseV3) error {
  clientTokenV3 = accessToken
  return nil
}

func (t *TokenRepositoryImpl) GetToken() (*iamclientmodels.OauthmodelTokenResponseV3, error) {
  return &clientTokenV3, nil
}

func (t *TokenRepositoryImpl) RemoveToken() error {
  return nil
}

The TokenRepositoryImpl struct to get the Client ID and Client Secret.

type ConfigRepositoryImpl struct {}


func (c *ConfigRepositoryImpl) GetClientId() string {
  return os.Getenv("APP_CLIENT_ID")
}

func (c *ConfigRepositoryImpl) GetClientSecret() string {
  return os.Getenv("APP_CLIENT_SECRET")
}

func (c *ConfigRepositoryImpl) GetJusticeBaseUrl() string {
  return os.Getenv("ACCELBYTE_BASE_URL")
}

Initialize the service SDK.

oauthService := service.OauthService{
  IamService:       factory.NewIamClient(&repository.ConfigRepositoryImpl{}),
  ConfigRepository: &repository.ConfigRepositoryImpl{},
  TokenRepository:  &repository.TokenRepositoryImpl{},
}

Call the GrantTokenCredentials wrapper.

err := oauthService.GrantTokenCredentials("", "")
if err != nil {
  return err
}

return nil

This wrapper provides a straightforward way to retrieve client credentials.

param := &o_auth2_0.TokenGrantV3Params{
  Code:         &code,
  CodeVerifier: &codeVerifier,
  GrantType:    "client_credentials",
}

accessToken, _, _, _, err :=
  oauthService.IamService.OAuth20.TokenGrantV3(param, client.BasicAuth(clientId, clientSecret))
if err != nil {
  return err
}

return nil

# Import AccelByte Services

Now you’re ready to integrate any of the following AccelByte services into your application. All services have already been imported in .../pkg/service.<your-service> will be changed to the service name you want to use automatically during the import.

# SDK Examples

See our Golang SDK example repo (opens new window) for a selection of test cases you can use to customize your game.

IAM

Access

Analytics

Distribution

Engagement

Social

Monetization

Storage

Play