# เริ่มต้นใช้ Python SDK

ติดตั้ง Python SDK และพิมพ์ผลการค้นหาด้วยรหัสไม่กี่บรรทัด รวม เอา ตัว อย่าง ที่ ประสาน ลง รอย กัน และ สัมฤ ทธิ ผล.

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/flashdata-python
Recorder: 2026-11-04 โดย FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — ต้นฉบับและ SDK อ้างอิง
- [รับคีย์ API](https://flashdata.dev/app/api-keys) — สร้างกุญแจในคอนโซล

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

## ให้เป็นครั้งแรกของคุณ Python ร้องขอ

ติดตั้ง SDK. ตั้ง API กุญแจและทําการค้นหาหนึ่ง. การตอบรับคือ 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+. ประมวลผลคําสั่งเหล่านี้ในไดเรกทอรีโครงการของคุณ ใช้สภาพแวดล้อมเสมือนแล้วหรือไม่? ติดตั้งแฟลชดาต้า==1.1.0 กับสภาพแวดล้อมที่ python -m pip แทน

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

### การตรวจสอบสิทธิ์

สร้างรายการ API กุญแจพร้อม Google Search อนุญาตหรือใช้กุญแจที่ได้รับอนุญาตอีกครั้ง ตั้งมันไว้ในเทอร์มินัลนี้ โดยใช้ตัวเรียกซ่อนด้านล่างนี้

ข้ามการแจ้งเตือนถ้า FLASHDATA_API_KEY ได้ตั้งค่าแล้ว ตัวอย่างเหล่านี้อ่านตัวแปรโดยตรง; มันไม่โหลดแฟ้ม .env

#### Bash

##### แจ้งเตือนปุ่มซ่อน as 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

##### แจ้งเตือนปุ่มซ่อน as 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/th/docs/guides/agent-onboarding/reference.md)

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

### เรียกใช้การค้นหา

บันทึกนี้ให้เป็น quickstart.py แล้วเรียกใช้งานมันด้วยสภาพแวดล้อมเสมือนเดียวกัน มันสร้างได้ Google Search ร้องขอผล 5 อย่าง และชื่อพิมพ์ URLs และใช้เครดิต

#### 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 ด้วยตัวอย่างหนึ่งและเรียกใช้ด้วยคําสั่งจากขั้นตอน 3. แต่ละการทํางานจะส่งการร้องขอใหม่หนึ่งตัว; กุญแจต้องการสิทธิ์ในการแสดงแหล่งข้อมูล

### 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, News, image, Stople, Videos and Pages; 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/th/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>

## ใช้ Asynio

แทนที่ quickstart.py ด้วยเวอร์ชันนี้ และใช้คําสั่งประมวลผลเดียวกัน Async Fashdate Data เปิดเผยทรัพยากรเดียวกัน ด้วยความรอคอย นี้ยังคงรอการตอบรับตามเวลาจริง; mode="async" ส่งงานเบื้องหลังของแม่ข่ายแทน

ใน Jupyter หรือโปรแกรมที่มีวนรอบเหตุการณ์ ทํางาน ให้ใช้รอฟังก์ชันหลักแทน asyncio.run(Mayal ()) ใช้โปรแกรมลูกข่ายภายในวงจรเหตุการณ์นั้นอีกครั้ง

### 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/th/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 - อืม pip แสดงแฟลชดาต้า (hadata)Windows: .\.venv\Scripts\python.exe - อืม pip แสดงแฟลชดาต้า). ไม่ต้องตั้งชื่อสคริปต์ของคุณ flashdata.py |
| KeyError: FLASHDATA_API_KEY / 401 | ตั้งค่าที่ใช้งานอยู่ API กุญแจในอาคารเดียวกัน แฟ้ม .env เท่านั้นที่ไม่ได้โหลดโดยตัวอย่างนี้ ใช้ API กุญแจ ไม่ใช่ MCP OAuth เซ็นต์นี่ |
| 403 | อนุมัติแหล่งกําเนิดที่ต้องการโดยตัวอย่างกุญแจนี้ |
| 402 | ตรวจสอบ Billing สําหรับเครดิตที่มีอยู่ หาก เข้าถึง การทดลอง หมด สิ้น จง อ้าง ว่า การ เชื่อม โยง นั้น เกี่ยว ข้อง กับ การ ใช้ ความ สมดุล ของ บัญชี. |
| 429 / APIError | Inspect error.retry_after และลดอัตราการร้องขอ SDK ส่งการร้องขอแต่ละครั้งและไม่มีการลองใหม่โดยอัตโนมัติ |
| SubmissionUnknownError | การส่งเวลานอก อาจเป็นที่ยอมรับแล้ว ตรวจสอบ History ก่อนที่จะทําซ้ํา; ทํางานที่บันทึกไว้อีกครั้ง ID เมื่อมีให้ใช้ |
| asyncio.run() / running event loop | ใช้การรอข้อความหลักในบันทึก หรือวนรอบเหตุการณ์ที่มีอยู่ เก็บไว้ asyncio.run(ข้อความหลัก) สําหรับสคริปต์แบบยืนยง |

- [ต้องการประวัติ](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)
