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

Pierwsze kroki

Szybki start

Wykonaj pierwsze wyszukiwanie Google i uzyskaj uporządkowane wyniki dla aplikacji lub agenta AI.

Zacznij ze swoim agentem AI

Przekaż ten prompt agentowi z dostępem do terminala. Skonfiguruje FlashData i wykona jedno wyszukiwanie.

Wykonaj pierwsze wywołanie API

Wolisz napisać kod samodzielnie? Wykonaj te trzy kroki w terminalu.

  1. Uzyskaj klucz API

    Utwórz konto, potwierdź e-mail i utwórz klucz z uprawnieniem Google Search. Jeśli masz już taki klucz, użyj go ponownie.

    Uruchom polecenie w terminalu i wklej klucz w ukrytym polu wejściowym. Pomiń ten krok, jeśli FLASHDATA_API_KEY jest już ustawione.

    Ustaw klucz
    # 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
  2. Wykonaj wyszukiwanie

    Wybierz język i uruchom przykład w tym samym terminalu. Każde uruchomienie wysyła jedno wyszukiwanie.

    Python 3.10+ · Zapisz przykład jako quickstart.py.

    Zainstaluj
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    Uruchom
    python quickstart.py
  3. Sprawdź wynik

    Poprawna odpowiedź ma status: done. Źródła są w results[].organic, a naliczone kredyty w usage.credits.

    Przykładowa odpowiedź (skrócona)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Wypróbuj konsolę

  1. Utwórz konto lub się zaloguj. Potwierdź e-mail i wykonaj kroki konfiguracji konta widoczne w konsoli.
  2. Otwórz Google Search, wybierz źródło Google Search i tryb Realtime, a następnie wpisz battery recycling research. Rozwiń Additional parameters i ustaw Page size (num) na 5.
  3. Sprawdź widoczne żądanie i dostępne kredyty, a następnie wykonaj wyszukiwanie raz.
  4. Sprawdź odpowiedź i zużycie. Otwórz zwrócone źródło i sprawdź jego treść, zanim zacytujesz więcej niż fragment.

Rozwiń pierwszy rezultat

Gdy pierwsze żądanie się nie powiedzie

Brak FLASHDATA_API_KEY
Ustaw klucz w tym samym terminalu lub środowisku, w którym uruchamiasz przykład. Te fragmenty nie wczytują plików .env.
401 / 403
Sprawdź, czy klucz lub połączenie jest aktywne i ma uprawnienie google_search.
402
Sprawdź dostępne kredyty w Billing. Powiąż istniejący dostęp próbny z kontem, jeśli potrzebujesz dostępu właściciela.
429
Przestrzegaj Retry-After. Zachowaj tę samą tożsamość i dowód rejestracji; nie twórz kolejnego dostępu próbnego.
Przekroczenie czasu lub nieznany stan wysłania
Przed ponowieniem sprawdź istniejące uruchomienie. Użytkownicy CLI powinni zachować ten sam profil i identyfikator uruchomienia; użytkownicy SDK/API — zwrócony identyfikator zadania lub żądania.