コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

はじめに

Go SDKクイックスタート

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

  1. SDKをインストール

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

    インストール
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. 認証

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

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

    隠しキープロンプト・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
  3. 検索を実行

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

    main.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)
        }
    }
    実行
    go run .
  4. 結果を確認

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

    出力例
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    完了すると、検索が完了します。
    results[].organic[]
    タイトル、リンク、スニペットのフィールドで結果を検索します。
    usage.credits
    このリクエストで使われるクレジット。 5つの結果は、1つの検索ではなく、5つのリクエストです。

別のデータソースを試す

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

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

main.goの検索コールを置き換える
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Go SDKサポートとは

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

Goタイプ

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

次のステップ

ステップが失敗した場合

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