Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

Go SDK szybki start

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

  1. Zainstaluj SDK

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

    Zainstaluj
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. 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.

    Ukryty sygnał klawiszowy · 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. 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
    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
    go run .
  4. 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.

    Przykład wyjścia
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    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.

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ę.

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

Zastąp wywołanie wyszukiwania w main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Co obsługuje Go 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ń.

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.

Kolejne kroki

Jeśli krok zawiedzie

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.