# Go SDKクイックスタート

Go SDK をインストールし、Google Search リクエストの型を実行します。 その後、同じクライアントでYouTubeデータを試してみましょう。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/flashdata-go
レビュー: FlashData による 2026-11-04

- [GitHub](https://github.com/flashdatadev/flashdata-go) — ソースと SDK リファレンス
- [API キーを取得する](https://flashdata.dev/app/api-keys) — コンソールでキーを作成する

<a id="application"></a>

## Go リクエストを初めて作成

SDKをインストールし、APIキーを設定し、以下の例を実行します。

- [Go SDK メソッドリファレンス](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="install"></a>

### SDKをインストール

Go 1.25+を要求して下さい。 既存のgo.modを含むディレクトリに新しいプロジェクトまたはインストールします。

#### 新規プロジェクト

##### インストール

```bash
mkdir flashdata-demo
cd flashdata-demo
go mod init example.com/flashdata-demo
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


#### 既存のモジュール

##### インストール

```bash
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


- [Goをインストールする](https://go.dev/doc/install)
- [SDKリリース](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

<a id="authentication"></a>

### 認証

サインアップし、メールを検証し、Google Search 権限で API キーを作成したり、認証されたキーを再使用したりします。

下記のFLASHDATA_API_KEYを設定、または、既に環境で提供される値を保持します。 .env ファイルが読み込まれていない。

#### Bash

##### 隠しキープロンプト・Bash

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### 隠しキープロンプト・PowerShell

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [新規登録](https://flashdata.dev/signup)
- [APIキーを作成する](https://flashdata.dev/app/api-keys)
- [クレジットの確認](https://flashdata.dev/app/billing)
- [エージェント認証](https://flashdata.dev/auth.md)

<a id="query"></a>

### 検索を実行

go.modの横にあるmain.goとしてこれを保存し、同じターミナルで実行します。 JSON 応答を最大5つの結果を検索し、印刷します。

#### main.go

```go
package main

import (
    "context"
    "encoding/json"
    "log"
    "os"
    "time"

    flashdata "github.com/flashdatadev/flashdata-go"
)

func main() {
    key := os.Getenv("FLASHDATA_API_KEY")
    if key == "" {
        log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.")
    }
    client, err := flashdata.New(flashdata.Options{APIKey: key})
    if err != nil {
        log.Fatal(err)
    }
    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
    defer cancel()
    result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{
        Query: "battery recycling research",
        Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))},
    })
    if err != nil {
        // Do not automatically resubmit an uncertain paid request.
        log.Fatal(err)
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil {
        log.Fatal(err)
    }
    if result.Status != "done" {
        log.Fatalf("Search did not complete: %s", result.Status)
    }
}
```

#### 実行

```bash
go run .
```


<a id="result"></a>

### 結果を確認

プリントされたJSONでstatus: doneを探します。 アプリケーションやエージェントで返されたタイトル、URLs、スニペットを使用してください。 空のオーガニックリストも有効な結果です。

| フィールド | 意味する |
| --- | --- |
| status | 完了すると、検索が完了します。 |
| results[].organic[] | タイトル、リンク、スニペットのフィールドで結果を検索します。 |
| usage.credits | このリクエストで使われるクレジット。 5つの結果は、1つの検索ではなく、5つのリクエストです。 |

#### 出力例

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```


<a id="common-tasks"></a>

## 別のデータソースを試す

main.go では、結果だけを置き換え、err := client.Google.Search(...) は、これらの呼び出しの1つを呼び出します。 クライアント、コンテキスト、エラーチェック、JSON出力をキープし、実行します。 再び実行します。 各実行は、新しいリクエストを 1 つ提出します。

### Googleニュース

google_newsの許可が必要です。 クエリのニュース結果を返します。

#### main.goの検索コールを置き換える

```go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})
```


### YouTubeメタデータ

youtube_metadataの許可が必要です。 タイトル、チャンネル、期間などの動画情報を返します。動画はダウンロードできません。

#### main.goの検索コールを置き換える

```go
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
    VideoID: "dQw4w9WgXcQ",
})
```


### YouTubeトランスクリプト

youtube_transcriptの許可が必要です。 自動トラックを含む既存の英語のトランスクリプトを要求します。 そのトラックが利用可能になったら、テキストとタイムスタンプを返します。

#### main.goの検索コールを置き換える

```go
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
    VideoID: "dQw4w9WgXcQ",
    Params: &flashdata.YouTubeTranscriptParams{
        Language: flashdata.Ptr("en"),
        Auto: flashdata.Ptr(true),
    },
})
```


- [すべてのソースパラメータ](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

<a id="features"></a>

## Go SDKサポートとは

| 利用条件 | SDKエントリーポイント |
| --- | --- |
| Google | 検索、ニュース、画像、ショッピング、ビデオ、場所。 Google.Pages は、ペジネーションされた結果に使用します。 |
| YouTube | 検索、メタデータ、トランスクリプト、キャプション、チャンネル、提案は構造化されたビデオデータを提供します。 |
| YouTube.Download | クラウドストレージにオーディオまたはビデオ配信ジョブを送信します。 youtube_download の許可と保存設定が必要です。以下に完全な例を使用してください。 |
| Jobs / Bulk | Asyncヘルパーで送信し、ジョブIDを保存し、Jobs.WaitとJobs.Resultを使用します。 Bulkは、より大きなデータセットと再開可能なジョブを処理します。 |
| Account | 未就労前に、身元確認、残高管理、価格設定、制限、利用状況をお読みください。 同じクライアントと認証されたキーを再利用します。 |
| WithFormat | JSON、文文、Markdownを明示的なフォーマットオプションでリクエストします。 Markdown フォーマットは、エージェントのデータを取得しました。アプリケーションは、モデルの呼び出しや要約を提供します。 |

- [完全なGoのダウンロードの例](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [ダウンロードストレージの設定](https://flashdata.dev/ja/docs/guides/youtube-download-guide/reference.md)
- [Go応答フォーマット](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

<a id="types"></a>

## Goタイプ

GoogleSearchInput はクエリを記述します。 オプションのパラメータは、flashdata.Ptr(int64(5)などのポインタを使用します。 結果は、タイプされたフィールドを必要とするときに、ソースコード結果[GoogleSearchPayload]を使用するソースJSONが含まれています。

- [型結果の保存とデコード](https://flashdata.dev/ja/docs/guides/sdk-operations/reference.md#save)

<a id="next"></a>

## 次のステップ

- [口座のチェックと保存結果](https://flashdata.dev/ja/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/ja/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/ja/docs/guides/youtube-download-guide/reference.md)
- [SDKメソッド参照](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="recover"></a>

## ステップが失敗した場合

| 問題の問題 | フィックス |
| --- | --- |
| パッケージまたはランタイムの欠落 | バージョンを確認し、 go.mod を含むディレクトリで実行します。 |
| 401 / FLASHDATA_API_KEY | 実行する端末で有効なキーを設定します。 |
| 403 | このAPIキーでGoogle Searchを有効にします。 |
| 402 | Billingは、利用可能なクレジット、または排出されたエージェントのトライアルを要求するかどうかをチェックします。 |
| 429 | Retry-Afterを待ってから、リクエスト率を削減します。 |
| タイムアウトまたはサーバーエラー | History を再送する前にチェックします。最初のリクエストは既に実行されている可能性があります。 |

- [リクエスト履歴](https://flashdata.dev/app/jobs)
- [Billingの特長](https://flashdata.dev/app/billing)
