Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

Início rápido com o Go SDK

Instale o Go SDK e execute um pedido Google Search digitado. Então tente dados YouTube com o mesmo cliente.

  1. Instale o SDK

    Requer Go 1.25+. Escolha um novo projeto ou instale no diretório que contém seu go.mod existente.

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

Substitua a chamada de busca em main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

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.