Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Go SDK rapido

Installare il Go SDK ed eseguire una richiesta di ricerca Google digitata. Quindi provare i dati YouTube con lo stesso client.

  1. Installare la SDK

    Richiede Go 1.25+. Scegli un nuovo progetto o installa nella directory contenente il tuo go.mod esistente.

    Installa
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. Autentico

    Registrati, verifica la tua email e crea una chiave API con il permesso di ricerca Google, o riutilizza una chiave autorizzata.

    Impostare FLASHDATA_API_KEY di seguito, o mantenere il valore già fornito dall'ambiente. L'esempio lo legge esplicitamente; i file .env non sono caricati.

    Segnale chiave nascosta · 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. Esegui una ricerca

    Salvare questo come main.go accanto a go.mod, quindi eseguirlo nello stesso terminale. Invia una ricerca fino a cinque risultati e stampa la risposta JSON.

    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)
        }
    }
    Esegui
    go run .
  4. Verifica il risultato

    Cercare status: done nella JSON stampata. Utilizzare i titoli restituiti, URLs e snippets nella vostra applicazione o agente. Una lista organica vuota è anche un risultato valido.

    Esempio di output
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    fatto significa la ricerca completata.
    results[].organic[]
    Risultati di ricerca con titolo, link e campi di snippet.
    usage.credits
    Crediti utilizzati da questa richiesta. Cinque risultati sono una ricerca, non cinque richieste.

Prova un'altra fonte di dati

In main.go, sostituire solo il risultato, err := client.Google.Search(...) chiamare con una di queste chiamate. Mantenere il client, il contesto, i controlli di errore e l'output JSON, quindi eseguire andare avanti. Ogni run presenta una nuova richiesta.

Richiede il permesso google_news. Restituisce i risultati delle notizie per la tua richiesta.

Sostituisci la chiamata di ricerca in main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Cosa supporta Go SDK

Google
Ricerca, Notizie, Immagini, Shopping, Video e Luoghi. Utilizzare Google.Pages per i risultati impaginati.
YouTube
Ricerca, Metadati, Trascrizione, Didascalie, Canale e Suggerimenti forniscono dati video strutturati.
YouTube.Download
Invia un lavoro di consegna audio o video al tuo cloud storage. Richiede il permesso youtube_download e la configurazione di archiviazione; utilizzare l'esempio completo qui sotto.
Jobs / Bulk
Inviare con un helper Async, salvare il lavoro ID, quindi utilizzare Jobs.Wait e Jobs.Result. Bulk gestisce più grandi set di dati e lavori recuperabili.
Account
Leggi l'identità, l'equilibrio, i prezzi, i limiti e l'uso prima del lavoro non assistito. Riutilizzare lo stesso client e la chiave autorizzata.
WithFormat
Richiedi JSON, testo normale o Markdown con opzioni di formato esplicite. I formati Markdown recuperati dati per il tuo agente; la tua applicazione fornisce chiamate modello o riassunti.

Tipologie Go

GoogleSearchInput descrive la query. Parametri opzionali utilizzano puntatori, come flashdata.Ptr (int64(5)). I risultati contengono sorgente JSON; utilizzare DecodeResults[GoogleSearchPayload] quando è necessario digitare i campi.

Prossimo passo

Se un passo fallisce

Pacchetto o runtime mancanti
Controllare la versione di go ed eseguire andare ottenere nella directory contenente go.mod.
401 / FLASHDATA_API_KEY
Impostare una chiave valida nel terminale in cui si esegue l'esempio.
403
Abilitare Google Cercare questo tasto API.
402
Controllare Billing per i crediti disponibili, o richiedere una prova agente esausta.
429
Attendere Retry-After, quindi ridurre il tasso di richiesta.
Errore di timeout o server
Controllare History prima di effettuare il resending; la prima richiesta potrebbe già essere stata eseguita.