Explorar documentação
Primeiros passos
Instale o Go SDK e execute um pedido Google Search digitado. Então tente dados YouTube com o mesmo cliente.
Instale o SDK
Requer Go 1.25+. Escolha um novo projeto ou instale no diretório que contém seu go.mod existente.
Instalarmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Instalargo get github.com/flashdatadev/[email protected]Autenticação
Inscreva-se, verifique seu e-mail e crie uma chave API com permissão de busca Google, ou reutilize uma chave autorizada.
Coloque FLASHDATA_API_KEY abaixo, ou mantenha o valor já fornecido pelo seu ambiente. O exemplo o lê explicitamente, os arquivos Env não estão carregados.
Chave escondida pronta. 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_KEYChave escondida pronta. 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 flashdataSecureKeyFaça uma pesquisa
Guarde isso como main.go ao lado de go.mod, e execute no mesmo terminal. Ele envia uma busca por até cinco resultados e imprime a resposta 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) } }Executargo run .Confira o resultado
Procure status: done no JSON impresso. Use os títulos devolvidos, URLs e trechos em sua aplicação ou agente. Uma lista orgânica vazia também é um resultado válido.
Exemplo de saída{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- feito significa que a busca foi concluída.
results[].organic[]- Resultados da pesquisa com título, link e campos de recortes.
usage.credits- Créditos usados por este pedido. Cinco resultados são uma busca, não cinco pedidos.
Tente outra fonte de dados
Em main.go, substitua apenas o resultado, err:= client.Google.Search(...) ligue com uma dessas chamadas. Mantenha o cliente, contexto, verificação de erro e saída JSON, então execute ir executar. novamente. Cada corrida apresenta um novo pedido.
Requer permissão google_news. Devolve os resultados da sua consulta.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Requer permissão youtube_metadata. Devolve detalhes de vídeo, como título, canal e duração, não baixa o vídeo.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Requer permissão youtube_transcript. Solicita uma transcrição em inglês, incluindo faixas automáticas. Devolve texto e horários quando a faixa estiver disponível.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})O que o Go SDK suporta
Google- Pesquisa, Notícias, Imagens, Compras, Vídeos e Locais. Use Google.Pages para resultados paginados.
YouTube- Pesquisa, Metadados, Transcrição, Legendas, Canal e Sugestões fornecem dados de vídeo estruturados.
YouTube.Download- Envie um trabalho de entrega de áudio ou vídeo para o seu armazenamento na nuvem. Requer permissão youtube_download e configuração de armazenamento; use o exemplo completo abaixo.
Jobs / Bulk- Submeta-se com um ajudante Async, salve o trabalho ID, e use Jobs.Wait e Jobs.Result. Bulk lida com conjuntos de dados maiores e trabalhos reutilizáveis.
Account- Leia identidade, equilíbrio, preços, limites e uso antes de trabalhar sozinho. Reutilize o mesmo cliente e a chave autorizada.
WithFormat- Solicitar JSON, texto simples ou Markdown com opções de formato explícitas. Formatos Markdown recuperaram dados para o seu agente, seu aplicativo fornece modelos de chamadas ou resumos.
Tipos do Go
GoogleSearchInput descreve a consulta. Parâmetros opcionais usam ponteiros, como flashdata.Ptr (int64 (5)). Os resultados contêm fonte JSON; use DecodeResultados[GoogleSearchPayload] quando você precisa de campos digitados.
Próximos passos
Se um passo falhar
- Pacote ou tempo de execução faltando
- Verifique a versão e vá para o diretório contendo go.mod.
- 401 / FLASHDATA_API_KEY
- Coloque uma chave válida no terminal onde você executa o exemplo.
- 403
- Active a busca Google por esta chave API.
- 402
- verificação Billing para os créditos disponíveis, ou reivindique um teste de agente exausto.
- 429
- Espere pelo Retry-After, então reduza a taxa de solicitação.
- Tempo limite ou erro do servidor
- Verifique History antes de reenviar, o primeiro pedido pode já ter sido executado.