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

Referência canônica: https://flashdata.dev/pt/docs/guides/flashdata-go
2026-11-04 por FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Fonte e referência SDK
- [Obtenha uma chave de API](https://flashdata.dev/app/api-keys) — Crie uma chave no console

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

## Faça seu primeiro pedido de Go

Instale o SDK, defina sua chave API e execute o exemplo abaixo.

- [Referência de métodos do Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### Instale o SDK

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

#### Novo projeto

##### 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 o Go](https://go.dev/doc/install)
- [SDK lançamento](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

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

#### Bash

##### Chave escondida pronta. 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

##### Chave escondida pronta. 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
```


- [Criar conta](https://flashdata.dev/signup)
- [Crie uma chave API](https://flashdata.dev/app/api-keys)
- [verificação os créditos](https://flashdata.dev/app/billing)
- [Autenticação do agente](https://flashdata.dev/auth.md)

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

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

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

```bash
go run .
```


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

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

| Campo | O que quer dizer? |
| --- | --- |
| 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. |

#### Exemplo de saída

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

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

### Google Notícias

Requer permissão google_news. Devolve os resultados da sua consulta.

#### Substitua a chamada de busca em main.go

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


### YouTube metadados

Requer permissão youtube_metadata. Devolve detalhes de vídeo, como título, canal e duração, não baixa o vídeo.

#### Substitua a chamada de busca em main.go

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


### YouTube transcrição

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.

#### Substitua a chamada de busca em main.go

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


- [Todos os parâmetros de origem](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## O que o Go SDK suporta

| Use | SDK pontos de entrada |
| --- | --- |
| 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. |

- [Complete o exemplo de download do Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Configure o armazenamento de download](https://flashdata.dev/pt/docs/guides/youtube-download-guide/reference.md)
- [Formatos de resposta em Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

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

- [Salvar e decodificar resultados digitados](https://flashdata.dev/pt/docs/guides/sdk-operations/reference.md#save)

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

## Próximos passos

- [verificações de contas e resultados salvos](https://flashdata.dev/pt/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/pt/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/pt/docs/guides/youtube-download-guide/reference.md)
- [Referência do método SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Se um passo falhar

| Problema | Consertar |
| --- | --- |
| 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. |

- [Requisito histórico](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
