# 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.

Referencia canónica: https://flashdata.dev/es/docs/guides/flashdata-go
Revisado: 2026-11-04 por FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Código fuente y referencia del SDK
- [Obtén una clave API](https://flashdata.dev/app/api-keys) — Crea una clave en la consola

<a id="application"></a>

## Haz tu primera solicitud con Go

Instala el SDK, configura tu clave API y ejecuta el siguiente ejemplo.

- [Referencia de métodos del SDK para Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="install"></a>

### 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.

#### Nuevo proyecto

##### Instalar

```bash
mkdir flashdata-demo
cd flashdata-demo
go mod init example.com/flashdata-demo
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


#### Módulo existente

##### Instalar

```bash
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


- [Instalar Go](https://go.dev/doc/install)
- [Versión del SDK](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

<a id="authentication"></a>

### 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.

#### Bash

##### Clave API · Bash

```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
```


#### PowerShell 7

##### Clave API · PowerShell

```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 flashdataSecureKey
```


- [Crear cuenta](https://flashdata.dev/signup)
- [Crear una clave API](https://flashdata.dev/app/api-keys)
- [Consultar créditos](https://flashdata.dev/app/billing)
- [Autenticación para agentes](https://flashdata.dev/auth.md)

<a id="query"></a>

### 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

```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

```bash
go run .
```


<a id="result"></a>

### 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.

| Campo | Significado |
| --- | --- |
| 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. |

#### Ejemplo de respuesta

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```


<a id="common-tasks"></a>

## 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.

### Google News

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

#### Sustituir la llamada de búsqueda en main.go

```go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})
```


### Metadatos de YouTube

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.

#### Sustituir la llamada de búsqueda en main.go

```go
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
    VideoID: "dQw4w9WgXcQ",
})
```


### Transcripción de YouTube

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.

#### Sustituir la llamada de búsqueda en main.go

```go
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
    VideoID: "dQw4w9WgXcQ",
    Params: &flashdata.YouTubeTranscriptParams{
        Language: flashdata.Ptr("en"),
        Auto: flashdata.Ptr(true),
    },
})
```


- [Parámetros de todas las fuentes](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

<a id="features"></a>

## Funciones del SDK para Go

| Uso | Métodos y servicios del SDK |
| --- | --- |
| 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. |

- [Ejemplo completo de descarga en Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Configurar el almacenamiento para descargas](https://flashdata.dev/es/docs/guides/youtube-download-guide/reference.md)
- [Formatos de respuesta en Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

<a id="types"></a>

## 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.

- [Guardar y decodificar resultados tipados](https://flashdata.dev/es/docs/guides/sdk-operations/reference.md#save)

<a id="next"></a>

## Siguientes pasos

- [Consultar la cuenta y reutilizar resultados](https://flashdata.dev/es/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/es/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/es/docs/guides/youtube-download-guide/reference.md)
- [Referencia de métodos del SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="recover"></a>

## Si un paso falla

| Problema | Qué hacer |
| --- | --- |
| 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. |

- [Historial de solicitudes](https://flashdata.dev/app/jobs)
- [Facturación](https://flashdata.dev/app/billing)
