Dokumentation durchsuchen
Erste Schritte
Installieren Sie die Go SDK und führen Sie eine eingegebene Google Search-Anforderung aus. Versuchen Sie dann YouTube-Daten mit dem gleichen Client.
Installieren Sie den SDK
Erfordert Go 1.25+. Wählen Sie ein neues Projekt aus oder installieren Sie es im Verzeichnis mit Ihrem vorhandenen go.mod.
Installierenmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Installierengo get github.com/flashdatadev/[email protected]Authentifizierend
Melden Sie sich an, überprüfen Sie Ihre E-Mail und erstellen Sie einen API-Schlüssel mit der Google Search-Berechtigung oder verwenden Sie einen autorisierten Schlüssel erneut.
Legen Sie unten FLASHDATA_API_KEY fest oder behalten Sie den bereits von Ihrer Umgebung gelieferten Wert bei. Das Beispiel liest es explizit; .env Dateien werden nicht geladen.
Versteckte Tastenaufforderung · 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_KEYVersteckte Tastenaufforderung · 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 flashdataSecureKeySuche ausführen
Speichern Sie dies als main.go neben go.mod und führen Sie es dann im selben Terminal aus. Es sendet eine Suche nach bis zu fünf Ergebnissen und druckt die JSON-Antwort.
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) } }Ausführengo run .Ergebnis prüfen
Suchen Sie nach status: done im gedruckten JSON. Verwenden Sie die zurückgegebenen Titel, URLs und Snippets in Ihrer Anwendung oder Ihrem Agenten. Eine leere organische Liste ist ebenfalls ein gültiges Ergebnis.
Beispielausgabe{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- getan bedeutet, dass die Suche abgeschlossen ist.
results[].organic[]- Suchergebnisse mit Titel, Link und Snippetfeldern.
usage.credits- Credits, die von diesem antrag verwendet werden. Fünf Ergebnisse sind eine Suche, nicht fünf Anfragen.
Probieren Sie eine andere Datenquelle
Ersetzen Sie in main.go nur das Ergebnis, err := client.Google.Search(...) mit einem dieser Aufrufe. Behalten Sie den Client, den Kontext, die Fehlerprüfungen und die JSON-Ausgabe, und führen Sie dann Go Run. Jeder Run sendet eine neue Anfrage.
Erfordert google_news Berechtigung. Gibt News-Ergebnisse für Ihre Abfrage zurück.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Erfordert youtube_metadata Berechtigung. Gibt Videodetails wie Titel, Kanal und Dauer zurück; das Video wird nicht heruntergeladen.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Erfordert youtube_transcript Berechtigung. Fordert ein vorhandenes englisches Transkript an, einschließlich automatischer Tracks. Gibt Text und Zeitstempel zurück, wenn dieser Track verfügbar ist.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Was das Go SDK unterstützt
Google- Suche, Nachrichten, Bilder, Einkaufen, Videos und Orte. Verwenden Sie Google.Pages für Paginierte Ergebnisse.
YouTube- Search, Metadata, Transcript, Captions, Channel und Suggestions liefern strukturierte Videodaten.
YouTube.Download- Senden Sie einen Audio- oder Video-Lieferauftrag an Ihren Cloud-Speicher. Erfordert youtube_download-Berechtigung und Speicherkonfiguration; verwenden Sie das vollständige Beispiel unten.
Jobs / Bulk- Senden Sie mit einem Async-Helfer, speichern Sie den Job ID und verwenden Sie dann Jobs.Wait und Jobs.Result. Bulk verarbeitet größere Datensätze und resumable Jobs.
Account- Lesen Sie Identität, Balance, Preise, Limits und Nutzung vor unbeaufsichtigter Arbeit. Verwenden Sie denselben Client und autorisierten Schlüssel erneut.
WithFormat- Fordern Sie JSON, Klartext oder Markdown mit expliziten Formatoptionen an. Markdown formatiert abgerufene Daten für Ihren Agenten; Ihre Anwendung liefert Modellaufrufe oder Zusammenfassungen.
Go-Typen
GoogleSearchInput beschreibt die Abfrage. Optionale Parameter verwenden Zeiger wie flashdata.Ptr(int64(5)). Die Ergebnisse enthalten die Quelle JSON; verwenden Sie DecodeResults[GoogleSearchPayload], wenn Sie eingegebene Felder benötigen.
Nächste Schritte
Wenn ein Schritt fehlschlägt
- Paket oder Laufzeit fehlt
- Überprüfen Sie die Go-Version und führen Sie Go Get im Verzeichnis mit go.mod aus.
- 401 / FLASHDATA_API_KEY
- Legen Sie einen gültigen Schlüssel in dem Terminal fest, in dem Sie das Beispiel ausführen.
- 403
- Aktivieren Sie Google Search für diesen API Schlüssel.
- 402
- Überprüfen Sie Billing auf verfügbare Credits oder fordern Sie eine erschöpfte Agentenstudie an.
- 429
- Warten Sie auf Retry-After und reduzieren Sie dann Ihre Anfragerate.
- Timeout oder Serverfehler
- Überprüfen Sie History vor dem erneuten Senden; die erste Anforderung wurde möglicherweise bereits ausgeführt.