# Go SDK szybki start

Zainstaluj Go SDK i uruchom wpisany wniosek Google Search. Następnie spróbuj danych YouTube z tym samym klientem.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/flashdata-go
Przegląd: 2026-11-04 przez FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Źródło i odniesienie do SDK
- [Uzyskaj klucz API](https://flashdata.dev/app/api-keys) — Utwórz klucz w konsoli

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

## Złóż pierwszą prośbę Go

Zainstaluj SDK, ustaw klawisz API i uruchom poniższy przykład.

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

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

### Zainstaluj SDK

Wymaga Go 1.25 +. Wybierz nowy projekt lub zainstaluj w katalogu zawierającym istniejący go.mod.

#### Nowy projekt

##### Zainstaluj

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


#### Istniejący moduł

##### Zainstaluj

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


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

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

### Uwierzytelnij

Zarejestruj się, weryfikuj swój e-mail i utwórz klucz API za zgodą Google Search lub ponownie użyj autoryzowanego klucza.

Ustaw FLASHDATA_API_KEY poniżej lub zachowaj wartość dostarczoną już przez środowisko. Przykład odczytuje go wyraźnie; pliki .env nie są wczytane.

#### Bash

##### Ukryty sygnał klawiszowy · 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

##### Ukryty sygnał klawiszowy · 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
```


- [Zarejestruj się](https://flashdata.dev/signup)
- [Utwórz klucz API](https://flashdata.dev/app/api-keys)
- [Sprawdź kredyty](https://flashdata.dev/app/billing)
- [Uwierzytelnianie agenta](https://flashdata.dev/auth.md)

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

### Wykonaj wyszukiwanie

Zapisz to jako main.go obok go.mod, a następnie uruchom go w tym samym terminalu. Wysyła jedno wyszukiwanie do pięciu wyników i drukuje odpowiedź 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)
    }
}
```

#### Uruchom

```bash
go run .
```


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

### Sprawdź wynik

Szukaj status: done w wydrukowanym JSON. Użyj zwróconych tytułów, URLs i snippetów w aplikacji lub agencie. Pusta lista organicznych jest również prawidłowym wynikiem.

| Pole | Znaczenie |
| --- | --- |
| status | to znaczy, że przeszukanie zakończone. |
| results[].organic[] | Wyniki wyszukiwania z polami tytułu, linka i snippetu. |
| usage.credits | Kredyty wykorzystane w niniejszym wniosku. Pięć wyników to jedno wyszukiwanie, a nie pięć wniosków. |

#### Przykład wyjścia

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

## Spróbuj innego źródła danych

W main.go zastąpić tylko wynik, err: = client.Google.Search (...) wywołanie jednym z tych wywołań. Zachowaj klienta, kontekst, sprawdzanie błędów i wyjście JSON, a następnie uruchom go uruchomić. Każda runda składa jedną nową prośbę.

### Google Aktualności

Wymaga zezwolenia google_news. Zwraca wyniki wiadomości dla Twojego zapytania.

#### Zastąp wywołanie wyszukiwania w main.go

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


### Metadane YouTube

Wymaga zezwolenia youtube_metadata. Zwraca szczegóły wideo, takie jak tytuł, kanał i czas trwania; nie pobiera wideo.

#### Zastąp wywołanie wyszukiwania w main.go

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


### Transkrypcja YouTube

Wymaga zezwolenia youtube_transcript. Prosi o istniejący angielski transkrypt, w tym automatyczne utwory. Zwraca znaczniki tekstowe i czasowe, gdy utwór jest dostępny.

#### Zastąp wywołanie wyszukiwania w main.go

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


- [Wszystkie parametry źródłowe](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Co obsługuje Go SDK

| Stosowanie | Punkty wejścia SDK |
| --- | --- |
| Google | Szukaj, Aktualności, Zdjęcia, Zakupy, Filmy i Miejsca. Użyj Google.Pages do uzyskania wyników z paginami. |
| YouTube | Wyszukiwanie, Metadane, Transcript, Podpisy, Kanał i Sugestie dostarczają uporządkowanych danych wideo. |
| YouTube.Download | Prześlij zadanie dostarczania dźwięku lub obrazu do pamięci masowej w chmurze. Wymaga uprawnień youtube_download i konfiguracji pamięci masowej; użyj pełnego przykładu poniżej. |
| Jobs / Bulk | Prześlij za pomocą helpera Async, zapisz zadanie ID, a następnie użyj Jobs.Wait i Jobs.Result. Bulk obsługuje większe zbiory danych i wznowione zadania. |
| Account | Czytać tożsamość, równowagę, ceny, ograniczenia i wykorzystanie przed pracą bez opieki. Użyj ponownie tego samego klienta i autoryzowanego klucza. |
| WithFormat | Poproś JSON, zwykły tekst lub Markdown z opcji wyraźnego formatu. Formaty Markdown pobrane dla Twojego agenta; aplikacja dostarcza modele połączeń lub podsumowań. |

- [Kompletny przykład pobierania Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Konfiguracja pamięci masowej pobierania](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)
- [Formaty odpowiedzi Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Typy Go

GoogleSearchInput opisuje zapytanie. Opcjonalne parametry wykorzystują wskaźniki, takie jak flashdata.Ptr (int64 (5)). Wyniki zawierają źródło JSON; użyj DecodeResults [GoogleSearchPayload], gdy potrzebujesz pola wpisowego.

- [Zapisywanie i dekodowanie wyników wpisanych](https://flashdata.dev/pl/docs/guides/sdk-operations/reference.md#save)

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

## Kolejne kroki

- [Kontrole rachunków i zapisane wyniki](https://flashdata.dev/pl/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/pl/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)
- [Metoda odniesienia dla SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Jeśli krok zawiedzie

| Problem | Napraw |
| --- | --- |
| Brak opakowania lub czasu startowego | Sprawdź go wersji i uruchom go dostać się do katalogu zawierającego go.mod. |
| 401 / FLASHDATA_API_KEY | Ustaw poprawny klucz w terminalu, w którym uruchomisz przykład. |
| 403 | Włącz Google Search dla tego klawisza API. |
| 402 | Sprawdź Billing dostępne kredyty, lub zażądać wyczerpanego procesu agenta. |
| 429 | Poczekaj na Retry-After, a następnie zmniejsz stawkę zapotrzebowania. |
| Błąd timeout lub serwera | Zaznacz History przed zwrotem; pierwsze żądanie może być już uruchomione. |

- [Poproś o historię](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
