# Go SDK snelstart

Installeer de Go SDK en voer een getypte Google Search-verzoek uit. Probeer dan YouTube gegevens met dezelfde client.

Canonische referentie: https://flashdata.dev/nl/docs/guides/flashdata-go
Beoordeeld: 2026-11-04 door FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Bron- en SDK-referentie
- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys) — Een sleutel aanmaken in de console

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

## Maak uw eerste Go verzoek

Installeer de SDK, stel uw API sleutel in en voer het voorbeeld hieronder uit.

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

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

### Installeer de SDK

Vereist Go 1.25+. Kies een nieuw project of installeer in de map met uw bestaande go.mod.

#### Nieuw project

##### Installeren

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


#### Bestaande module

##### Installeren

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


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

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

### Authenticeren

Meld je aan, verifieer je e-mail en maak een API sleutel met Google Search toestemming, of hergebruik een geautoriseerde sleutel.

Stel hieronder FLASHDATA_API_KEY in, of houd de waarde die al door uw omgeving wordt geleverd. Het voorbeeld leest het expliciet; .env-bestanden worden niet geladen.

#### Bash

##### Verborgen sleutelprompt · 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

##### Verborgen sleutelprompt · 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
```


- [Registreren](https://flashdata.dev/signup)
- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys)
- [Controleer kredieten](https://flashdata.dev/app/billing)
- [Agent-authenticatie](https://flashdata.dev/auth.md)

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

### Een zoekopdracht uitvoeren

Sla dit op als main.go naast go.mod en voer het dan uit in dezelfde terminal. Het stuurt één zoekopdracht naar maximaal vijf resultaten en drukt de JSON respons af.

#### 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)
    }
}
```

#### Uitvoeren

```bash
go run .
```


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

### Het resultaat controleren

Zoek naar status: done in de afgedrukte JSON. Gebruik de geretourneerde titels, URLs en knipsels in uw toepassing of agent. Een lege organische lijst is ook een geldig resultaat.

| Veld | Betekenis |
| --- | --- |
| status | gedaan betekent de zoektocht voltooid. |
| results[].organic[] | Zoekresultaten met titel, link en knipselvelden. |
| usage.credits | Dankbetuigingen die door dit verzoek worden gebruikt. Vijf resultaten zijn één zoektocht, niet vijf verzoeken. |

#### Voorbeelduitvoer

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

## Probeer een andere gegevensbron

In main.go, vervang alleen het resultaat, error:= client.Google.Search(...) call met een van deze oproepen. Houd de client, context, foutcontroles en JSON uitvoer, dan ga uitvoeren . opnieuw. Elke run dient één nieuw verzoek in.

### Google Nieuws

Vereist google_news-permissie. Geeft nieuwsresultaten terug voor uw zoekopdracht.

#### De zoekaanroep in main.go vervangen

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


### YouTube-metadata

Vereist youtube_metadata-permissie. Geeft videogegevens terug zoals titel, kanaal en duur; het downloadt de video niet.

#### De zoekaanroep in main.go vervangen

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


### YouTube transcript

Vereist youtube_transcript-permissie. Verzoekt een bestaand Engels transcript, inclusief automatische tracks. Geeft tekst en tijdstempels terug wanneer die track beschikbaar is.

#### De zoekaanroep in main.go vervangen

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


- [Alle bronparameters](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Wat de Go SDK ondersteunt

| Gebruik | SDK entry points |
| --- | --- |
| Google | Zoeken, Nieuws, Afbeeldingen, Winkelen, Video's en Plaatsen. Gebruik Google.Pages voor gepagineerde resultaten. |
| YouTube | Zoeken, Metadata, Transcript, Bijschriften, Channel en Suggesties bieden gestructureerde videogegevens. |
| YouTube.Download | Stuur een audio- of videoleveringstaak naar uw cloudopslag. Vereist youtube_download toestemming en opslagconfiguratie; gebruik het volledige voorbeeld hieronder. |
| Jobs / Bulk | Submit met een Async helper, sla de baan ID op, gebruik dan Jobs.Wait en Jobs.Result. Bulk verwerkt grotere datasets en navulbare taken. |
| Account | Lees identiteit, evenwicht, prijsstelling, limieten en gebruik voor onbeheerd werk. Hergebruik dezelfde client en geautoriseerde sleutel. |
| WithFormat | Vraag JSON, platte tekst of Markdown aan met expliciete formaatopties. Markdown-formaten haalden gegevens op voor uw agent; uw toepassing levert modeloproepen of samenvattingen. |

- [Complete Go download voorbeeld](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Downloadopslag instellen](https://flashdata.dev/nl/docs/guides/youtube-download-guide/reference.md)
- [Go-responsformaten](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Go-typen

GoogleSearchInput beschrijft de query. Optionele parameters gebruiken aanwijzers, zoals flashdata.Ptr(int64(5)). Resultaten bevat bron JSON; gebruik DecodeResults[GoogleSearchPayload] wanneer u getypte velden nodig hebt.

- [Opslaan en decoderen van getypte resultaten](https://flashdata.dev/nl/docs/guides/sdk-operations/reference.md#save)

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

## Volgende stappen

- [Accountcontroles en opgeslagen resultaten](https://flashdata.dev/nl/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/nl/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/nl/docs/guides/youtube-download-guide/reference.md)
- [Referentie SDK-methode](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Als een stap mislukt

| Probleem | Repareren |
| --- | --- |
| Pakket of looptijd ontbreekt | Controleer go versie en run ga krijgen in de directory met go.mod. |
| 401 / FLASHDATA_API_KEY | Stel een geldige sleutel in in de terminal waar u het voorbeeld uitvoert. |
| 403 | Schakel Google Search in voor deze API sleutel. |
| 402 | Controleer Billing op beschikbare credits, of claim een test met uitgeputte middelen. |
| 429 | Wacht op Retry-After en verlaag dan uw aanvraagsnelheid. |
| Timeout of serverfout | Controleer History alvorens opnieuw te versturen; het eerste verzoek kan al uitgevoerd zijn. |

- [Geschiedenis aanvragen](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
