# Go SDK швидкийстарт

Встановіть Go SDK і запустіть типований запит Google Search. Потім спробуйте дані YouTube з тим самим клієнтом.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/flashdata-go
Переглянуто: 2026-11-04 від FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Джерело та посилання SDK
- [Отримайте API-ключ](https://flashdata.dev/app/api-keys) — Створення ключа в консолі

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

## Зробіть свій перший запит Go

Встановіть SDK, встановіть ключ API і запустіть приклад нижче.

- [Довідник методів Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### Встановити SDK

Вимагає Go 1.25+. Виберіть новий проект або встановіть в каталозі, що містить наявний go.mod.

#### Новий проект

##### Встановити

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


#### Розробка модуля

##### Встановити

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


- [Встановити Go](https://go.dev/doc/install)
- [SDK реліз](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### Ауттентицид

Зареєструйтеся, перевірте свою електронну пошту та створюйте ключ API з дозволом Google Search або повторно використовуйте уповноважений ключ.

Налаштуйте FLASHDATA_API_KEY нижче, або зберігайте значення, яке вже подано вашим середовищем. Приклад зчитуває його явно; .env файли не завантажені.

#### Bash

##### Прихована ключова підказка · 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

##### Прихована ключова підказка · 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
```


- [Реєстрація](https://flashdata.dev/signup)
- [Створіть ключ API](https://flashdata.dev/app/api-keys)
- [Перевірити кредити](https://flashdata.dev/app/billing)
- [Ауттентифікації агента](https://flashdata.dev/auth.md)

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

### Виконайте пошук

Заощаджуйте це, як main.go beside go.mod, після чого запустіть його в одному терміналі. Відправляється один пошук до п'яти результатів і друкує відповідь 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)
    }
}
```

#### Запустити

```bash
go run .
```


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

### Перевірте результат

Шукайте status: done на друкованій JSON. Використовуйте повернуті назви, URLs та фрагменти у додатку або агенту. Порожній органічний список також є дієвим результатом.

| Поле | Зручності |
| --- | --- |
| status | зроблено спосіб пошуку завершено. |
| results[].organic[] | Результати пошуку за назвою, посилання та полями хіппе. |
| usage.credits | Кредити, які використовуються цим запитом. П'ять результатів є одним пошуком, не п'ять запитань. |

#### Приклад виходу

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

## Спробуйте ще одне джерело даних

У main.go замініть тільки результат, err := client.Google.Search(...) виклик з одним з цих дзвінків. Зберігати клієнта, контекст, перевірки помилок та виходу JSON, потім запустити роботу. знову. Кожен забіг подає один новий запит.

### Google Новини

Вимоги до дозволу google_news. Повернути результати новин для запиту.

#### Замініть зворотний дзвінок в main.go

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


### YouTube метаданих

Вимоги до дозволу youtube_metadata. Повертає відео деталі, такі як назва, канал і тривалість; він не завантажує відео.

#### Замініть зворотний дзвінок в main.go

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


### YouTube трафарет

Вимоги до дозволу youtube_transcript. Заяви наявного англійського трафарету, включаючи автоматичні треки. Повертає текст та часові засоби, коли цей трек доступний.

#### Замініть зворотний дзвінок в main.go

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


- [Всі параметри джерела](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Що підтримує Go SDK

| Зареєструватися | SDK вступні точки |
| --- | --- |
| Google | Пошук, Новини, Зображення, Купівля товарів, Відео та місця. Використовуйте Google.Pages для вагінальних результатів. |
| YouTube | Пошук, метадані, перезаписи, підписи, Канал і Суггести забезпечують структуровані відеодані. |
| YouTube.Download | Надайте аудіо або відео доставку на хмарне сховище. Задовольнить youtube_download дозвіл та конфігурацію зберігання; скористайтеся повним прикладом нижче. |
| Jobs / Bulk | Подати заявку Async помічник, зберегти роботу ID, потім використовуйте Jobs.Wait і Jobs.Result. Bulk ручає більші дані та багаторазові робочі місця. |
| Account | Читання ідентичності, балансу, ціни, лімітів та використання перед ненавченою роботою. Використовуйте той самий клієнт і авторизований ключ. |
| WithFormat | Запит JSON, звичайний текст або Markdown з можливістю чіткого формату. Markdown зберігає дані для вашого агента; ваш додаток постачає моделі дзвінків або підсумків. |

- [Повний приклад завантаження Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Налаштування зберігання завантаження](https://flashdata.dev/uk/docs/guides/youtube-download-guide/reference.md)
- [Формати відповіді Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Go типи

GoogleSearchInput описує запит. Додаткові параметри використання тостерів, такі як flashdata.Ptr(int64(5)). Результати пошуку JSON; використовувати DecodeResults[GoogleSearchPayload] при необхідності вводити поля.

- [Заощаджувати та видаляти результати](https://flashdata.dev/uk/docs/guides/sdk-operations/reference.md#save)

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

## Наступний крок

- [Перевірка облікових записів та збережені результати](https://flashdata.dev/uk/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/uk/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/uk/docs/guides/youtube-download-guide/reference.md)
- [SDK метод посилання](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Якщо крок не зникає

| Проблема | Фіксація |
| --- | --- |
| Пакети або дата відсутні | Перевірити версію і запустити перейти в каталог, що містить go.mod. |
| 401 / FLASHDATA_API_KEY | Встановіть ключ в терміналі, де ви запустіть приклад. |
| 403 | Увімкнути Google Search для цього ключа API. |
| 402 | Перевірте Billing для доступних кредитів, або вимагати вичерпне випробування агента. |
| 429 | Зачекайте Retry-After, потім знижуйте курс запиту. |
| Терміни або помилка сервера | Перевірити History перед перезапуском; перший запит вже може запуститися. |

- [Історія запиту](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
