# Python SDKクイックスタート

Python SDKをインストールし、いくつかの行のコードで検索結果を印刷します。 同期と非同期の例が含まれています。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/flashdata-python
レビュー: FlashData による 2026-11-04

- [GitHub](https://github.com/flashdatadev/flashdata-python) — ソースと SDK リファレンス
- [API キーを取得する](https://flashdata.dev/app/api-keys) — コンソールでキーを作成する

<a id="application"></a>

## Python リクエストを初めて作成

SDKをインストールし、APIキーを設定し、1つの検索を実行します。 応答はデフォルトでPython辞書です。

- [Python SDKの参照](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)
- [PyPI](https://pypi.org/project/flashdata/1.1.0/)

<a id="install"></a>

### SDKをインストール

Python 3.10+を要求して下さい。 プロジェクトディレクトリでこれらのコマンドを実行します。 仮想環境で既に利用されているの? その環境の python -m pip で flashdata===1.1.0 をインストールします。

#### Linux / macOS

##### インストール

```bash
python3 -m venv .venv
.venv/bin/python -m pip install "flashdata==1.1.0"
```


#### Windows PowerShell

##### インストール

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"
```


- [Pythonをインストールする](https://www.python.org/downloads/)

<a id="key"></a>

### 認証

Google Search 権限で API キーを作成、または承認されたキーを再使用して下さい。 以下に隠れたプロンプトを使用して、このターミナルで設定します。

FLASHDATA_API_KEYが既に設定されている場合は、プロンプトをスキップします。 これらの例は、変数を直接読み込みます。 .env ファイルが読み込まれません。

#### Bash

##### 隠しキープロンプト・Bash

```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
```


#### PowerShell 7

##### 隠しキープロンプト・PowerShell

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [新規登録](https://flashdata.dev/signup)
- [API Keys を開く](https://flashdata.dev/app/api-keys)
- [Billing を開いた](https://flashdata.dev/app/billing)
- [エージェントの試用セットアップ](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### 検索を実行

これをquickstart.pyとして保存し、同じ仮想環境で実行します。 Google Search は、URLs とクレジットの5つの結果とプリントのタイトルを最大 5つの結果のリクエストに1つ作成します。

#### quickstart.py

```python
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)
    for page in response["results"]:
        for hit in page.get("organic", []):
            print(hit["title"], hit["link"])
    print("Credits used:", response["usage"]["credits"])
```

#### Linux / macOS

##### 実行

```bash
.venv/bin/python quickstart.py
```


#### Windows PowerShell

##### 実行

```powershell
.\.venv\Scripts\python.exe quickstart.py
```



<a id="result"></a>

### 結果を確認

ステータスの確認後、スクリプトが正常に終了します。 ソースのタイトルとURLsを期待して、使用したクレジットが続きます。 空のオーガニックリストは有効な応答です。結果はクエリによって異なります。

| フィールド | 利用条件 |
| --- | --- |
| results[].organic[] | Google Search がヒット: タイトル, リンクとスニペット. 他のソースには異なる結果フィールドがあります。 |
| usage.credits | このリクエストのコスト。 結果は最大5件までを一括検索できます。 |

#### 出力例

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## 別のデータソースを試す

各タブは完全なスクリプトです。 リプレース quickstart.py 1つの例で、ステップからコマンドで実行します。 3. 各実行は、新しいリクエストを1つ提出します。キーは、ソースの権限が示されている必要があります。

### Googleニュース

google_newsが必要です。 results[].news[]から記事のタイトルとソースリンクを印刷します。

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))
```


### YouTubeメタデータ

youtube_metadataが必要です。 秒単位でビデオタイトル、チャンネル、期間を印刷します。 検査したいビデオIDを置き換えます。

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
    if response["status"] != "done":
        raise RuntimeError(response)
    for video in response["results"]:
        print(video.get("title"), video.get("channel"))
        print("Seconds:", video.get("duration"))
```


### YouTubeトランスクリプト

youtube_transcriptが必要です。 results[].fullText.から既存の英語自動成績表を印刷する このビデオには、その追跡が必要です。この呼び出しはキャプションを生成したり、変換したりしません。

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
    if response["status"] != "done":
        raise RuntimeError(response)
    for track in response["results"]:
        print(track.get("fullText", ""))
```


- [すべてのソースメソッドとパラメーター](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

<a id="features"></a>

## Python SDKサポートとは

| 利用条件 | SDKエントリーポイント |
| --- | --- |
| google / youtube | Google Search、ニュース、画像、ショッピング、ビデオ、場所。 YouTubeの発見、メタデータ、キャプション、トランスクリプト、チャネルデータ。 |
| youtube.download | クラウドストレージにオーディオまたはビデオ配信ジョブを送信します。 youtube_downloadの許可と保存設定が必要です。以下の完全なダウンロード例に従ってください。 |
| jobs / bulk | ID のジョブを保存し、完了を待ち、結果を取り出します。 より大きなビデオ-IDデータセットに一括して、再起動後に既存のジョブを再開します。 |
| account | 作業を繰り返しる前にアクセス、残高、価格設定、制限、使用量をお読みください。 環境や秘密ストアから認証されたキーを再利用します。 |
| respond_with / accept | 利用条件 respond_with="markdown" のための Markdown 応答で["content"], または 受け入れ ="text/plain" 文字列の場合。 JSON辞書はデフォルトです。 |

- [完全なPythonのダウンロードの例](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [ダウンロードストレージの設定](https://flashdata.dev/ja/docs/guides/youtube-download-guide/reference.md)
- [Python応答フォーマット](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

<a id="asyncio"></a>

## asyncio を使う

このバージョンでquickstart.pyを置換し、同じ実行コマンドを使用します。 AsyncFlashData は、同じリソースを待っています。 リアルタイム検索応答を待ちます。mode="async"はサーバー側のバックグラウンドジョブを代わりに送信します。

Jupyter または実行中のイベントループを持つアプリケーションでは、asyncio.run(main() の代わりに main() を待っています。 そのイベントループ内でクライアントを再利用します。

### quickstart.py

```python
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())
```

- [Asyncクライアント設定](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

<a id="next"></a>

## 次のステップ

- [口座のチェックと保存結果](https://flashdata.dev/ja/docs/guides/sdk-operations/reference.md)
- [背景ジョブとバッチ](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk データセット](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDKメソッド参照](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## ステップが失敗した場合

| 問題の問題 | フィックス |
| --- | --- |
| ModuleNotFoundError | .venv/bin/python -m pip show flashdata (Windows: .\.venv\Scripts\python.exe -m pip show flashdata) をインストールして実行します。 スクリプトのflashdata.pyを名前付けないでください。 |
| KeyError: FLASHDATA_API_KEY / 401 | 同じターミナルでアクティブな API キーを設定します。 .env ファイルだけでは、この例では読み込まれません。 APIキーではなく、MCP OAuthトークンを使用します。 |
| 403 | このキーに例を要するソースの許可を付与します。 |
| 402 | 利用可能なクレジットについては、Billingをチェックしてください。 トライアルアクセスが疲れている場合は、アカウント残高を使用する接続を要求します。 |
| 429 / APIError | error.retry_afterを点検し、要求率を減らして下さい。 SDKは、一度に各リクエストを送信し、自動的に再試行しません。 |
| SubmissionUnknownError | 期限切れの投稿は既に受付けます。 Historyを繰り返す前にチェックします。 保存されたジョブを再利用します。 ID 利用可能な場合。 |
| asyncio.run() / running event loop | ノートブックや既存のイベントループで main() を待ってください。 asyncio.run(main()) をスタンドアローンスクリプトに保ちます。 |

- [リクエスト履歴](https://flashdata.dev/app/jobs)
- [Billingの特長](https://flashdata.dev/app/billing)
- [Pythonのエラーと回復](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
