Documentatie bekijken
Aan de slag
Installeer de Go SDK en voer een getypte Google Search-verzoek uit. Probeer dan YouTube gegevens met dezelfde client.
Installeer de SDK
Vereist Go 1.25+. Kies een nieuw project of installeer in de map met uw bestaande go.mod.
Installerenmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Installerengo get github.com/flashdatadev/[email protected]Authenticeren
Meld je aan, verifieer je e-mail en maak een API sleutel met Google Search toestemming, of hergebruik een geautoriseerde sleutel.
Stel hieronder FLASHDATA_API_KEY in, of houd de waarde die al door uw omgeving wordt geleverd. Het voorbeeld leest het expliciet; .env-bestanden worden niet geladen.
Verborgen sleutelprompt · 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_KEYVerborgen sleutelprompt · 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 flashdataSecureKeyEen zoekopdracht uitvoeren
Sla dit op als main.go naast go.mod en voer het dan uit in dezelfde terminal. Het stuurt één zoekopdracht naar maximaal vijf resultaten en drukt de JSON respons af.
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) } }Uitvoerengo run .Het resultaat controleren
Zoek naar status: done in de afgedrukte JSON. Gebruik de geretourneerde titels, URLs en knipsels in uw toepassing of agent. Een lege organische lijst is ook een geldig resultaat.
Voorbeelduitvoer{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- gedaan betekent de zoektocht voltooid.
results[].organic[]- Zoekresultaten met titel, link en knipselvelden.
usage.credits- Dankbetuigingen die door dit verzoek worden gebruikt. Vijf resultaten zijn één zoektocht, niet vijf verzoeken.
Probeer een andere gegevensbron
In main.go, vervang alleen het resultaat, error:= client.Google.Search(...) call met een van deze oproepen. Houd de client, context, foutcontroles en JSON uitvoer, dan ga uitvoeren . opnieuw. Elke run dient één nieuw verzoek in.
Vereist google_news-permissie. Geeft nieuwsresultaten terug voor uw zoekopdracht.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Vereist youtube_metadata-permissie. Geeft videogegevens terug zoals titel, kanaal en duur; het downloadt de video niet.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Vereist youtube_transcript-permissie. Verzoekt een bestaand Engels transcript, inclusief automatische tracks. Geeft tekst en tijdstempels terug wanneer die track beschikbaar is.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Wat de Go SDK ondersteunt
Google- Zoeken, Nieuws, Afbeeldingen, Winkelen, Video's en Plaatsen. Gebruik Google.Pages voor gepagineerde resultaten.
YouTube- Zoeken, Metadata, Transcript, Bijschriften, Channel en Suggesties bieden gestructureerde videogegevens.
YouTube.Download- Stuur een audio- of videoleveringstaak naar uw cloudopslag. Vereist youtube_download toestemming en opslagconfiguratie; gebruik het volledige voorbeeld hieronder.
Jobs / Bulk- Submit met een Async helper, sla de baan ID op, gebruik dan Jobs.Wait en Jobs.Result. Bulk verwerkt grotere datasets en navulbare taken.
Account- Lees identiteit, evenwicht, prijsstelling, limieten en gebruik voor onbeheerd werk. Hergebruik dezelfde client en geautoriseerde sleutel.
WithFormat- Vraag JSON, platte tekst of Markdown aan met expliciete formaatopties. Markdown-formaten haalden gegevens op voor uw agent; uw toepassing levert modeloproepen of samenvattingen.
Go-typen
GoogleSearchInput beschrijft de query. Optionele parameters gebruiken aanwijzers, zoals flashdata.Ptr(int64(5)). Resultaten bevat bron JSON; gebruik DecodeResults[GoogleSearchPayload] wanneer u getypte velden nodig hebt.
Volgende stappen
Als een stap mislukt
- Pakket of looptijd ontbreekt
- Controleer go versie en run ga krijgen in de directory met go.mod.
- 401 / FLASHDATA_API_KEY
- Stel een geldige sleutel in in de terminal waar u het voorbeeld uitvoert.
- 403
- Schakel Google Search in voor deze API sleutel.
- 402
- Controleer Billing op beschikbare credits, of claim een test met uitgeputte middelen.
- 429
- Wacht op Retry-After en verlaag dan uw aanvraagsnelheid.
- Timeout of serverfout
- Controleer History alvorens opnieuw te versturen; het eerste verzoek kan al uitgevoerd zijn.