Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

Inicio rápido del SDK para Go

Instala el SDK para Go y haz una solicitud tipada de Google Search. Después, consulta datos de YouTube con el mismo cliente.

  1. Instala el SDK

    Requiere Go 1.25+. Elige «Nuevo proyecto» para empezar desde cero o «Módulo existente» para instalar el SDK en el directorio que contiene tu go.mod.

    Instalar
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. Configura la autenticación

    Crea una cuenta, verifica tu correo electrónico y crea una clave API con permiso para Google Search. También puedes reutilizar una clave autorizada.

    Ejecuta el bloque y pega tu clave cuando se solicite; no se mostrará en pantalla. Omite este paso si tu entorno ya define FLASHDATA_API_KEY. El ejemplo lee esa variable directamente; no carga archivos .env.

    Clave API · 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. Haz una búsqueda

    Guarda el código como main.go en el mismo directorio que go.mod. Desde ese directorio, ejecuta go run . en la terminal donde configuraste la clave. Envía una búsqueda de hasta cinco resultados y muestra la respuesta 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)
        }
    }
    Ejecutar
    go run .
  4. Comprueba el resultado

    Busca status: done en el JSON que aparece en la terminal. Usa los títulos, las URLs y los fragmentos devueltos en tu aplicación o agente. Una lista organic vacía también es un resultado válido.

    Ejemplo de respuesta
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    El valor done indica que la búsqueda terminó correctamente.
    results[].organic[]
    Resultados de búsqueda con los campos title, link y snippet.
    usage.credits
    Créditos consumidos por la solicitud. Una búsqueda con cinco resultados cuenta como una sola solicitud.

Prueba otra fuente de datos

En main.go, sustituye solo la llamada result, err := client.Google.Search(...) por uno de estos ejemplos. Conserva el cliente, el contexto, la gestión de errores y la salida JSON. Vuelve a ejecutar go run .; cada ejecución envía una nueva solicitud.

Requiere el permiso google_news. Devuelve noticias relacionadas con tu búsqueda.

Sustituir la llamada de búsqueda en main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Funciones del SDK para Go

Google
Search, News, Images, Shopping, Videos y Places. Usa Google.Pages para obtener resultados paginados.
YouTube
Search, Metadata, Transcript, Captions, Channel y Suggestions devuelven datos de vídeo estructurados.
YouTube.Download
Envía un trabajo para entregar audio o vídeo en tu almacenamiento en la nube. Requiere el permiso youtube_download y la configuración del almacenamiento. Consulta el ejemplo completo de descarga.
Jobs / Bulk
Envía el trabajo con un método Async y guarda su ID. Después, usa Jobs.Wait y Jobs.Result. Bulk permite procesar conjuntos de datos más grandes y reanudar trabajos.
Account
Consulta la identidad, el saldo, los precios, los límites y el uso antes de ejecutar tareas sin supervisión. Reutiliza el mismo cliente y la clave autorizada.
WithFormat
Solicita JSON, texto plano o Markdown mediante las opciones de formato. Markdown presenta los datos para tu agente; tu aplicación se encarga de las llamadas al modelo y los resúmenes.

Tipos de Go

GoogleSearchInput describe la consulta. Los parámetros opcionales usan punteros, como flashdata.Ptr(int64(5)). Results contiene el JSON de la fuente; usa DecodeResults[GoogleSearchPayload] cuando necesites campos tipados.

Siguientes pasos

Si un paso falla

Falta el paquete o la herramienta para ejecutarlo
Comprueba go version y ejecuta el comando go get del paso de instalación en el directorio que contiene go.mod.
401 / FLASHDATA_API_KEY
Define una clave válida en la terminal donde ejecutas el ejemplo.
403
Pide al titular que conceda el permiso de Google Search a esta clave API.
402
Consulta los créditos disponibles en Billing. Si la prueba del agente se ha agotado, vincúlala a una cuenta para obtener acceso del titular.
429
Espera el tiempo indicado por Retry-After y reduce la frecuencia de tus solicitudes.
Tiempo de espera agotado o error del servidor
Revisa History antes de volver a enviar la solicitud; la primera puede haberse ejecutado ya.