# Go SDK rapido

Installare il Go SDK ed eseguire una richiesta di ricerca Google digitata. Quindi provare i dati YouTube con lo stesso client.

Riferimento canonico: https://flashdata.dev/it/docs/guides/flashdata-go
Recensito: 2026-11-04 da FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Fonte e riferimento SDK
- [Ottieni una chiave API](https://flashdata.dev/app/api-keys) — Creare una chiave nella console

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

## Fai la tua prima richiesta Go

Installare lo SDK, impostare il tasto API ed eseguire l'esempio qui sotto.

- [Riferimento dei metodi del Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### Installare la SDK

Richiede Go 1.25+. Scegli un nuovo progetto o installa nella directory contenente il tuo go.mod esistente.

#### Nuovo progetto

##### Installa

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


#### Modulo esistente

##### Installa

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


- [Installare Go](https://go.dev/doc/install)
- [rilascio SDK](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### Autentico

Registrati, verifica la tua email e crea una chiave API con il permesso di ricerca Google, o riutilizza una chiave autorizzata.

Impostare FLASHDATA_API_KEY di seguito, o mantenere il valore già fornito dall'ambiente. L'esempio lo legge esplicitamente; i file .env non sono caricati.

#### Bash

##### Segnale chiave nascosta · 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

##### Segnale chiave nascosta · 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
```


- [Registrati](https://flashdata.dev/signup)
- [Creare una chiave API](https://flashdata.dev/app/api-keys)
- [Controllare i crediti](https://flashdata.dev/app/billing)
- [Autenticazione agente](https://flashdata.dev/auth.md)

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

### Esegui una ricerca

Salvare questo come main.go accanto a go.mod, quindi eseguirlo nello stesso terminale. Invia una ricerca fino a cinque risultati e stampa la risposta 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)
    }
}
```

#### Esegui

```bash
go run .
```


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

### Verifica il risultato

Cercare status: done nella JSON stampata. Utilizzare i titoli restituiti, URLs e snippets nella vostra applicazione o agente. Una lista organica vuota è anche un risultato valido.

| Campo di applicazione | Significato |
| --- | --- |
| status | fatto significa la ricerca completata. |
| results[].organic[] | Risultati di ricerca con titolo, link e campi di snippet. |
| usage.credits | Crediti utilizzati da questa richiesta. Cinque risultati sono una ricerca, non cinque richieste. |

#### Esempio di output

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

## Prova un'altra fonte di dati

In main.go, sostituire solo il risultato, err := client.Google.Search(...) chiamare con una di queste chiamate. Mantenere il client, il contesto, i controlli di errore e l'output JSON, quindi eseguire andare avanti. Ogni run presenta una nuova richiesta.

### Google News

Richiede il permesso google_news. Restituisce i risultati delle notizie per la tua richiesta.

#### Sostituisci la chiamata di ricerca in main.go

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


### metadati YouTube

Richiede il permesso youtube_metadata. Restituisce i dettagli video come titolo, canale e durata; non scarica il video.

#### Sostituisci la chiamata di ricerca in main.go

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


### Trascrizione di YouTube

Richiede il permesso youtube_transcript. Richiede una trascrizione inglese esistente, incluse tracce automatiche. Restituisce testo e timestamp quando la traccia è disponibile.

#### Sostituisci la chiamata di ricerca in main.go

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


- [Tutti i parametri di origine](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Cosa supporta Go SDK

| Uso | Punti di ingresso SDK |
| --- | --- |
| Google | Ricerca, Notizie, Immagini, Shopping, Video e Luoghi. Utilizzare Google.Pages per i risultati impaginati. |
| YouTube | Ricerca, Metadati, Trascrizione, Didascalie, Canale e Suggerimenti forniscono dati video strutturati. |
| YouTube.Download | Invia un lavoro di consegna audio o video al tuo cloud storage. Richiede il permesso youtube_download e la configurazione di archiviazione; utilizzare l'esempio completo qui sotto. |
| Jobs / Bulk | Inviare con un helper Async, salvare il lavoro ID, quindi utilizzare Jobs.Wait e Jobs.Result. Bulk gestisce più grandi set di dati e lavori recuperabili. |
| Account | Leggi l'identità, l'equilibrio, i prezzi, i limiti e l'uso prima del lavoro non assistito. Riutilizzare lo stesso client e la chiave autorizzata. |
| WithFormat | Richiedi JSON, testo normale o Markdown con opzioni di formato esplicite. I formati Markdown recuperati dati per il tuo agente; la tua applicazione fornisce chiamate modello o riassunti. |

- [Esempio di download completo Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Configurare lo storage di download](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md)
- [Formati di risposta Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Tipologie Go

GoogleSearchInput descrive la query. Parametri opzionali utilizzano puntatori, come flashdata.Ptr (int64(5)). I risultati contengono sorgente JSON; utilizzare DecodeResults[GoogleSearchPayload] quando è necessario digitare i campi.

- [Salvare e decodificare i risultati digitati](https://flashdata.dev/it/docs/guides/sdk-operations/reference.md#save)

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

## Prossimo passo

- [Controllo account e risultati salvati](https://flashdata.dev/it/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/it/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md)
- [Riferimento metodo SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Se un passo fallisce

| Problematiche | Risolto |
| --- | --- |
| Pacchetto o runtime mancanti | Controllare la versione di go ed eseguire andare ottenere nella directory contenente go.mod. |
| 401 / FLASHDATA_API_KEY | Impostare una chiave valida nel terminale in cui si esegue l'esempio. |
| 403 | Abilitare Google Cercare questo tasto API. |
| 402 | Controllare Billing per i crediti disponibili, o richiedere una prova agente esausta. |
| 429 | Attendere Retry-After, quindi ridurre il tasso di richiesta. |
| Errore di timeout o server | Controllare History prima di effettuare il resending; la prima richiesta potrebbe già essere stata eseguita. |

- [Richiedi la cronologia](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
