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