# Go SDK быстрый старт

Установите Go SDK и запустите типизированный запрос Google Search. Затем попробуйте YouTube с тем же клиентом.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/flashdata-go
Разработчик: 2026-11-04 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Источник: SDK reference
- [Получите 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 рядом с 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/ru/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/ru/docs/guides/sdk-operations/reference.md#save)

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

## Следующие шаги

- [Проверка аккаунта и сохраненные результаты](https://flashdata.dev/ru/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/ru/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/ru/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 и запустите Go, чтобы получить в каталоге, содержащем 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)
