Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

Schnellstart

Führen Sie Ihre erste Google-Suche aus und erhalten Sie strukturierte Ergebnisse für Ihre Anwendung oder Ihren KI-Agenten.

Starten Sie mit Ihrem KI-Agenten

Geben Sie diesen Prompt an einen Agenten mit Terminalzugriff. Er richtet FlashData ein und führt eine Suche aus.

Ersten API-Aufruf ausführen

Sie möchten den Code selbst schreiben? Folgen Sie diesen drei Schritten im Terminal.

  1. API-Schlüssel erstellen

    Erstellen Sie ein Konto, bestätigen Sie Ihre E-Mail-Adresse und erstellen Sie einen Schlüssel mit Google-Search-Berechtigung. Ein vorhandener Schlüssel kann wiederverwendet werden.

    Führen Sie den Befehl im Terminal aus und fügen Sie Ihren Schlüssel in die verdeckte Eingabe ein. Überspringen Sie diesen Schritt, wenn FLASHDATA_API_KEY bereits gesetzt ist.

    Schlüssel setzen
    # 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. Suche ausführen

    Wählen Sie Ihre Programmiersprache und führen Sie das Beispiel im selben Terminal aus. Jede Ausführung sendet eine Suche.

    Python 3.10+ · Speichern Sie das Beispiel als quickstart.py.

    Installieren
    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))
    Ausführen
    python quickstart.py
  3. Ergebnis prüfen

    Eine erfolgreiche Antwort enthält status: done. Die Quellen stehen in results[].organic, das verbrauchte Guthaben in usage.credits.

    Beispielantwort (gekürzt)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Konsole ausprobieren

  1. Erstellen Sie ein Konto oder melden Sie sich an. Bestätigen Sie Ihre E-Mail-Adresse und schließen Sie die in der Konsole angezeigten Einrichtungsschritte ab.
  2. Öffnen Sie Google Search, wählen Sie die Quelle Google Search und den Modus Realtime und geben Sie battery recycling research ein. Öffnen Sie Additional parameters und setzen Sie Page size (num) auf 5.
  3. Prüfen Sie die angezeigte Anfrage und Ihr verfügbares Guthaben. Führen Sie die Suche dann einmal aus.
  4. Prüfen Sie Antwort und Verbrauch. Öffnen Sie eine zurückgegebene Quelle, bevor Sie mehr als ihren Auszug zitieren.

Mit dem ersten Ergebnis weiterarbeiten

Wenn die erste Anfrage fehlschlägt

FLASHDATA_API_KEY fehlt
Setzen Sie den Schlüssel im selben Terminal oder in derselben Laufzeitumgebung wie das Beispiel. Diese Beispiele laden keine .env-Dateien.
401 / 403
Prüfen Sie, ob der Schlüssel oder die Verbindung aktiv ist und über die Berechtigung google_search verfügt.
402
Prüfen Sie Ihr verfügbares Guthaben unter Billing. Verknüpfen Sie einen vorhandenen Testzugang, wenn Kontoinhaberzugriff erforderlich ist.
429
Beachten Sie Retry-After. Behalten Sie dieselbe Identität und denselben Registrierungsnachweis bei; erstellen Sie keinen weiteren Testzugang.
Zeitüberschreitung oder unklarer Übermittlungsstatus
Prüfen Sie die vorhandene Ausführung vor einem erneuten Versuch. CLI-Nutzer behalten Profil und Ausführungs-ID bei; SDK/API-Nutzer bewahren jede zurückgegebene Job- oder Anfrage-ID auf.