Sfoglia la documentazione
Per iniziare
Installare il Go SDK ed eseguire una richiesta di ricerca Google digitata. Quindi provare i dati YouTube con lo stesso client.
Installare la SDK
Richiede Go 1.25+. Scegli un nuovo progetto o installa nella directory contenente il tuo go.mod esistente.
Installamkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Installago get github.com/flashdatadev/[email protected]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_KEYSegnale chiave nascosta · 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 flashdataSecureKeyEsegui 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.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) } }Eseguigo run .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.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Richiede il permesso youtube_metadata. Restituisce i dettagli video come titolo, canale e durata; non scarica il video.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Richiede il permesso youtube_transcript. Richiede una trascrizione inglese esistente, incluse tracce automatiche. Restituisce testo e timestamp quando la traccia è disponibile.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})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.