ドキュメントを探す
はじめに
Go SDK をインストールし、Google Search リクエストの型を実行します。 その後、同じクライアントでYouTubeデータを試してみましょう。
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]インストールgo get github.com/flashdatadev/[email protected]認証
サインアップし、メールを検証し、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隠しキープロンプト・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検索を実行
go.modの横にあるmain.goとしてこれを保存し、同じターミナルで実行します。 JSON 応答を最大5つの結果を検索し、印刷します。
main.gopackage 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 .結果を確認
プリントされた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の許可が必要です。 クエリのニュース結果を返します。
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})youtube_metadataの許可が必要です。 タイトル、チャンネル、期間などの動画情報を返します。動画はダウンロードできません。
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})youtube_transcriptの許可が必要です。 自動トラックを含む既存の英語のトランスクリプトを要求します。 そのトラックが利用可能になったら、テキストとタイムスタンプを返します。
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})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 を再送する前にチェックします。最初のリクエストは既に実行されている可能性があります。