Explorar documentación
Primeros pasos
Instala el SDK para Go y haz una solicitud tipada de Google Search. Después, consulta datos de YouTube con el mismo cliente.
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.
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]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_KEYClave API · 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 flashdataSecureKeyHaz 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.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) } }Ejecutargo run .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.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Requiere el permiso youtube_metadata. Devuelve datos del vídeo, como el título, el canal y la duración. No descarga el vídeo.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Requiere el permiso youtube_transcript. Solicita una transcripción existente en inglés, incluidas las pistas automáticas. Si la pista está disponible, devuelve el texto y las marcas de tiempo.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})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.