# Go SDK Quickstart

Installieren Sie die Go SDK und führen Sie eine eingegebene Google Search-Anforderung aus. Versuchen Sie dann YouTube-Daten mit dem gleichen Client.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/flashdata-go
Test: 2026-11-04 von FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Quelle und SDK Referenz
- [API-Schlüssel erstellen](https://flashdata.dev/app/api-keys) — Erstellen eines Schlüssels in der Konsole

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

## Machen Sie Ihre erste Go-Anfrage

Installieren Sie den SDK, legen Sie Ihren API-Schlüssel fest und führen Sie das Beispiel unten aus.

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

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

### Installieren Sie den SDK

Erfordert Go 1.25+. Wählen Sie ein neues Projekt aus oder installieren Sie es im Verzeichnis mit Ihrem vorhandenen go.mod.

#### Neues Projekt

##### Installieren

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


#### Bestehendes Modul

##### Installieren

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


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

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

### Authentifizierend

Melden Sie sich an, überprüfen Sie Ihre E-Mail und erstellen Sie einen API-Schlüssel mit der Google Search-Berechtigung oder verwenden Sie einen autorisierten Schlüssel erneut.

Legen Sie unten FLASHDATA_API_KEY fest oder behalten Sie den bereits von Ihrer Umgebung gelieferten Wert bei. Das Beispiel liest es explizit; .env Dateien werden nicht geladen.

#### Bash

##### Versteckte Tastenaufforderung · 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

##### Versteckte Tastenaufforderung · 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
```


- [Registrieren](https://flashdata.dev/signup)
- [Erstellen Sie einen API-Schlüssel](https://flashdata.dev/app/api-keys)
- [Scheckgutschriften](https://flashdata.dev/app/billing)
- [Agent-Authentifizierung](https://flashdata.dev/auth.md)

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

### Suche ausführen

Speichern Sie dies als main.go neben go.mod und führen Sie es dann im selben Terminal aus. Es sendet eine Suche nach bis zu fünf Ergebnissen und druckt die JSON-Antwort.

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

#### Ausführen

```bash
go run .
```


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

### Ergebnis prüfen

Suchen Sie nach status: done im gedruckten JSON. Verwenden Sie die zurückgegebenen Titel, URLs und Snippets in Ihrer Anwendung oder Ihrem Agenten. Eine leere organische Liste ist ebenfalls ein gültiges Ergebnis.

| Feld | Bedeutung |
| --- | --- |
| status | getan bedeutet, dass die Suche abgeschlossen ist. |
| results[].organic[] | Suchergebnisse mit Titel, Link und Snippetfeldern. |
| usage.credits | Credits, die von diesem antrag verwendet werden. Fünf Ergebnisse sind eine Suche, nicht fünf Anfragen. |

#### Beispielausgabe

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

## Probieren Sie eine andere Datenquelle

Ersetzen Sie in main.go nur das Ergebnis, err := client.Google.Search(...) mit einem dieser Aufrufe. Behalten Sie den Client, den Kontext, die Fehlerprüfungen und die JSON-Ausgabe, und führen Sie dann Go Run. Jeder Run sendet eine neue Anfrage.

### Google Nachrichten

Erfordert google_news Berechtigung. Gibt News-Ergebnisse für Ihre Abfrage zurück.

#### Ersetzen Sie den Suchaufruf in main.go

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


### YouTube-Metadaten

Erfordert youtube_metadata Berechtigung. Gibt Videodetails wie Titel, Kanal und Dauer zurück; das Video wird nicht heruntergeladen.

#### Ersetzen Sie den Suchaufruf in main.go

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


### YouTube-Transkript

Erfordert youtube_transcript Berechtigung. Fordert ein vorhandenes englisches Transkript an, einschließlich automatischer Tracks. Gibt Text und Zeitstempel zurück, wenn dieser Track verfügbar ist.

#### Ersetzen Sie den Suchaufruf 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),
    },
})
```


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

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

## Was das Go SDK unterstützt

| Verwendung | SDK-Eingangspunkte |
| --- | --- |
| Google | Suche, Nachrichten, Bilder, Einkaufen, Videos und Orte. Verwenden Sie Google.Pages für Paginierte Ergebnisse. |
| YouTube | Search, Metadata, Transcript, Captions, Channel und Suggestions liefern strukturierte Videodaten. |
| YouTube.Download | Senden Sie einen Audio- oder Video-Lieferauftrag an Ihren Cloud-Speicher. Erfordert youtube_download-Berechtigung und Speicherkonfiguration; verwenden Sie das vollständige Beispiel unten. |
| Jobs / Bulk | Senden Sie mit einem Async-Helfer, speichern Sie den Job ID und verwenden Sie dann Jobs.Wait und Jobs.Result. Bulk verarbeitet größere Datensätze und resumable Jobs. |
| Account | Lesen Sie Identität, Balance, Preise, Limits und Nutzung vor unbeaufsichtigter Arbeit. Verwenden Sie denselben Client und autorisierten Schlüssel erneut. |
| WithFormat | Fordern Sie JSON, Klartext oder Markdown mit expliziten Formatoptionen an. Markdown formatiert abgerufene Daten für Ihren Agenten; Ihre Anwendung liefert Modellaufrufe oder Zusammenfassungen. |

- [Complete Go Download Beispiel](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Konfigurieren des Download-Speichers](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)
- [Go Antwortformate](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Go-Typen

GoogleSearchInput beschreibt die Abfrage. Optionale Parameter verwenden Zeiger wie flashdata.Ptr(int64(5)). Die Ergebnisse enthalten die Quelle JSON; verwenden Sie DecodeResults[GoogleSearchPayload], wenn Sie eingegebene Felder benötigen.

- [Speichern und Dekodieren von typisierten Ergebnissen](https://flashdata.dev/de/docs/guides/sdk-operations/reference.md#save)

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

## Nächste Schritte

- [Kontoprüfungen und gespeicherte Ergebnisse](https://flashdata.dev/de/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/de/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)
- [SDK-Verfahren](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Wenn ein Schritt fehlschlägt

| Problem | Fixpunkt |
| --- | --- |
| Paket oder Laufzeit fehlt | Überprüfen Sie die Go-Version und führen Sie Go Get im Verzeichnis mit go.mod aus. |
| 401 / FLASHDATA_API_KEY | Legen Sie einen gültigen Schlüssel in dem Terminal fest, in dem Sie das Beispiel ausführen. |
| 403 | Aktivieren Sie Google Search für diesen API Schlüssel. |
| 402 | Überprüfen Sie Billing auf verfügbare Credits oder fordern Sie eine erschöpfte Agentenstudie an. |
| 429 | Warten Sie auf Retry-After und reduzieren Sie dann Ihre Anfragerate. |
| Timeout oder Serverfehler | Überprüfen Sie History vor dem erneuten Senden; die erste Anforderung wurde möglicherweise bereits ausgeführt. |

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