Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

Go SDK Quickstart

Installieren Sie die Go SDK und führen Sie eine eingegebene Google Search-Anforderung aus. Versuchen Sie dann YouTube-Daten mit dem gleichen Client.

  1. 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.

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

Ersetzen Sie den Suchaufruf in main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

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.