Go Modular Extend SDK の使用を開始する

Last updated on July 14, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Extend SDK は、開発者がバックエンドコードや CI/CD パイプラインなどの他の自動化処理の中から AccelByte Gaming Services (AGS) エンドポイントを呼び出せるように提供されています。Extend SDK は AGS の OpenAPI 仕様から生成され、ログイン、トークンの更新、トークンの検証、HTTP リクエストの再試行などの必要な機能を提供します。使いやすいため、開発者はエンドポイントの呼び出し方法を考えることに時間を費やすことなく、実現したいことに集中できます。

AccelByte Modular Extend SDK は、選択された複数のプログラミング言語で利用できます。ここでは、Go Modular Extend SDK を使った基本的な使い方を説明します。

目標

このガイドでは、以下の方法を説明します。

Go アプリケーションプロジェクトを作成する。
Go Modular Extend SDK をプロジェクトの依存関係として追加する。
Go Modular Extend SDK を使用して AGS エンドポイントを呼び出す。
アプリケーションを実行する。

前提条件

このガイドのタスクを実行するには、以下が必要です。

Go 1.18 以降がインストールされていること。
AGS デモ環境へのアクセス権を取得していること。
- AB_BASE_URL 環境変数には https://prod.gamingservices.accelbyte.io を使用します。
- OAuth クライアントの作成ガイドの手順に従い、Confidential クライアントタイプを使用します。Client ID と Client Secret を、それぞれ AB_CLIENT_ID と AB_CLIENT_SECRET 環境変数として使用します。

Go アプリケーションの作成と実行

Go アプリケーションプロジェクトを作成する。

フォルダーを作成し、go mod init を使用して新しい Go アプリケーションプロジェクトを作成します。
```
mkdir getting-started
cd getting-started/
go mod init golang-application
```
Go Modular Extend SDK をプロジェクトの依存関係として追加する。

このガイドでは IAM サービスのみを使用するため、以下のコマンドを使用して IAM Service Module のみをプロジェクトにインストールします。
```
go get github.com/AccelByte/accelbyte-go-modular-sdk/iam-sdk
```
備考
他の AccelByte サービスの利用に興味がある場合は、利用可能な Go モジュールの包括的なリストをこちらでご覧ください。

Go Modular Extend SDK を使用して AGS エンドポイントを呼び出す。

Go Extend SDK を使用して AGS エンドポイントを呼び出すには、Go Extend SDK インスタンスを作成する必要があります。OAuth クライアントの認証情報でログインし、AGS エンドポイント GetCountryLocationV3 を呼び出します。これを行うには、以下の内容で新しい main.go ファイルを作成します。

package main

import (
   "fmt"

   iam "github.com/AccelByte/accelbyte-go-modular-sdk/iam-sdk/pkg"
   "github.com/AccelByte/accelbyte-go-modular-sdk/iam-sdk/pkg/iamclient/o_auth2_0_extension"
   "github.com/AccelByte/accelbyte-go-modular-sdk/services-api/pkg/utils/auth"
)

var (
   // use the default config and token implementation
   configRepo = *auth.DefaultConfigRepositoryImpl()
   tokenRepo  = *auth.DefaultTokenRepositoryImpl()
)

func main() {
   // prepare the IAM Oauth service
   oauth := &iam.OAuth20Service{
      Client:           iam.NewIamClient(&configRepo),
      ConfigRepository: &configRepo,
      TokenRepository:  &tokenRepo,
   }
   clientId := oauth.ConfigRepository.GetClientId()
   clientSecret := oauth.ConfigRepository.GetClientSecret()

   // call the endpoint tokenGrantV3Short through the wrapper 'LoginClient'
   err := oauth.LoginClient(&clientId, &clientSecret)
   if err != nil {
      fmt.Println("failed login client")
   } else {
      fmt.Println("successful login")
   }

   // get the token
   token, _ := oauth.TokenRepository.GetToken()
   fmt.Printf("print %v\n", *token.AccessToken)

   // prepare the IAM's Oauth 2.0 Extension service
   oAuth20ExtensionService := &iam.OAuth20ExtensionService{
      Client:          iam.NewIamClient(&configRepo),
      TokenRepository: &tokenRepo,
   }
   input := &o_auth2_0_extension.GetCountryLocationV3Params{}

   // call an AccelByte Gaming Services API e.g. GetCountryLocationV3
   ok, errLoc := oAuth20ExtensionService.GetCountryLocationV3Short(input)
   if errLoc != nil {
      fmt.Println(errLoc.Error())
   } else {
      fmt.Printf("Country name: %s\n", *ok.CountryName)
   }
}

ConfigRepositoryImpl は、AB_BASE_URL、AB_CLIENT_ID、AB_CLIENT_SECRET 環境変数から値を取得します。

アプリケーションを実行する。

必要な環境変数を設定し、go run main.go を使用してアプリケーションを実行します。

$ export AB_BASE_URL="<your environment's domain URL>"         # AccelByte Cloud Base URL e.g. demo environment
$ export AB_CLIENT_ID="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"       # Put AccelByte Cloud OAuth Client ID
$ export AB_CLIENT_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"   # Put AccelByte Cloud OAuth Client Secret
$ go run main.go   

次のステップ

次のステップとして、Go Modular Extend SDK をプロジェクトの依存関係として追加し、自身のプロジェクトで使用することを検討してください。

リソース

Go Modular Extend SDK のより高度な使用方法については、AccelByte Go Modular SDK ガイドを参照してください。
Go Modular Extend SDK を使用した一般的なユースケースの例については、一般的なユースケースのリストを参照してください。
呼び出す必要のある AGS エンドポイントがわかっていて、それを Go Modular Extend SDK を使用して呼び出したい場合は、オペレーションドキュメントを参照してください。

概要​

目標​

前提条件​

Go アプリケーションの作成と実行​

次のステップ​

リソース​

概要

目標

前提条件

Go アプリケーションの作成と実行

次のステップ

リソース