Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

Go SDK snelstart

Installeer de Go SDK en voer een getypte Google Search-verzoek uit. Probeer dan YouTube gegevens met dezelfde client.

  1. Installeer de SDK

    Vereist Go 1.25+. Kies een nieuw project of installeer in de map met uw bestaande go.mod.

    Installeren
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. 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_KEY
  3. Een 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.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)
        }
    }
    Uitvoeren
    go run .
  4. 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.

De zoekaanroep in main.go vervangen
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

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.