Перейти к содержимому
RU
Ключ API
Обзор документации

Начало работы

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

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

  1. Установите SDK

    Требуется Go 1.25+. Выберите новый проект или установите в каталог, содержащий существующий go.mod.

    Установить
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. аутентифицировать

    Зарегистрируйтесь, проверьте свою электронную почту и создайте ключ API с разрешения Google Search или повторно используйте авторизованный ключ.

    Установите FLASHDATA_API_KEY ниже или сохраните значение, уже предоставленное вашей средой. В примере он читается явно; файлы .env не загружаются.

    Скрытая подсказка ключа · 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
  3. Выполните поиск

    Сохраните это как main.go рядом с go.mod, а затем запустите его в том же терминале. Он отправляет один поиск до пяти результатов и печатает ответ JSON.

    main.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)
        }
    }
    Запустить
    go run .
  4. Проверьте результат

    Ищите status: done в распечатанном JSON. Используйте возвращенные заголовки, URLs и фрагменты в вашем приложении или агенте. Пустой органический список также является действительным результатом.

    Примерный выход
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    Выполненный означает завершенный поиск.
    results[].organic[]
    Результаты поиска с заголовками, ссылками и сниппетами.
    usage.credits
    Кредиты, использованные по данному запросу. Пять результатов — это один поиск, а не пять запросов.

Попробуйте другой источник данных

В main.go заменить только результат, err := client.Google.Search(...) вызов с одним из этих вызовов. Сохраняйте клиент, контекст, проверку ошибок и выход JSON, а затем снова запускайте и запускайте. Каждый из них подает новый запрос.

Требуется разрешение google_news. Возвращает результаты новостей для вашего запроса.

Заменить поисковый вызов в main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Что поддерживает Go SDK

Google
Поиск, новости, изображения, покупки, видео и места. Используйте Google.Pages для получения результатов.
YouTube
Поиск, метаданные, транскрипт, подписи, канал и предложения предоставляют структурированные видеоданные.
YouTube.Download
Отправьте работу по доставке аудио или видео в ваше облачное хранилище. Требуется разрешение youtube_download и конфигурация хранилища; используйте полный пример ниже.
Jobs / Bulk
Отправьте с помощью Async помощник, сохранить работу ID, затем использовать Jobs.Wait и Jobs.Result. Bulk обрабатывает большие наборы данных и рабочие места.
Account
Прочтите информацию об идентичности, балансе, ценах, ограничениях и использовании до начала работы без присмотра. Повторное использование одного и того же клиентского и авторизованного ключа.
WithFormat
Запросить JSON, простой текст или Markdown с явными вариантами формата. Форматы Markdown извлекают данные для вашего агента; ваше приложение предоставляет вызовы или резюме модели.

Типы Go

GoogleSearchInput описывает запрос. Дополнительные параметры используют указатели, такие как flashdata.Ptr(int64(5)). Результаты содержат источник JSON; используйте DecodeResults [GoogleSearchPayload], когда вам нужны набранные поля.

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

Если шаг не удался

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