コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

はじめに

クイックスタート

最初の Google 検索を実行し、アプリや AI エージェント用の構造化された結果を取得します。

AI エージェントで始める

ターミナルにアクセスできるエージェントにこのプロンプトを渡してください。FlashData を設定し、検索を 1 回実行します。

最初の API 呼び出し

自分でコードを書きたい場合は、ターミナルで次の 3 ステップを実行してください。

  1. API キーを取得する

    アカウントを作成してメールアドレスを確認し、Google Search 権限のあるキーを作成します。既存のキーがあれば再利用できます。

    ターミナルで実行し、入力内容が表示されないプロンプトにキーを貼り付けます。FLASHDATA_API_KEY が設定済みなら、この手順は不要です。

    キーを設定
    # 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. 検索を実行

    言語を選び、同じターミナルでサンプルを実行します。実行するたびに検索が 1 回送信されます。

    Python 3.10+ · サンプルを quickstart.py として保存します。

    インストール
    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))
    実行
    python quickstart.py
  3. 結果を確認

    成功したレスポンスには status: done が含まれます。ソースは results[].organic、消費クレジットは usage.credits で確認できます。

    レスポンスの例(抜粋)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

コンソールで試す

  1. アカウントを作成するかログインし、メールアドレスの確認とコンソールに表示される設定を完了します。
  2. Google Search を開き、ソースに Google Search、モードに Realtime を選び、battery recycling research を入力します。Additional parameters を開き、Page size (num) を 5 に設定します。
  3. 表示されたリクエストと残高を確認し、検索を 1 回実行します。
  4. レスポンスと使用量を確認します。抜粋より詳しい内容を引用する前に、返されたソースを開いて内容を確認してください。

最初の結果から先へ進む

最初のリクエストが失敗した場合

FLASHDATA_API_KEY がない
サンプルと同じターミナルまたは実行環境でキーを設定します。これらのコード例は .env ファイルを読み込みません。
401 / 403
キーまたは接続が有効で、google_search 権限があることを確認します。
402
Billing で利用可能なクレジットを確認します。所有者としてのアクセスが必要なら、既存の試用をアカウントに連携してください。
429
Retry-After に従ってください。同じ ID と登録証明を保持し、別の試用を作成しないでください。
タイムアウトまたは送信結果が不明
再試行する前に既存の実行を確認します。CLI では同じプロファイルと実行 ID を使い、SDK/API では返されたジョブ ID やリクエスト ID を保持してください。